{"id":28095918,"url":"https://github.com/sparksuite/rugged","last_synced_at":"2025-05-13T16:17:05.466Z","repository":{"id":39004608,"uuid":"342696891","full_name":"sparksuite/rugged","owner":"sparksuite","description":"Orchestrate package testing across uneven terrain","archived":false,"fork":false,"pushed_at":"2025-04-29T20:51:56.000Z","size":3677,"stargazers_count":6,"open_issues_count":7,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-29T21:36:58.441Z","etag":null,"topics":["orchestration","test-automation","test-runner","testing","testing-tools"],"latest_commit_sha":null,"homepage":"https://ruggedjs.io","language":"TypeScript","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/sparksuite.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":"2021-02-26T20:46:10.000Z","updated_at":"2025-04-29T20:50:17.000Z","dependencies_parsed_at":"2023-02-10T10:01:28.423Z","dependency_job_id":"ebf61e0c-227a-45f9-a710-ea8f1d1f4f14","html_url":"https://github.com/sparksuite/rugged","commit_stats":{"total_commits":270,"total_committers":6,"mean_commits":45.0,"dds":0.5851851851851853,"last_synced_commit":"06c20a7d5e081db6656c99ba46cbeb642d274b22"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparksuite%2Frugged","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparksuite%2Frugged/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparksuite%2Frugged/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparksuite%2Frugged/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sparksuite","download_url":"https://codeload.github.com/sparksuite/rugged/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253980095,"owners_count":21994044,"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":["orchestration","test-automation","test-runner","testing","testing-tools"],"created_at":"2025-05-13T16:17:03.567Z","updated_at":"2025-05-13T16:17:05.454Z","avatar_url":"https://github.com/sparksuite.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cdiv align=\"center\"\u003eRugged\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://www.npmjs.com/package/rugged\"\u003e\u003cimg alt=\"npm bundle size\" src=\"https://img.shields.io/bundlephobia/min/rugged\"\u003e\u003c/a\u003e\n\u003ca href=\"https://app.codecov.io/gh/sparksuite/rugged/branch/master\"\u003e\u003cimg alt=\"Codecov coverage\" src=\"https://img.shields.io/codecov/c/github/sparksuite/rugged\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/rugged\"\u003e\u003cimg alt=\"npm downloads\" src=\"https://img.shields.io/npm/dw/rugged\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/rugged\"\u003e\u003cimg alt=\"npm release\" src=\"https://img.shields.io/npm/v/rugged\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/sparksuite/rugged\"\u003e\u003cimg alt=\"tested with Rugged\" src=\"https://img.shields.io/badge/tested%20with-Rugged-green\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/sparksuite/rugged/blob/master/LICENSE\"\u003e\u003cimg alt=\"license\" src=\"https://img.shields.io/npm/l/rugged\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nRugged orchestrates testing JavaScript packages across the variety of real-world environments and contexts where they’ll actually be used, with the files that will actually be published.\n\n- ⚡️ Performant design\n- 🔧 Configurable\n- 📦 Written entirely in TypeScript\n- 🌎 Works in CLI and CI environments\n- 🔬 Thoroughly tested\n- ✨ Tiny size\n- 📖 Well documented\n\n![Screen recording](https://user-images.githubusercontent.com/3850064/110968462-2bf99800-831d-11eb-98f8-b3ded33a08a8.gif)\n\n## The problem\n\nToday, people can consume your package in many contexts—in Node.js, in a browser, in an ECMAScript module, in a Common JS module, within a library (e.g., React, Angular, etc.), with assistance from compilers/transpilers/bundlers (e.g., TypeScript, Babel, Webpack, etc.), even inside test runners (e.g., Jest, Mocha, etc.). Each of these contexts has a unique set of capabilities, limitations, requirements, global variables, etc. that could impact or even break your package’s behavior.\n\nFurther, testing often only occurs against the source files that are available in the repository, which is problematic in two ways… First, tools may manipulate the source code in such a way that the compiled/transpiled/bundled version behaves slightly differently than the source code. Second, misconfigurations in your `package.json` may cause necessary files to be excluded from the published version of your package.\n\n## How Rugged helps\n\nRugged facilitates testing your package in the environments and contexts where your package will be used, using the files that would be published (i.e., the compiled/transpiled/bundled files that are included according to your `package.json` settings).\n\nThis is done by injecting the compiled \u0026 packaged version of your package into a series of minimal test projects you create, which mimic the various contexts in which your package could be used/consumed. These test projects live in your package’s repository and simply need a `test` script in their `package.json` files. Rugged will run the `test` script in each test project to verify your package works as expected in each environment/context.\n\n## Quick start\n\nInstall with Yarn or npm:\n\n```\nyarn add --dev rugged\n```\n\n```\nnpm install --save-dev rugged\n```\n\nAdd `rugged` to the `test` script in the `package.json` file:\n\n```json\n{\n    \"scripts\": {\n        \"test\": \"rugged\"\n    }\n}\n```\n\nCreate a `test-projects/` directory with at least one test project inside of it (check out [Rugged’s own test projects](https://github.com/sparksuite/rugged/tree/master/test-projects) for examples, or [the docs](https://ruggedjs.io/docs/getting-started/create-test-projects) for more details and suggested projects).\n\n## Documentation\n\nRead the docs at: https://ruggedjs.io/docs/\n\n## Badge\n\nLet the world know your package is being tested with Rugged!\n\n```markdown\n[![tested with Rugged](https://img.shields.io/badge/tested%20with-Rugged-green)](https://github.com/sparksuite/rugged)\n```\n\n```html\n\u003ca href=\"https://github.com/sparksuite/rugged\"\u003e\n    \u003cimg alt=\"tested with rugged\" src=\"https://img.shields.io/badge/tested%20with-Rugged-green\"\u003e\n\u003c/a\u003e\n```\n\n## Contributing\n\nWe love contributions! Contributing is easy; [learn how](https://github.com/sparksuite/rugged/blob/master/CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsparksuite%2Frugged","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsparksuite%2Frugged","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsparksuite%2Frugged/lists"}