{"id":18906761,"url":"https://github.com/oduwsdl/web-memento-damage","last_synced_at":"2026-03-02T12:40:30.041Z","repository":{"id":149656518,"uuid":"60317807","full_name":"oduwsdl/web-memento-damage","owner":"oduwsdl","description":"Web service to estimate the damage that exists on a memento","archived":false,"fork":false,"pushed_at":"2025-03-01T00:06:11.000Z","size":98057,"stargazers_count":6,"open_issues_count":9,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T16:21:28.306Z","etag":null,"topics":["docker","memento","memento-damage","memento-rfc"],"latest_commit_sha":null,"homepage":"http://memento-damage.cs.odu.edu/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oduwsdl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-03T04:15:19.000Z","updated_at":"2024-04-26T15:58:23.000Z","dependencies_parsed_at":"2024-03-10T08:21:23.040Z","dependency_job_id":"48833208-04c1-4d78-bd5a-e7a3d9aa76a6","html_url":"https://github.com/oduwsdl/web-memento-damage","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oduwsdl%2Fweb-memento-damage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oduwsdl%2Fweb-memento-damage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oduwsdl%2Fweb-memento-damage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oduwsdl%2Fweb-memento-damage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oduwsdl","download_url":"https://codeload.github.com/oduwsdl/web-memento-damage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249006463,"owners_count":21197280,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","memento","memento-damage","memento-rfc"],"created_at":"2024-11-08T09:18:39.521Z","updated_at":"2026-03-02T12:40:24.986Z","avatar_url":"https://github.com/oduwsdl.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[comment]: https://docs.google.com/presentation/d/1sh8-9zQhLXGqSJWvE5QCK3ysCcCaGAim8pCoa4T-62I/edit?usp=sharing\n\n# Memento Damage\n\nMemento Damage is a tool that helps to estimate the damage that happens on a memento. Although the main idea is to calculate damage on memento (URI-M), this tool can also be used for calculating damage on a live web page (URI-R).  \u003c/br\u003e\nThere are 2 ways to use this tool:\n- [Online service](#online-service)\n  - [Website](#website)\n  - [REST API](#rest-api)\n- [Local service](#local-service)\n  - [Docker](#docker)\n  - [Library](#library)\n\n## Online Service\n### Website\nThe website version can be used by accesing http://memento-damage.cs.odu.edu/. This service is suitable for the purpose of finding the damage of single URI. To use the tool, user just simply type or paste the URI to the damage-check textbox form, and type enter or click check button.\n\n![](https://github.com/oduwsdl/web-memento-damage/raw/screenshot/pasted%20image%200.png)\n\nThe output will be displayed on the result page, on tab ‘summary’. Other tabs in the result page provide the details of the damage according to the resources types: images, stylesheets, javascript, multimedia, and text. Tab ‘screenshot’ provide the screenshot of the URI and tab ‘log’ gives the details of the process that happens during the damage calculation.\n\n![](https://github.com/oduwsdl/web-memento-damage/raw/screenshot/online-2.png)\n\n### REST API\nREST API facilitates damage calculation from any HTTP Client (e.g. web browser, curl, etc) and give output in JSON format. This enables user to do further analysis with the output. User can create a script and utilize the REST API to calculate damage on few number of URIs (e.g. 5). Here are some simple examples of accessing memento-damage service using REST API:\n\n\n#### CURL\n```\ncurl http://memento-damage.cs.odu.edu/api/damage/http://odu.edu/compsci\n```\n\n#### Python\n```\nimport requests\nresp = requests.get('http://memento-damage.cs.odu.edu/api/damage/http://odu.edu/compsci')\nprint resp.json()\n```\n\n## Local Service\nThis option is suitable for calculating the damage on a myriad number of URIs (e.g. 10.000 URIs).  The web service http://memento-damage.cs.odu.edu/ clearly cannot handle this. Therefore, we provide an option so that users can install and run the Memento Damage tool on their own machine.\n\nThere are 2 (two) ways to use Memento Damage tool in local machine: using Docker or library. Using docker is recommended since user does not need to worry about system dependencies.\n\n### Docker\nFirst, install docker in your machine, and make sure docker daemon is started. Please refer to this steps on how to install docker: https://docs.docker.com/engine/getstarted/step_one/#step-2-install-docker. \n\nPull the docker image of memento-damage from: oduwsdl/memento-damage:\n```\ndocker pull oduwsdl/memento-damage\n```\n\nRun the container for the image:\n```\ndocker run -i -t -P --name memento-damage oduwsdl/memento-damage:latest /app/entrypoint.sh\n\n```\nThen, user can start executing memento-damage tool from within docker container or outside docker container.\n\n#### Inside Container\nAttach the container:\n```\ndocker attach memento-damage\n```\nAlternatively, use exec:\n```\ndocker exec -it memento-damage bash\n```\n\nThen, start using memento-damage by typing the command:\n```\nmemento-damage [options] \u003cURI\u003e\n```\n\nExplore available options by typing:\n```\nmemento-damage --help\n```\n\n#### Outside Container\nWe can also executing memento-damage without entering container using:\n```\ndocker exec memento-damage memento-damage [options] \u003cURI\u003e\n```\n\n### Library\nUsing library is relatively similar to using docker. The installation process is much simpler and faster than the docker version. But user has to ensure that all the requirements (phantomjs 2.xx and python 2.7) are installed on their machines.  \u003cbr /\u003e\nDownload the latest library version from https://github.com/oduwsdl/web-memento-damage/tree/master/dist. \u003cbr /\u003e\nInstall the library using command:  \n```\nsudo pip install memento-damage-x.x.x.tar.gz\n```\nStart using the tool by typing the command ‘memento-damage’, which is similar to that of the docker version. \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foduwsdl%2Fweb-memento-damage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foduwsdl%2Fweb-memento-damage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foduwsdl%2Fweb-memento-damage/lists"}