{"id":13478895,"url":"https://github.com/franiglesias/versiontag","last_synced_at":"2026-01-14T20:52:07.475Z","repository":{"id":46960367,"uuid":"141883984","full_name":"franiglesias/versiontag","owner":"franiglesias","description":"Bash command to automate tag semantic versioning","archived":false,"fork":false,"pushed_at":"2024-01-22T14:07:52.000Z","size":63,"stargazers_count":47,"open_issues_count":6,"forks_count":14,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-12T02:13:04.144Z","etag":null,"topics":["bash","git-tools","semantic-versioning","versioning"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/franiglesias.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}},"created_at":"2018-07-22T09:52:26.000Z","updated_at":"2025-04-23T04:51:48.000Z","dependencies_parsed_at":"2024-01-22T10:55:53.909Z","dependency_job_id":"105d9e53-e026-4bf2-a425-b58666ce211c","html_url":"https://github.com/franiglesias/versiontag","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/franiglesias/versiontag","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franiglesias%2Fversiontag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franiglesias%2Fversiontag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franiglesias%2Fversiontag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franiglesias%2Fversiontag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/franiglesias","download_url":"https://codeload.github.com/franiglesias/versiontag/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franiglesias%2Fversiontag/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28434500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"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":["bash","git-tools","semantic-versioning","versioning"],"created_at":"2024-07-31T16:02:05.372Z","updated_at":"2026-01-14T20:52:07.435Z","avatar_url":"https://github.com/franiglesias.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# versiontag\n\nBash command to automate tagging with semantic versioning in a git repository.\n\nCurrent version: v2.1.3\n\n## Features\n\nAllow easy maintenance of semantic versioning in git projects.\n\nSince 1.4.2 supports .semver file writing.\n\nSince 2.0.0 tags are not annotated by default. You must use the option `-m` or `--message` to annotate the tag.\n\n## Commands\n\n`help` - Shows a help  \n`current` - Shows the last version tag found. If there is none it defaults to `v0.0.0`    \n`patch` - Increases patch version: `v1.0.0 -\u003e v1.0.1`  \n`minor` - Increases minor version (and resets patch): `v1.0.5 -\u003e v1.1.0`  \n`major` - Increases major version (and resets minor and patch): `v1.3.4 -\u003e v2.0.0`  \n`remove` - Removes the last tag in the repository. This command doesn't support the `-f|--force` option.  \n\n## Options\n\n`-h|--help` - Shows help.  \n`-f|--force` - Script won't ask for confirmation.  \n`-d|--dry` - Executes without perform any change.  \n`-m|--message` - Annotates the tag with the message.  \n`-s|--semver` - Generates the .semver file.  \n\n## Installation\n\n* Copy the script to the place you want. Best in your `$PATH`.\n* Make it executable if needed.\n* There is no step three, I guess.\n\nIf you want to install it on your Linux or Mac OS X machine, use:\n\n```bash\nsudo curl -L \\\nhttps://raw.githubusercontent.com/franiglesias/versiontag/master/versiontag \\\n-o /usr/local/bin/versiontag \\\n\u0026\u0026 sudo chmod +x /usr/local/bin/versiontag \\\n\u0026\u0026 versiontag help\n```\n\n## Tests\n\nTests should help you to understand how **versiontag** works and to modify the code without breaking functionality. More tests are coming soon.\n\nRun the tests with the following command. \n\n```bash\nbash testCases/testAll.sh\n```\n\n## Known limitations\n\nYou should update your master before running `versiontag` in order to get the latest tags from the remote repo. \n\n## Contributors\n\nFeel free to suggest improvements and ideas. \n\nA big thank you to:\n\n[Patrik Kristian](https://github.com/pkristian): \n\n* Tests\n* Linux installation instructions\n* Several code improvements\n\n [Javier Ferrer](https://github.com/JavierCane)\n \n * Suggested .semver file\n \n [Asghar Ghorbani](https://github.com/a-ghorbani)\n \n * Fixed problem with remove command\n \n [Skarev](https://github.com/skarev)\n \n * Improve tag sorting\n\nYour name here ;-)\n\n## Basic usage\n\n```\n$ versiontag patch|minor|major [-m 'Tag message']\n```\n\nThe command will show current and updated version and will prompt you to create the tag in the local version.\n\nAfter that, it will prompt you to push the tag to remote repository.\n\nThat's all.\n\n## Examples\n\nShow current version\n\n```bash\n$ versiontag current\n```\n\nGenerate .semver for current version\n\n```bash\n$ versiontag current --semver\n```\n\n\nPatch version\n\n```bash\n$ versiontag patch -m 'Fix broken view'\n```\n\nForce patch version without annotation\n\n```bash\n$ versiontag --force patch\n```\nMinor version with message option\n\n```bash\n$ versiontag minor --message 'Add Customer filter by email'\n```\n\nMajor version\n\n```bash\n$ versiontag major -m 'Blog module'\n```\n\nRemove last tag\n\n```bash\n$ versiontag remove\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraniglesias%2Fversiontag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffraniglesias%2Fversiontag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraniglesias%2Fversiontag/lists"}