This script provides a simple interface around viewing and manipulating project version metadata. It may be used to either bump, set, or view the version information for the project in a given directory. It is written with semantic versioning in mind.
It currently does it's best to determine whether the given directory contains a NodeJS, Erlang, Chef Cookbook, or Ansible project before just settling on keeping the version in a file named version
. If a NodeJS project is discovered then the package.json
will be edited. If an Ansible project is discovered then no files will be modified but the tags will still be handled. The Erlang detection is limited to OTP apps, and avakas
will attempt to edit a rebar style foo.app.src
. If a Chef Cookbook is discovered then avakas
will attempt to modify the version
attribute in metadata.rb
.
The avakas tool makes a few assumptions
- There is only one logical project in each directory.
- The directory is somewhere in a git repository. You can have multiple projects per repository by using the
--tag-prefix
option. - For the protection of the user the git workspace must not be dirty.
The avakas tool supports the following types of version files
- NodeJS
package.json
- Erlang/OTP and rebar
foo.app.src
- Chef Cookbook
metadata.rb
- Plain ol'
version
file
This mode will return the current version for a given project. The following will show the current Public API version. This operation supports an additional --build
argument, which will cause it to extend the version set in source control with build-time metadata. It also supports the --pre-build
argument, which does the same thing on top of the prerelease field, because all kinds of package management systems do not actually support the build semantic version component.
It is possible to override this default pre-build
behavior. The --pre-build-date
option will include the current date (down to the second) as a string. The --pre-build-prefix=foo
option will include a string prefix. It is possible to include both pre-build and build information, but only if you specify a prefix or include the date in prebuild.
avakas show $HOME/projects/hal9000
This mode will set an explicit version. Note that the string must be a valid semantic version.
avakas set $HOME/projects/hal9000 2.0.0
This mode will automatically update the version based on the input provided. It has four modes of operation.
major
will update the major (left) version component.minor
will update the minor (middle) version component.patch
will update the patch (right) version component.pre
will update the prerelease (to the right, separated by a-
)auto
will attempt to determine which component to adjust
When the auto
option is selected, the system will use hints in the git log since the last version bump to determine if the version should be changed. These hints can be specified at any point in the commit message. The hints are specified, prefixed by bump:
. For example, the following commit message would result in a minor version bump if it is subsequently "autobumped".
$ avakas show .
0.0.1
$ git commit -am "hello this is a release\nbump:minor"
$ avakas bump . auto
Version updated from 0.0.1 to 0.1.0
This will result in nothing being pushed to upstream git sources.
The branch to use when updating git.
The remote to push tags and version updates.
This prefix will be added to the version string when creating a git tag.
You can use avakas
as a Docker container as well. It supports either static SSH keys or the SSH Agent. It seems like the SSH agent only works on Linux though. The Docker entrypoint should setup your SSH environment on the set
and bump
avakas
actions.
You can map a folder to /etc/avakas
for static SSH or Git environment configuration. If the file avakasrc
is present in /etc/avakas
it will be sourced prior to running avakas
. A common use case here is to export the GIT_AUTHOR_NAME
and GIT_AUTHOR_EMAIL
environment variables.
In all cases, you will want to map a source project into a folder and point avakas
at it. The following example (running on Linux with SSH Agent forwarding) would bump the patch portion of the version in the current directory.
$ docker run -t -v $(pwd):/app -v $SSH_AUTH_SOCK:/ssh-agent -e SSH_AUTH_SOCK=/ssh-agent otakup0pe/avakas bump /app patch
The next example (running on OSX) would set the version explicitly in the current directory. Note how we need to setup a working folder to map /etc/avakas
against.
$ mkdir -p /tmp/ssh-avakas-working
$ cp ~/.ssh/id_rsa /tmp/ssh-avakas-working
$ docker run -v $(pwd):/app -v /tmp/ssh-avakas-working:/etc/avakas otakup0pe/avakas set /app 0.0.1
The avakas tool was created by Jonathan Freedman.