{"id":22351898,"url":"https://github.com/screwdriver-cd/gitversion","last_synced_at":"2025-07-30T07:32:00.823Z","repository":{"id":10065100,"uuid":"64246575","full_name":"screwdriver-cd/gitversion","owner":"screwdriver-cd","description":"A helper for bumping versions via git tags.","archived":false,"fork":false,"pushed_at":"2023-07-08T01:24:21.000Z","size":78,"stargazers_count":31,"open_issues_count":0,"forks_count":14,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-06-19T00:29:19.850Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cd.screwdriver.cd/pipelines/16","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/screwdriver-cd.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}},"created_at":"2016-07-26T18:57:22.000Z","updated_at":"2024-04-03T10:49:46.000Z","dependencies_parsed_at":"2024-06-19T00:10:22.788Z","dependency_job_id":null,"html_url":"https://github.com/screwdriver-cd/gitversion","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/screwdriver-cd%2Fgitversion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/screwdriver-cd%2Fgitversion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/screwdriver-cd%2Fgitversion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/screwdriver-cd%2Fgitversion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/screwdriver-cd","download_url":"https://codeload.github.com/screwdriver-cd/gitversion/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228106386,"owners_count":17870438,"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":[],"created_at":"2024-12-04T12:16:21.794Z","updated_at":"2025-07-30T07:32:00.815Z","avatar_url":"https://github.com/screwdriver-cd.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitVersion\n[![Build Status][status-image]][status-url] [![Open Issues][issues-image]][issues-url]\n\n\u003e A helper for bumping versions via git tags.\n\n## Usage\n\n```\nNAME:\n   gitversion - manage versions using git tags.\n\nUSAGE:\n   gitversion [global options] command [command options] [arguments...]\n\nVERSION:\n   dev, commit none, built at unknown\n\nCOMMANDS:\n   bump, b  increment the version and create a new git tag\n   show, s  output the latest tagged version\n   help, h  Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --prefix value  set a prefix for the tag name (e.g. v1.0.0)\n   --merged        consider tags merged into this branch (default: false)\n   --help, -h      show help (default: false)\n   --version, -v   print the version (default: false)\n```\n\n```\nNAME:\n   gitversion bump - increment the version and create a new git tag\n\nUSAGE:\n   gitversion bump [command options] [arguments...]\n\nOPTIONS:\n   --dry-run, -n  do not add a git tag; only report the tag that would be added (default: false)\n   \n```\n\n```\nNAME:\n   gitversion show - output the latest tagged version\n\nUSAGE:\n   gitversion show [arguments...]\n```\n\nOnly [semver](http://semver.org/)-style versions with optional prefix are\nsupported at this time (major.minor.patch).\n\n`gitversion` will filter all tags of the format\n`\u003cprefix\u003e\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e-[prerelease]`, sort them, and increment the requested\nfield (patch in this example) on the largest version. It then tags the\ncurrent revision with the result.\n\n### e.g.\n\n```bash\n\u003e git tag\nv1.2.3\nv1.2.4\n\n\u003e gitversion --prefix v bump patch\nBumping patch for version 1.2.4\nv1.2.5\n\n\u003e git tag\nv1.2.3\nv1.2.4\nv1.2.5\n\n\u003e gitversion --prefix v show\nv1.2.5\n```\n\n### Auto\n\nAuto is a special field that will determine the proper field to bump\nbased on the contents of the last commit message.  It looks for anything matching:\n\n\u003e [major] or [major bump]\n\u003e\n\u003e [minor] or [minor bump]\n\nExample:\n```bash\n\u003e git tag\n1.2.3\n1.2.4\n\n\u003e git log -1\n[minor] Added show, major, minor, and auto features\n\n\u003e gitversion bump auto\n1.3.0\n```\n\nAnd will default to patch if none found or if the commit is already tagged.\n\n### Prerelease\n\nFor prerelease versions, we automatically use the short git SHA (e.g. `1.2.3-1644da2`).\n\n_note: prerelease tags should not be pushed to git, only used for local resolution._\n\n## Testing\nPlease ensure that the unit test pass and `golangci-lint` doesn't produce\nany output.\n```bash\ngo test ./...\ngo tool golangci-lint run ./...\n```\n\n## License\n\nCode licensed under the BSD 3-Clause license. See LICENSE file for terms.\n\n[issues-image]: https://img.shields.io/github/issues/screwdriver-cd/screwdriver.svg\n[issues-url]: https://github.com/screwdriver-cd/screwdriver/issues\n[status-image]: https://cd.screwdriver.cd/pipelines/16/badge\n[status-url]: https://cd.screwdriver.cd/pipelines/16\n\n## Installing locally using homebrew\n\n- prerequisite: install [homebrew](https://homebrew.sh/)\n- Tap gitversion\n\n    ```bash\n    brew tap screwdriver-cd/gitversion https://github.com/screwdriver-cd/gitversion.git\n    ```\n\n- Install gitversion\n\n    ```bash\n    brew install screwdriver-cd/gitversion/gitversion\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscrewdriver-cd%2Fgitversion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscrewdriver-cd%2Fgitversion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscrewdriver-cd%2Fgitversion/lists"}