{"id":43822673,"url":"https://github.com/RiotGamesMinions/thor-scmversion","last_synced_at":"2026-02-17T15:00:58.430Z","repository":{"id":3715227,"uuid":"4787273","full_name":"RiotGamesMinions/thor-scmversion","owner":"RiotGamesMinions","description":"Thor tasks to manage a VERSION file based on SCM tags","archived":false,"fork":false,"pushed_at":"2016-05-26T18:27:22.000Z","size":162,"stargazers_count":58,"open_issues_count":21,"forks_count":22,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-03-26T05:23:33.470Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/RiotGamesMinions.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":"2012-06-25T20:52:16.000Z","updated_at":"2023-09-05T04:30:17.000Z","dependencies_parsed_at":"2022-09-16T02:24:35.420Z","dependency_job_id":null,"html_url":"https://github.com/RiotGamesMinions/thor-scmversion","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/RiotGamesMinions/thor-scmversion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiotGamesMinions%2Fthor-scmversion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiotGamesMinions%2Fthor-scmversion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiotGamesMinions%2Fthor-scmversion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiotGamesMinions%2Fthor-scmversion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RiotGamesMinions","download_url":"https://codeload.github.com/RiotGamesMinions/thor-scmversion/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiotGamesMinions%2Fthor-scmversion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29548201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T14:33:00.708Z","status":"ssl_error","status_checked_at":"2026-02-17T14:32:58.657Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":[],"created_at":"2026-02-06T02:00:29.838Z","updated_at":"2026-02-17T15:00:58.424Z","avatar_url":"https://github.com/RiotGamesMinions.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"## NOTE\n\nThis project is not under active development. If it isn't working, please check https://github.com/RiotGamesMinions/thor-scmversion/issues/39 and see if that is your problem, too.\n\nYou may also want to look at https://github.com/Atalanta/knife-cookbook-bump and see if it meets your needs.\n\n\n# Thor::SCMVersion\n\nThor tasks to manage a VERSION file based on SCM tags, for use in\ncontinuous delivery pipelines.\n\nOne of the key points of continuous delivery is that every build has a\nversion number, and that version number is unique and only points to\none build. Thor::SCMVersion adds some tasks to a Thorfile to use SCM\ntags as the authoritative source of version status, so your continuous\nintegration server can create versions without having to worry about\nfile conflicts.\n\n## Integrating into your project\n\nSince Thor is written in Ruby, you'll need Ruby to make this work, on\nyour workstation and on your CI server. See \u003chttp://whatisthor.com/\u003e for\nmore in how to use Thor.\n\n### Get the gem\n\nIf you don't already have a Gemfile, you should probably get one. See\n\u003chttp://gembundler.com/\u003e for more details on Bundler and Gemfiles. Not\nrequired, but will save you a lot of hassle.\n\nAdd this line to your application's Gemfile:\n\n    gem 'thor-scmversion'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install thor-scmversion\n\n### Add it to your Thorfile\n\nAll you need to do is require it at the top of your Thorfile:\n\n    require 'thor/scmversion'\n\nNow when you list your thor tasks you'll see 2 new ones.\n\n    $ thor list\n    \n    version\n    -------\n    thor version:bump TYPE [PRERELEASE_TYPE]  # Bump version number (type is major, minor, patch, prerelease or auto)\n                                              # Prerelease allows an additional parameter to be passed which is used \n                                              # as the prerelease type.\n    thor version:current    # Show current SCM tagged version\n\nUsage Examples:\n\n    $ thor version:current\n    1.2.1\n    $ thor version:bump auto\n    1.2.2\n    $ thor version:bump major\n    2.0.0\n    $ thor version:bump prerelease\n    2.0.1-alpha.1\n    $ thor version:bump prerelease\n    2.0.1-alpha.2\n    $ thor version:bump prerelease beta\n    2.0.1-beta.1\n    $ thor version:bump minor\n    2.1.0\n\n### Remove your VERSION file from source control\n\nSince your CI server will be managing your VERSION file, you don't\nwant it to be stored in your SCM anymore. Make a note of your current\nversion, then\n\n    $ git rm VERSION\n    $ echo VERSION \u003e\u003e .gitignore`\n    $ git add .gitignore\n    $ git commit -m \"Drop VERSION as it is managed by thor-scmversion now\"\n\n### Create a tag for the current version\n\nNow tag the current version manually. If it was 1.2.3:\n\n    $ git tag 1.2.3\n    $ git push --tags\n\nYou can make sure it worked by running `thor version:current` and\nmaking sure it is what you expected.\n\n### Integrate with CI\n\nNow, as part of your CI job, before it builds your artifacts, have it\nrun `thor version:bump patch`. This will increment the patch, push the\nnew tag, and write the VERSION file. Now the artifact you build will\nhave the right version information, every time.\n\n### You manage the major, minor patch and prerelease\n\nWhen you make significant changes, you can bump the major, minor or patch\nnumber yourself with `thor version:bump minor`. This will create a tag\nwith a .0 patch level, so the next build made by the server will be\n.1 patch level.\n\n### Auto bumping\n\nIf you include #major, #minor or #patch in the subject of commits, and run\n`thor version:bump auto` it will see if any major, minor or patch level changes\nare included since the last tag, and use the appropriate version. This works\nespecially well with a CI server, allowing you to never have to directly\nmanage versions at all. If no commits are tagged, the build number for the\ncurrent version will be bumped instead.\n\nNOTE: auto bumping currently only works for Git repos. For Perforce repos,\nauto is the same as build.\n\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Added some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n## Contributors\n\n* Michael Ivey \u003civey@gweezlebur.com\u003e\n* Kyle Allan \u003ckallan@riotgames.com\u003e\n* Josiah Kiehl \u003cjosiah@skirmisher.net\u003e\n* Based on code developed by Jamie Winsor \u003cjamie@vialstudios.com\u003e\n* Originally derived from some Bundler internals by Yehuda Katz\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRiotGamesMinions%2Fthor-scmversion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRiotGamesMinions%2Fthor-scmversion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRiotGamesMinions%2Fthor-scmversion/lists"}