{"id":15057819,"url":"https://github.com/w3c/echidna","last_synced_at":"2025-07-24T14:14:14.116Z","repository":{"id":22881525,"uuid":"26229585","full_name":"w3c/echidna","owner":"w3c","description":"New publication workflow at W3C — main component","archived":false,"fork":false,"pushed_at":"2025-07-21T10:58:51.000Z","size":4747,"stargazers_count":39,"open_issues_count":50,"forks_count":35,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-07-21T12:34:03.142Z","etag":null,"topics":["checker","publication","spec","specification","standard","validator","w3c"],"latest_commit_sha":null,"homepage":"https://labs.w3.org/echidna/","language":"HTML","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/w3c.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2014-11-05T16:53:27.000Z","updated_at":"2025-07-21T10:58:48.000Z","dependencies_parsed_at":"2023-09-27T17:38:59.580Z","dependency_job_id":"85984695-06b0-435c-95a5-0fb28b531e9a","html_url":"https://github.com/w3c/echidna","commit_stats":{"total_commits":1559,"total_committers":17,"mean_commits":91.70588235294117,"dds":0.7530468248877485,"last_synced_commit":"d3dfa8f2d747acd841ca5fde6ec77245a8f8bbf9"},"previous_names":[],"tags_count":155,"template":false,"template_full_name":null,"purl":"pkg:github/w3c/echidna","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3c%2Fechidna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3c%2Fechidna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3c%2Fechidna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3c%2Fechidna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/w3c","download_url":"https://codeload.github.com/w3c/echidna/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3c%2Fechidna/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266854681,"owners_count":23995488,"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","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["checker","publication","spec","specification","standard","validator","w3c"],"created_at":"2024-09-24T22:12:23.416Z","updated_at":"2025-07-24T14:14:14.074Z","avatar_url":"https://github.com/w3c.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/w3c/echidna/workflows/Echidna%20tests/badge.svg)](https://github.com/w3c/echidna/actions)\n\n# Echidna\n\nEchidna is the central piece of software taking care of the new publication workflow at [W3C](http://www.w3.org/). The plan is for Echidna and related sub-projects (see below) to automate the publication of new specs under \u003chttp://www.w3.org/TR/\u003e.\n\n## Using Echidna as a spec editor\n\n**If you are a spec editor, you do not need to install Echidna, nor to run it locally.**\n\nPlease [see the wiki](https://github.com/w3c/echidna/wiki) for how to use Echidna as a spec editor.\n\n## Hacking Echidna as a developer\n\n### Installation\n\nTo run Echidna, you need to install [Node.js](https://nodejs.org/en/) first.\nThis will install [npm](https://www.npmjs.com/) at the same time, which is required as well.\n\nThen run the following commands with your favorite terminal:\n\n```bash\ngit clone https://github.com/w3c/echidna.git\ncd echidna\ncp config.js.example config.js\nnpm install\n```\n\n### Running it locally\n\n*Note: local setup of the full system is not supported currently due to dependency on W3C's DB and IPP system, but having mock services that emulate these pieces is our short-term goal.*\n\nIn your terminal, run the following:\n\n```bash\nnpm start [-- STAGING_PATH [HTTP_LOCATION [PORT [RESULT_PATH]]]]\n```\n\nYou may use the optional defined below:\n\n1. `STAGING_PATH`: path in the local filesystem where documents will be downloaded; *staged*.\n(Default `/var/www/html/trstaging/`.)\n2. `HTTP_LOCATION`: HTTP endpoint for [Specberus](https://github.com/w3c/specberus).\n(Default `http://localhost/trstaging/`.)\n3. `PORT`: where Echidna will be listening for publication requests.\n(Default `3000`.)\n4. `RESULT_PATH`: local path where Echidna will dump the results of publication requests in JSON format.\n\nAlternatively, you can use the configuration file `config.js`.\n\nOnce the server is started, you can throw publication requests at it through a `curl`/`POST` request to its endpoint, \u003chttp://localhost:3000/api\u003e, or using the web-based testbed (described below).\n\nYou can also use a simple web client to send and monitor those requests, at \u003chttp://localhost:3000/ui\u003e.\n\nFor more information, please refer to [DEVELOPMENT.md](./DEVELOPMENT.md).\n\n### Testing Echidna\n\nThis section describes how to run Echidna's test suite to make sure that the project itself is working properly over time. Note that the test suite is not intended to test actual documents.\n\n#### Running the unit test suite\n\nYou can run the test suite with the following command line:\n\n```bash\nnpm test\n```\n\n#### Using test documents\n\nFor testing purposes, we are using a local web server.\nThe test server simulates some of the W3C services, such as the CSS and HTML validators, or the token authorization checker.\nIt also serves a set of sample drafts.\n\nYou can launch this test server separately by using:\n\n```bash\nnpm run testserver\n```\n\nWhen the test server is running, the testbed with all drafts will be available in \u003chttp://localhost:3001\u003e.\n\n## Feedback and contributions\n\nPlease refer to our [contribution reference](https://github.com/w3c/echidna/blob/master/CONTRIBUTING.md) to learn how to contact us, give feedback, or actively contribute to this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fw3c%2Fechidna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fw3c%2Fechidna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fw3c%2Fechidna/lists"}