{"id":13562666,"url":"https://github.com/caarlos0/svu","last_synced_at":"2025-05-14T12:11:44.013Z","repository":{"id":40469842,"uuid":"114146304","full_name":"caarlos0/svu","owner":"caarlos0","description":"semantic version utility","archived":false,"fork":false,"pushed_at":"2025-05-12T08:30:13.000Z","size":2741,"stargazers_count":657,"open_issues_count":9,"forks_count":51,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-12T09:56:05.608Z","etag":null,"topics":["golang","hacktoberfest","semantic-versioning","util"],"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/caarlos0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":["caarlos0"]}},"created_at":"2017-12-13T16:54:42.000Z","updated_at":"2025-05-12T08:30:16.000Z","dependencies_parsed_at":"2024-02-01T16:17:03.739Z","dependency_job_id":"c4629731-90c0-4668-bbe5-b7449ae69f4e","html_url":"https://github.com/caarlos0/svu","commit_stats":{"total_commits":193,"total_committers":23,"mean_commits":8.391304347826088,"dds":0.5129533678756477,"last_synced_commit":"2efa9ffdb78883d194182506518bf8ac79167506"},"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caarlos0%2Fsvu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caarlos0%2Fsvu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caarlos0%2Fsvu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caarlos0%2Fsvu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caarlos0","download_url":"https://codeload.github.com/caarlos0/svu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254140768,"owners_count":22021220,"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":["golang","hacktoberfest","semantic-versioning","util"],"created_at":"2024-08-01T13:01:10.947Z","updated_at":"2025-05-14T12:11:43.969Z","avatar_url":"https://github.com/caarlos0.png","language":"Go","funding_links":["https://github.com/sponsors/caarlos0"],"categories":["Tools","hacktoberfest","Go"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"svu Logo\" src=\"https://becker.software/svu.png\" height=\"300\" /\u003e\n  \u003cp align=\"center\"\u003esemantic version utility\u003c/p\u003e\n\u003c/p\u003e\n\n\u003chr\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/caarlos0/svu/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/release/caarlos0/svu.svg?style=for-the-badge\" alt=\"Release\"\u003e\u003c/a\u003e\n\u003ca href=\"/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-brightgreen.svg?style=for-the-badge\" alt=\"Software License\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/caarlos0/svu/actions?workflow=build\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/caarlos0/svu/build.yml?style=for-the-badge\u0026branch=main\" alt=\"Build status\"\u003e\u003c/a\u003e\n\u003ca href=\"http://godoc.org/github.com/caarlos0/svu/v3\"\u003e\u003cimg src=\"https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge\" alt=\"Go Doc\"\u003e\u003c/a\u003e\n\u003ca href=\"https://goreportcard.com/report/github.com/caarlos0/svu/v3\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/caarlos0/svu/v3?style=for-the-badge\" alt=\"GoReportCard\"\u003e\u003c/a\u003e\n\u003ca href=\"https://conventionalcommits.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=for-the-badge\" alt=\"Conventional Commits\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\nsemantic version utility (svu) is a small helper for release scripts and workflows.\n\nIt provides utility commands and functions to increase specific portions of the version.\nIt can also figure the next version out automatically by looking through the git history.\n\n\u003e [!TIP]\n\u003e Read [the spec][Semver] for more information.\n\n## usage\n\nCheck `svu --help` for the list of sub-commands and flags.\n\n### `next`, `n`\n\nThis is probably the command you'll use the most.\n\nIt checks your `git log`, and automatically increases and returns the new\nversion based on this table:\n\n| Commit message                                                                         | Tag increase |\n| -------------------------------------------------------------------------------------- | ------------ |\n| `chore: foo`                                                                           | Nothing      |\n| `fix: fixed something`                                                                 | Patch        |\n| `feat: added new button to do X`                                                       | Minor        |\n| `fix: fixed thing xyz`\u003cbr\u003e\u003cbr\u003e`BREAKING CHANGE: this will break users because of blah` | Major        |\n| `fix!: fixed something`                                                                | Major        |\n| `feat!: added blah`                                                                    | Major        |\n\n\u003e [!TIP]\n\u003e You can create an alias to create tags automatically:\n\u003e\n\u003e ```bash\n\u003e alias gtn='git tag $(svu next)'\n\u003e ```\n\n## configuration\n\nEvery flag option can also be set in a `.svu.yml` in the current\ndirectory/repository root folder, for example:\n\n```yaml\ntag.prefix: \"\"\nalways: true\nv0: true\n```\n\nNames are the same as the flags themselves.\n\n## install\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/svu.svg)](https://repology.org/project/svu/versions)\n\n\u003cdetails\u003e\n  \u003csummary\u003emacOS\u003c/summary\u003e\n\n```bash\nbrew install caarlos0/tap/svu\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003elinux/apt\u003c/summary\u003e\n\n```bash\necho 'deb [trusted=yes] https://apt.fury.io/caarlos0/ /' | sudo tee /etc/apt/sources.list.d/caarlos0.list\nsudo apt update\nsudo apt install svu\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003elinux/yum\u003c/summary\u003e\n\n```bash\necho '[caarlos0]\nname=caarlos0\nbaseurl=https://yum.fury.io/caarlos0/\nenabled=1\ngpgcheck=0' | sudo tee /etc/yum.repos.d/caarlos0.repo\nsudo yum install svu\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003edocker\u003c/summary\u003e\n\n```bash\ndocker run --rm -v $PWD:/tmp --workdir /tmp ghcr.io/caarlos0/svu --help\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003ccode\u003ego install\u003c/code\u003e\u003c/summary\u003e\n\n```bash\ngo install github.com/caarlos0/svu/v3@latest\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003emanually\u003c/summary\u003e\n\nOr download one from the [releases tab](https://github.com/caarlos0/svu/releases) and install manually.\n\n\u003c/details\u003e\n\n## stargazers over time\n\n[![Stargazers over time](https://starchart.cc/caarlos0/svu.svg?variant=adaptive)](https://starchart.cc/caarlos0/svu)\n\n[Semver]: https://semver.org\n\n---\n\nLogo art and concept by [@carinebecker](https://github.com/carinebecker).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaarlos0%2Fsvu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaarlos0%2Fsvu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaarlos0%2Fsvu/lists"}