{"id":26155547,"url":"https://github.com/tsdtsdtsd/nextversion","last_synced_at":"2026-04-17T16:32:45.778Z","repository":{"id":224141472,"uuid":"755385463","full_name":"tsdtsdtsd/nextversion","owner":"tsdtsdtsd","description":"Automatic semantic versioning utility","archived":false,"fork":false,"pushed_at":"2025-09-05T08:12:27.000Z","size":139,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-05T10:11:55.134Z","etag":null,"topics":["cicd","continuous-delivery","continuous-deployment","continuous-integration","version","version-control","versioning"],"latest_commit_sha":null,"homepage":"","language":"Go","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/tsdtsdtsd.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-10T03:20:06.000Z","updated_at":"2025-09-05T08:12:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"f9ce7caf-83ce-49a6-85f6-884cf9cab59b","html_url":"https://github.com/tsdtsdtsd/nextversion","commit_stats":null,"previous_names":["tsdtsdtsd/nextversion"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/tsdtsdtsd/nextversion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsdtsdtsd%2Fnextversion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsdtsdtsd%2Fnextversion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsdtsdtsd%2Fnextversion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsdtsdtsd%2Fnextversion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsdtsdtsd","download_url":"https://codeload.github.com/tsdtsdtsd/nextversion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsdtsdtsd%2Fnextversion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31936638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T12:37:54.787Z","status":"ssl_error","status_checked_at":"2026-04-17T12:37:25.095Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cicd","continuous-delivery","continuous-deployment","continuous-integration","version","version-control","versioning"],"created_at":"2025-03-11T08:57:07.944Z","updated_at":"2026-04-17T16:32:45.773Z","avatar_url":"https://github.com/tsdtsdtsd.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nextversion\n\n\u003e Automatic semantic versioning utility\n\n![Latest Release Version][shields-version-img]\n[![Godoc][godoc-image]][godoc-url]\n![Build Status](https://github.com/tsdtsdtsd/nextversion/actions/workflows/ci.yml/badge.svg)\n[![Go Report Card][grc-image]][grc-url]\n[![codecov][codecov-image]][codecov-url]\n[![CodeQL](https://github.com/tsdtsdtsd/nextversion/actions/workflows/codeql-analysis.yml/badge.svg?branch=main)](https://github.com/tsdtsdtsd/nextversion/actions/workflows/codeql-analysis.yml)\n\n\u003c!-- Markdown link \u0026 img dfn's --\u003e\n[shields-version-img]: https://img.shields.io/github/v/release/tsdtsdtsd/nextversion\n[godoc-image]: https://pkg.go.dev/badge/github.com/tsdtsdtsd/nextversion.svg\n[godoc-url]: https://pkg.go.dev/github.com/tsdtsdtsd/nextversion/pkg/nextversion/\n[grc-image]: https://goreportcard.com/badge/github.com/tsdtsdtsd/nextversion\n[grc-url]: https://goreportcard.com/report/github.com/tsdtsdtsd/nextversion\n[codecov-image]: https://codecov.io/gh/tsdtsdtsd/nextversion/branch/main/graph/badge.svg\n[codecov-url]: https://codecov.io/gh/tsdtsdtsd/nextversion/tree/main\n\nnextversion detects current application version based on git tags and suggests a bumped version based on [conventional commit messages](https://www.conventionalcommits.org/en/v1.0.0/).\n\n## Constraints\n\n- nextversion needs annotated git tags to determine the current app version\n- nextversion does not create tags for you, it only generates a suggestion\n- nextversion sticks to [Semantic Versioning](https://semver.org/) and [Conventional Commits](https://www.conventionalcommits.org):\n  - your tags must follow the semver pattern without prerelease suffix and an optional `v` prefix (e.g. `v1.2.3` or `1.2.3`).\n  - you have to make sure that commit messages follow the [Conventional Commits spec](https://www.conventionalcommits.org/en/v1.0.0/).  \n    The used parser is in [best effort mode](https://github.com/leodido/go-conventionalcommits#best-effort)\n\n## Usage\n\n```sh\n# Let's check the CLI help screen\n\n$ nextversion --help\nNAME:\n   nextversion - versioning helper tool\n\nUSAGE:\n   nextversion [global options] [command]\n\nVERSION:\n   v0.5.1\n\nDESCRIPTION:\n   nextversion detects application version based on git tags and suggests a bumped version based on conventional commits.\n\nCOMMANDS:\n   help, h  Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --repo PATH, -r PATH                   PATH to a git repository (default: \"./\")\n   --format FORMAT, -f FORMAT             Output FORMAT (simple, json) (default: \"simple\")\n   --default-current VERSION, -d VERSION  Fallback current VERSION if none could be detected (default: \"v0.0.0\")\n   --pre-stable, -p                       Breaking changes will not increase major version if current version matches v0.*.* (default: false)\n   --force-stable, -s                     Force updating to at least v1.0.0 (this has precedence over the --pre-stable flag) (default: false)\n   --help, -h                             show help\n   --version, -v                          print version of this tool (default: false)\n\n# Run nextversion \n\n~/my-repo$ nextversion\nCURRENT=v0.1.2\nCURRENT_STRICT=0.1.2\nHAS_CURRENT=true\nNEXT=v0.2.0\nNEXT_STRICT=0.2.0\nHAS_NEXT=true\nPRERELEASE=v0.2.0-rc+main.cd81544\nPRERELEASE_STRICT=0.2.0-rc+main.cd81544\nPRERELEASE_DOCKER_TAG=0.2.0-rc-main.cd81544\n\n# Please return JSON and make it readable\n\n~/my-repo$ nextversion -f json | jq\n{\n  \"current\": \"v0.1.2\",\n  \"current-strict\": \"0.1.2\",\n  \"has-current\": true,\n  \"next\": \"v0.2.0\",\n  \"next-strict\": \"0.2.0\",\n  \"has-next\": true,\n  \"prerelease\": \"v0.2.0-rc+main.cd81544\",\n  \"prerelease-strict\": \"0.2.0-rc+main.cd81544\",\n  \"prerelease-docker-tag\": \"0.2.0-rc-main.cd81544\"\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsdtsdtsd%2Fnextversion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsdtsdtsd%2Fnextversion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsdtsdtsd%2Fnextversion/lists"}