{"id":16720842,"url":"https://github.com/rochejul/npmversion","last_synced_at":"2025-08-24T14:19:01.724Z","repository":{"id":137339430,"uuid":"54670938","full_name":"rochejul/npmversion","owner":"rochejul","description":"A command line node module to deal with \"bumping\" and \"npm version\"","archived":false,"fork":false,"pushed_at":"2025-01-25T20:42:18.000Z","size":988,"stargazers_count":8,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-08T20:26:38.581Z","etag":null,"topics":["bump","nodejs","npm","versioning"],"latest_commit_sha":null,"homepage":null,"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/rochejul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","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-03-24T20:09:12.000Z","updated_at":"2025-01-25T20:42:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"7897060a-6cfb-4511-b325-cb3b26c82782","html_url":"https://github.com/rochejul/npmversion","commit_stats":{"total_commits":146,"total_committers":3,"mean_commits":"48.666666666666664","dds":0.4931506849315068,"last_synced_commit":"bf4541f836cfefb4896e05754f0fb2a06b9b36c8"},"previous_names":["rochejul/node-version"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/rochejul/npmversion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochejul%2Fnpmversion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochejul%2Fnpmversion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochejul%2Fnpmversion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochejul%2Fnpmversion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rochejul","download_url":"https://codeload.github.com/rochejul/npmversion/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochejul%2Fnpmversion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271885296,"owners_count":24838646,"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-08-24T02:00:11.135Z","response_time":111,"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":["bump","nodejs","npm","versioning"],"created_at":"2024-10-12T22:26:54.539Z","updated_at":"2025-08-24T14:19:01.694Z","avatar_url":"https://github.com/rochejul.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\n  \u003ca href=\"https://www.npmjs.com/package/npmversion\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/npmversion\" alt=\"npm version\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/rochejul/npmversionblob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/l/npmversion.svg\" alt=\"license\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://snyk.io/test/github/rochejul/npmversion\"\u003e\n    \u003cimg src=\"https://snyk.io/test/github/rochejul/npmversion/badge.svg?targetFile=package.json\" alt=\"Known Vulnerabilities\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/rochejul/npmversion/actions/workflows/node.js.yml\"\u003e\n    \u003cimg src=\"https://github.com/rochejul/npmversion/actions/workflows/node.js.yml/badge.svg\" alt=\"Node.js Unit Test\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# npmversion\n\nA command line node module to deal with \"bumping\" and \"npm version\"\n\nThe \"version\" command will:\n\n- change the package version of the `package.json` file and in the `package-lock.json` file if this one exists\n- update also the packages of your workspace and the inter-dependencies\n- deal with the prenumber and the preid flag\n- create git commits and tags\n- push the git commits and tags\n\n## Breaking changes with 1.X\n\n- No more pre/post npm run scripts\n- No more json files modifications (except from NPM's ecosystem)\n- Deal with NPM packages\n- Split in packages\n  - [@npmversion/cli](./packages/cli/README.md): the new cli tool (we keep `npmversion` for posterity)\n  - [@npmversion/core](./packages/core/README.md): the core logic of the tool\n  - [@npmversion/workspace](./packages/workspace/README.md): the tool logic to deal with npm packages, dependencies order, etc...\n\n## Possible options\n\n    --help\n        Print the help around the command\n\n    -i --increment [\u003clevel\u003e]\n        Increment a version by the specified level.  Level can\n        be one of: major, minor, patch, premajor, preminor,\n        prepatch, or prerelease.  Default level is 'patch'.\n        Only one version may be specified. A Git commit and\n        tag will be created.\n        Nota Bene: it will use the \"npm version\" command if the option\n        \"read-only\" is not activated.\n\n        -p --preid \u003cidentifier\u003e\n            Identifier to be used to prefix premajor, preminor,\n            prepatch or prerelease version increments. It could\n            be 'snapshot', 'beta' or 'alpha' for example.\n\n        --force-preid\n            If specified, we force to add if needed the specified preid\n\n        --read-only\n                Print only the future version. Don't modify the package.json file,\n                nor the npm-shrinkwrap.json file, don't create a commit and don't\n                create a git tag\n\n        --nogit-commit\n            No git commit\n\n        --nogit-tag\n            No git tag\n\n        --git-push\n            Push the commit and the tags if needed\n\n    -u  --unpreid\n        Remove the prefix. The increment and preid option will be ignored.\n        Only a Git commit will be created\n\n        --read-only\n               Print only the future version. Don't modify the package.json file,\n               nor the npm-shrinkwrap.json file, don't create a commit and don't\n               create a git tag\n\n       --nogit-commit\n           No git commit\n\n       --nogit-tag\n           No git tag\n\n       --git-push\n           Push the commit and the tags if needed\n\n## How to import it ?\n\nType the command \"npm install --save-dev --save-exact npmversion\n\n```json\n{\n  \"name\": \"my-app\",\n  \"version\": \"1.2.0\",\n  \"devDependencies\": {\n    \"npmversion\": \"latest\"\n  }\n}\n```\n\n## Possible NPM-RUN configuration\n\n```json\n{\n  \"name\": \"my-app\",\n  \"version\": \"0.0.1\",\n  \"scripts\": {\n    \"test\": \"node ./node_modules/mocha/bin/mocha --recursive --ui bdd --colors ./test\",\n\n    \"bump-release\": \"npm run test \u0026\u0026 npmversion --unpreid --git-push\",\n\n    \"bump-major\": \"npm run test \u0026\u0026 npmversion --increment major --git-push\",\n    \"bump-minor\": \"npm run test \u0026\u0026 npmversion --increment minor --git-push\",\n    \"bump-patch\": \"npm run test \u0026\u0026 npmversion --increment patch --git-push\",\n\n    \"bump-major-beta\": \"npmversion --increment major --preid beta --nogit-tag --git-push\",\n    \"bump-minor-beta\": \"npmversion --increment minor --preid beta --nogit-tag --git-push\",\n    \"bump-patch-beta\": \"npmversion --increment patch --preid beta --nogit-tag --git-push\"\n  }\n}\n```\n\n## Possible .npmversionrc configuration\n\n```json\n{\n  \"force-preid\": true,\n  \"nogit-commit\": false,\n  \"nogit-tag\": true,\n  \"git-push\": false,\n  \"git-create-branch\": false,\n  \"git-branch-message\": \"release/%s\",\n  \"git-commit-message\": \"Release version: %s\",\n  \"git-tag-message\": \"v%s\",\n  \"increment\": \"minor\",\n  \"git-remote-name\": null\n}\n```\n\n## Possible outputs\n\n### In a classical way\n\n```\n\u003e semver 1.2.3 --increment patch                             1.2.4\n\u003e semver 1.2.3 --increment minor                             1.3.0\n\u003e semver 1.2.3 --increment major                             2.0.0\n\u003e semver 1.2.3 --increment prerelease                        1.2.4-0\n\u003e semver 1.2.3 --increment prepatch                          1.2.4-0\n\u003e semver 1.2.3 --increment preminor                          1.3.0-0\n\u003e semver 1.2.3 --increment premajor                          2.0.0-0\n\n\u003e semver 1.2.3-0 --increment patch                           1.2.3\n\u003e semver 1.2.3-0 --increment minor                           1.3.0\n\u003e semver 1.2.3-0 --increment major                           2.0.0\n\u003e semver 1.2.3-0 --increment prerelease                      1.2.3-1\n\u003e semver 1.2.3-0 --increment prepatch                        1.2.4-0\n\u003e semver 1.2.3-0 --increment preminor                        1.3.0-0\n\u003e semver 1.2.3-0 --increment premajor                        2.0.0-0\n\n\u003e semver 1.2.3-beta --increment patch                        1.2.4\n\u003e semver 1.2.3-beta --increment minor                        1.3.0\n\u003e semver 1.2.3-beta --increment major                        2.0.0\n\u003e semver 1.2.3-beta --increment prerelease                   1.2.3-beta.0\n\u003e semver 1.2.3-beta --increment prepatch                     1.2.4-0\n\u003e semver 1.2.3-beta --increment preminor                     1.3.0-0\n\u003e semver 1.2.3-beta --increment premajor                     2.0.0-0\n\n\u003e semver 1.2.3-beta.0 --increment patch                      1.2.4\n\u003e semver 1.2.3-beta.0 --increment minor                      1.3.0\n\u003e semver 1.2.3-beta.0 --increment major                      2.0.0\n\u003e semver 1.2.3-beta.0 --increment prerelease                 1.2.3-beta.1\n\u003e semver 1.2.3-beta.0 --increment prepatch                   1.2.4-0\n\u003e semver 1.2.3-beta.0 --increment preminor                   1.3.0-0\n\u003e semver 1.2.3-beta.0 --increment premajor                   2.0.0-0\n\n\u003e semver 1.2.3 --preid beta --increment patch                 1.2.4\n\u003e semver 1.2.3 --preid beta --increment minor                 1.3.0\n\u003e semver 1.2.3 --preid beta --increment major                 2.0.0\n\u003e semver 1.2.3 --preid beta --increment prerelease            1.2.4-beta.0\n\u003e semver 1.2.3 --preid beta --increment prepatch              1.2.4-beta.0\n\u003e semver 1.2.3 --preid beta --increment preminor              1.3.0-beta.0\n\u003e semver 1.2.3 --preid beta --increment premajor              2.0.0-beta.0\n\n\u003e semver 1.2.3-0 --preid beta --increment patch               1.2.4\n\u003e semver 1.2.3-0 --preid beta --increment minor               1.3.0\n\u003e semver 1.2.3-0 --preid beta --increment major               2.0.0\n\u003e semver 1.2.3-0 --preid beta --increment prerelease          1.2.3-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment prepatch            1.2.4-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment preminor            1.3.0-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment premajor            2.0.0-beta.0\n\n\u003e semver 1.2.3-beta --preid beta --increment patch            1.2.4\n\u003e semver 1.2.3-beta --preid beta --increment minor            1.3.0\n\u003e semver 1.2.3-beta --preid beta --increment major            2.0.0\n\u003e semver 1.2.3-beta --preid beta --increment prerelease       1.2.3-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment prepatch         1.2.4-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment preminor         1.3.0-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment premajor         2.0.0-beta.0\n\n\u003e semver 1.2.3-beta.0 --preid beta --increment patch          1.2.4\n\u003e semver 1.2.3-beta.0 --preid beta --increment minor          1.3.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment major          2.0.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment prerelease     1.2.3-beta.1\n\u003e semver 1.2.3-beta.0 --preid beta --increment prepatch       1.2.4-beta.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment preminor       1.3.0-beta.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment premajor       2.0.0-beta.0\n\n```\n\n### With the force-preid option\n\n```\n\u003e semver 1.2.3 --increment patch                             1.2.4\n\u003e semver 1.2.3 --increment minor                             1.3.0\n\u003e semver 1.2.3 --increment major                             2.0.0\n\u003e semver 1.2.3 --increment prerelease                        1.2.4-0\n\u003e semver 1.2.3 --increment prepatch                          1.2.4-0\n\u003e semver 1.2.3 --increment preminor                          1.3.0-0\n\u003e semver 1.2.3 --increment premajor                          2.0.0-0\n\n\u003e semver 1.2.3-0 --increment patch                           1.2.3\n\u003e semver 1.2.3-0 --increment minor                           1.3.0\n\u003e semver 1.2.3-0 --increment major                           2.0.0\n\u003e semver 1.2.3-0 --increment prerelease                      1.2.3-1\n\u003e semver 1.2.3-0 --increment prepatch                        1.2.4-0\n\u003e semver 1.2.3-0 --increment preminor                        1.3.0-0\n\u003e semver 1.2.3-0 --increment premajor                        2.0.0-0\n\n\u003e semver 1.2.3-beta --increment patch                        1.2.4\n\u003e semver 1.2.3-beta --increment minor                        1.3.0\n\u003e semver 1.2.3-beta --increment major                        2.0.0\n\u003e semver 1.2.3-beta --increment prerelease                   1.2.3-beta.0\n\u003e semver 1.2.3-beta --increment prepatch                     1.2.4-0\n\u003e semver 1.2.3-beta --increment preminor                     1.3.0-0\n\u003e semver 1.2.3-beta --increment premajor                     2.0.0-0\n\n\u003e semver 1.2.3-beta.0 --increment patch                      1.2.4\n\u003e semver 1.2.3-beta.0 --increment minor                      1.3.0\n\u003e semver 1.2.3-beta.0 --increment major                      2.0.0\n\u003e semver 1.2.3-beta.0 --increment prerelease                 1.2.3-beta.1\n\u003e semver 1.2.3-beta.0 --increment prepatch                   1.2.4-0\n\u003e semver 1.2.3-beta.0 --increment preminor                   1.3.0-0\n\u003e semver 1.2.3-beta.0 --increment premajor                   2.0.0-0\n\n\u003e semver 1.2.3 --preid beta --increment patch                 1.2.4-beta\n\u003e semver 1.2.3 --preid beta --increment minor                 1.3.0-beta\n\u003e semver 1.2.3 --preid beta --increment major                 2.0.0-beta\n\u003e semver 1.2.3 --preid beta --increment prerelease            1.2.4-beta.0\n\u003e semver 1.2.3 --preid beta --increment prepatch              1.2.4-beta.0\n\u003e semver 1.2.3 --preid beta --increment preminor              1.3.0-beta.0\n\u003e semver 1.2.3 --preid beta --increment premajor              2.0.0-beta.0\n\n\u003e semver 1.2.3-0 --preid beta --increment patch               1.2.3-beta\n\u003e semver 1.2.3-0 --preid beta --increment minor               1.3.0-beta\n\u003e semver 1.2.3-0 --preid beta --increment major               2.0.0-beta\n\u003e semver 1.2.3-0 --preid beta --increment prerelease          1.2.3-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment prepatch            1.2.4-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment preminor            1.3.0-beta.0\n\u003e semver 1.2.3-0 --preid beta --increment premajor            2.0.0-beta.0\n\n\u003e semver 1.2.3-beta --preid beta --increment patch            1.2.4-beta\n\u003e semver 1.2.3-beta --preid beta --increment minor            1.3.0-beta\n\u003e semver 1.2.3-beta --preid beta --increment major            2.0.0-beta\n\u003e semver 1.2.3-beta --preid beta --increment prerelease       1.2.3-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment prepatch         1.2.4-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment preminor         1.3.0-beta.0\n\u003e semver 1.2.3-beta --preid beta --increment premajor         2.0.0-beta.0\n\n\u003e semver 1.2.3-beta.0 --preid beta --increment patch          1.2.4-beta\n\u003e semver 1.2.3-beta.0 --preid beta --increment minor          1.3.0-beta\n\u003e semver 1.2.3-beta.0 --preid beta --increment major          2.0.0-beta\n\u003e semver 1.2.3-beta.0 --preid beta --increment prerelease     1.2.3-beta.1\n\u003e semver 1.2.3-beta.0 --preid beta --increment prepatch       1.2.4-beta.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment preminor       1.3.0-beta.0\n\u003e semver 1.2.3-beta.0 --preid beta --increment premajor       2.0.0-beta.0\n```\n\n## Commands\n\n- `npm run dev:check`: Run tests and styling over packages\n- `npm run dev:format`: Format files over packages\n- `npm run dev:format:check`: Check files format over packages\n- `npm run dev:linting`: Lint files over packages\n- `npm run dev:styling`: Format and lint files over packages\n- `npm run dev:publish`: Publish all the packages on npm registry\n- `npm test`: Run tests over packages\n- `npm run test:coverage`: Run tests over packages and see coverage reports\n\n## Contributing\n\n- [Guidelines](./docs/GUIDELINES.md)\n- [Contributing](./docs/CONTRIBUTING.md)\n- [Code of conducts](./docs/CODE_OF_CONDUCTS.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frochejul%2Fnpmversion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frochejul%2Fnpmversion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frochejul%2Fnpmversion/lists"}