{"id":22423413,"url":"https://github.com/prantlf/bump-version-action","last_synced_at":"2025-03-27T05:41:00.552Z","repository":{"id":202952199,"uuid":"708481553","full_name":"prantlf/bump-version-action","owner":"prantlf","description":"GitHub action for updating changelog and bumping the project version using git commit messages formatted according to Conventional Commits and Semantic Versioning.","archived":false,"fork":false,"pushed_at":"2024-05-12T22:45:28.000Z","size":29,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T10:43:04.731Z","etag":null,"topics":["actions","bump","github","github-actions","release","v","version","vlang"],"latest_commit_sha":null,"homepage":"","language":"AMPL","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/prantlf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-10-22T17:30:20.000Z","updated_at":"2024-05-12T22:44:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"e998cbf4-4a0c-4513-a12c-0c4c8ace8435","html_url":"https://github.com/prantlf/bump-version-action","commit_stats":null,"previous_names":["prantlf/bump-version-action"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prantlf%2Fbump-version-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prantlf%2Fbump-version-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prantlf%2Fbump-version-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prantlf%2Fbump-version-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prantlf","download_url":"https://codeload.github.com/prantlf/bump-version-action/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245791899,"owners_count":20672668,"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":["actions","bump","github","github-actions","release","v","version","vlang"],"created_at":"2024-12-05T18:11:17.608Z","updated_at":"2025-03-27T05:41:00.532Z","avatar_url":"https://github.com/prantlf.png","language":"AMPL","readme":"# Update Changelog and Bump Version\n\nGitHub action for updating changelog and bumping the project version using git commit messages formatted according to [Conventional Commits] and [Semantic Versioning].\n\nUses tools [newchanges] and [vp]. Uses git to detect changed files. Only platforms Linux, macOS, Windows on the architecture X64 are supported.\n\n## Usage\n\nUpdate the change log and write the new version ot the project source files:\n\n```yml\n- uses: prantlf/bump-version-action@v2\n```\n\nWork only in specific release branches, bump the version number in an extra file:\n\n```yml\njobs:\n  build:\n    steps:\n    - uses: actions/checkout@v4\n    - uses: prantlf/setup-v-action@v2\n    - run: ...\n    - uses prantlf/bump-version-action@v2\n      with:\n        branches: master v1.x\n        bump-files: src/newchanges.v\n```\n\n**Attention**: This action can be used only to update an already published project. The first publishing has to happen manually:\n\n1. Changelog with the first version has to be added, for example, a file `CHANGELOG.md`:\n\n```\n# Changes\n\n# 1.0.0 (2023-10-22)\n\nInitial release\n```\n\n2. Commit releasing the first version has to be correspondingly tagged, for example with `v1.0.0`.\n\nThen this action can be added to a GitHub workflow.\n\n## Inputs\n\nThe following parameters can be specified using the `with` object:\n\n### branches\n\nType: `String`\u003cbr\u003e\nDefault: `'main master'`\n\nBranches which this action should run for, which are used to publishing releases. Use whitespace for separating the branch names. If you want to use multiple lines in YAML, introduce them with \"\u003e-\". If you want to allow all branches, set the value to \"*\".\n\n### no-node\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nSet to `true` to ignore `package.json` and not handle the project as a Node.js package.\n\n### no-vlang\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nSet to `true` not to ignore `v.mod` and not handle the project as a V package.\n\n### no-rust\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nSet to `true` not to ignore `Cargo.toml` and not handle the project as a Rust package.\n\n### no-golang\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nSet to `true` not to ignore `go.mod` and not handle the project as a Go package.\n\n### bump-files\n\nType: `String`\u003cbr\u003e\n\nExtra files in which to bump the version number, in addition to the package description file.\n\n### enable\n\nType: `Boolean`\u003cbr\u003e\nDefault: `true`\n\nCan be set to `false` to prevent this action from running. It's helpful in the pipeline, which will not continue releasing, but only building and testing, and that will be decided in the middle of a job execution.\n\n### dry-run\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nCan be set to `true` to only print what would be done without actually doing it.\n\n### debug\n\nType: `Boolean`\u003cbr\u003e\nDefault: `false`\n\nCan be set to `true` to enable debug logging of the supporting tools. Debug logging will be enabled also if it's enabled on the runner.\n\n## Outputs\n\nThe following parameters can be accessed by the `github` context:\n\n### bumped\n\nType: `String`\u003cbr\u003e\n\nSet to `true` if the changelog was updated and the new version set.\n\n### new-version\n\nType: `String`\u003cbr\u003e\n\nThe new version written to the changelog and to the project source files.\n\n### changed-files\n\nType: `String`\u003cbr\u003e\n\nFiles modified by this action, separated by spaces.\n\n## License\n\nCopyright (C) 2023-2024 Ferdinand Prantl\n\nLicensed under the [MIT License].\n\n[MIT License]: http://en.wikipedia.org/wiki/MIT_License\n[Conventional Commits]: https://www.conventionalcommits.org/\n[Semantic Versioning]: https://semver.org/\n[newchanges]: https://github.com/prantlf/v-newchanges\n[vp]: https://github.com/prantlf/vp\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprantlf%2Fbump-version-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprantlf%2Fbump-version-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprantlf%2Fbump-version-action/lists"}