{"id":13779076,"url":"https://github.com/harksys/npmvet","last_synced_at":"2025-05-11T12:32:38.753Z","repository":{"id":44413273,"uuid":"80238774","full_name":"harksys/npmvet","owner":"harksys","description":"A simple CLI tool for vetting npm package versions","archived":false,"fork":false,"pushed_at":"2023-02-01T19:54:57.000Z","size":536,"stargazers_count":206,"open_issues_count":8,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-14T07:17:52.542Z","etag":null,"topics":["checker","checking","ci","ci-automation","cli","npm","package","packages","version","versions","vet"],"latest_commit_sha":null,"homepage":"https://harksys.com/labs/npm-vet-a-simple-cli-tool-for-checking-npm-package-versions","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/harksys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-27T19:27:37.000Z","updated_at":"2024-11-30T05:30:48.000Z","dependencies_parsed_at":"2023-02-08T08:02:27.445Z","dependency_job_id":null,"html_url":"https://github.com/harksys/npmvet","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harksys%2Fnpmvet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harksys%2Fnpmvet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harksys%2Fnpmvet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harksys%2Fnpmvet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harksys","download_url":"https://codeload.github.com/harksys/npmvet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253567189,"owners_count":21928796,"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":["checker","checking","ci","ci-automation","cli","npm","package","packages","version","versions","vet"],"created_at":"2024-08-03T18:01:00.775Z","updated_at":"2025-05-11T12:32:38.333Z","avatar_url":"https://github.com/harksys.png","language":"TypeScript","funding_links":[],"categories":["📦 Finding and vetting npm packages","TypeScript"],"sub_categories":[],"readme":"![](./.github/banner.png?raw=true)\n\n[![Build status](https://ci.appveyor.com/api/projects/status/e6e1rgx0i853jg8b/branch/master?svg=true)](https://ci.appveyor.com/project/andrewhathaway/npmvet/branch/master)\n\n\nNPM Vet is a simple CLI tool to help vet your npm package versions. NPM Vet can be used locally, or as a CI build-step to prevent builds passing with mismatched package versions. To read more about NPM Vet, visit the [Hark website](https://harksys.com/labs/npm-vet-a-simple-cli-tool-for-checking-npm-package-versions).\n\n## Installation\n\n    $ npm install npmvet -g\n\n## Usage\n\n    Usage: npmvet [options]\n\n    Options:\n\n      -h, --help                 output usage information\n      -V, --version              output the version number\n      -p, --package \u003cpackage\u003e    package.json file location (Default: .)\n      -m, --modules \u003cmodules\u003e    node_modules folder location (Default: .)\n      -r, --renderer \u003crenderer\u003e  Renderer to use (Default: inlinetable)\n      -s, --strict               Using the CI renderer, fail build if any packages unlocked (Default: false, flag)\n\n## Strict Mode\n\nIf you're using the CI renderer (see below) the `-s` flag will enable strict mode. In which builds will fail if versions are unlocked, not just unmatching.\n\n## Renderers\n\nRenderers are used to dictate how to output the data NPM Vet collects. The default is `inlinetable`.\n\n### Inline Table\n\n    $ npmvet -r inlinetable\n\nThe default renderer, `inlinetable` will print a table inline with your current process. You can use this locally to visualise package differences.\n\n![](./.github/inlinetable.png?raw=true)\n\n### CI\n\n    $ npmvet -r ci\n\nTo prevent your CI builds passing with mismatched package versions, use the CI renderer. If any package version mismatches are found, the build will fail:\n\n![](./.github/ci-error.png?raw=true)\n\nOr if there are no mismatching package versions, your build will continue (and hopefully pass!):\n\n![](./.github/ci-success.png?raw=true)\n\n### Blessed\n\nThe `blessed` renderer will render a table inside a screen, that has be exited by the user to escape.\n\n    $ npmvet -r blessed\n\n![](./.github/blessed.png?raw=true)\n\n### JSON\nThe `JSON` renderer will print a JSON array with match information for each package.\n\n    $ npmvet -r json\n\n```json\n[\n  {\n    \"name\": \"blessed\",\n    \"packageVersion\": \"0.1.81\",\n    \"installedVersion\": \"0.1.81\",\n    \"matches\": true,\n    \"locked\": false\n  },\n  {\n    \"name\": \"chalk\",\n    \"packageVersion\": \"1.1.3\",\n    \"installedVersion\": \"1.1.3\",\n    \"matches\": true,\n    \"locked\": false\n  },\n  {\n    \"name\": \"jest\",\n    \"packageVersion\": \"18.1.0\",\n    \"installedVersion\": \"18.1.0\",\n    \"matches\": true,\n    \"locked\": false\n  }\n]\n```\n\n## Contributing\n\nFor information regarding contributing to this project, please read the [Contributing](./CONTRIBUTING.md) document.\n\n## License\n\n[MIT License](./LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharksys%2Fnpmvet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharksys%2Fnpmvet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharksys%2Fnpmvet/lists"}