A macro to declare the VERSION constant from the value found in shard.yml versioning
1.2.5 Latest release released

Build Status

Version From Shard

A macro to declare the VERSION constant from the value found in shard.yml, so you don't need to write the same version number in multiple places.


  1. Add the dependency to your shard.yml:

        github: hugopl/version_from_shard
  2. Run shards install


require "version_from_shard"

module MyAwesomeApp

puts MyAwesomeApp::VERSION # Should print the version value found in shard.yml, e.g. "1.0.0"

If you are developing a library is necessary to pass __DIR__ to the declare macro, otherwise when compiling a application using your library it will show the version of the application instead the version of your library. So, on libraries do:

module MyAwesomeLib

# Then, the App code can safely do:
puts "Awesome app v#{MyAwesomeApp::VERSION} using awesome lib v#{MyAwesomeLib::VERSION}"

When compiling a development version, i.e. not a tagged commit, the version will try to use git describe --tags output (ignoring tag prefixes) for the version string. If git isn't found or someone is compiling the project from a tarball, normal version will be used.


You have version: 1.0.0 on your shard.yml file but your master branch is 1 commit ahead of the tag named v1.0.0 that you released yesterday, in this case VersionFromShard.declare will declare a VERSION constant with the value 1.0.0+1.g2dd5299, assuming 2dd5299 is the current commit hash, note the g prefix, that means git.

About Semantic Version

This issue summarize the problems with semantic version and nightly builds when you don't know yet if the final version of your software will increase a major, minor or patch version.


Suggestions are welcome.


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


  github: hugopl/version_from_shard
  version: ~> 1.2.5
License MIT
Crystal >= 0.36.1


Dependencies 0

Development Dependencies 0

Dependents 4

Other repos 1

Last synced .
search fire star recently