{"id":44849404,"url":"https://github.com/syncromatics/gogitver","last_synced_at":"2026-02-17T06:11:10.868Z","repository":{"id":57536023,"uuid":"143086573","full_name":"syncromatics/gogitver","owner":"syncromatics","description":"Provides semantic versioning through git history","archived":false,"fork":false,"pushed_at":"2020-05-12T23:20:39.000Z","size":998,"stargazers_count":11,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-01-15T07:32:10.895Z","etag":null,"topics":["git","go","semver"],"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/syncromatics.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}},"created_at":"2018-08-01T01:10:21.000Z","updated_at":"2022-11-24T08:10:41.000Z","dependencies_parsed_at":"2022-08-29T00:41:01.221Z","dependency_job_id":null,"html_url":"https://github.com/syncromatics/gogitver","commit_stats":null,"previous_names":["annymsmthd/gogitver"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/syncromatics/gogitver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syncromatics%2Fgogitver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syncromatics%2Fgogitver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syncromatics%2Fgogitver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syncromatics%2Fgogitver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/syncromatics","download_url":"https://codeload.github.com/syncromatics/gogitver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syncromatics%2Fgogitver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29535934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T05:00:25.817Z","status":"ssl_error","status_checked_at":"2026-02-17T04:57:16.126Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["git","go","semver"],"created_at":"2026-02-17T06:11:10.024Z","updated_at":"2026-02-17T06:11:10.861Z","avatar_url":"https://github.com/syncromatics.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gogitver\n\ngogitver is a tool to determine the semantic version of a project based on keywords used in the commit history. This project draws a lot of inspiration from [GitVersion](https://github.com/GitTools/GitVersion) but with the benefit of go's single binary executable. With the work done by go-git the binary produced can run on Linux, Windows, and Mac.\n\n## Getting Started\n\n### Installing\n\n#### Snap\n```snap install gogitver```\n\n#### Binaries\n\nTo install download the latest release from the [releases](https://github.com/syncromatics/gogitver/releases) page for your machine architecture and place the binary in your path. You can then run the executable while in the path of your project and it should output the current version. You can then use this version to tag container images, helm charts, etc.\n\n### Usage\n\nTo get this most out of this tool you should be adding keywords to your git commits.\n\nExample: \n```git commit -m \"(+semver: breaking) this change adds a breaking change to the public api\"```\n\nWhen gogitver sees this commit in the git history it will bump the major version.\n\nThe default regex patterns gogitver will use are:\n\n* Major: ```\\+semver:\\s?(breaking|major)```\n* Minor: ```\\+semver:\\s?(feature|minor)```\n* Patch: ```\\+semver:\\s?(fix|patch)```\n\nHowever you can override these by providing a settings file ```.gogitver.yaml``` that looks like:\n\n```yaml\nmajor-version-bump-message: '(major|breaking)\\(.*\\)'\nminor-version-bump-message: '(feat|feature|minor)\\(.*\\)'\npatch-version-bump-message: '(patch|fix)\\(.*\\)'\n```\n\nYou can also override the name and location of this file by providing the settings flag ```gotgitver --settings=./anotherfile.yaml```\n\n## Development\n\n### Requirements\n\nThis project requires at least [Go](https://golang.org/dl/) 1.11 because it makes use of go modules for dependencies. \n\n### Building\n\nTo build the project simply run ```make build``` which will generate the binaries and put them in the artifacts folder.\n\n## Built With\n\n* [go-git](https://github.com/src-d/go-git) - The git interface\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n\n## Acknowledgments\n\n* [go-git](https://github.com/src-d/go-git) for allowing interactions with git to be easy and without dependencies\n* [GitVersion](https://github.com/GitTools/GitVersion) for the inspiration\n* [Visual Studio Code](https://code.visualstudio.com/) for just being an all around great editor\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyncromatics%2Fgogitver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyncromatics%2Fgogitver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyncromatics%2Fgogitver/lists"}