New feature: Version Tags

Biicode is not a Version Control System, neither a Source Code Management System. As a dependency manager, biicode makes “some kind” of internal version control to establish dependencies against a specific version of the block.

Our versions are incremental integers starting on 0. Until now,  to know that biicode’s version corresponds to any official version you had to look for it on the block’s description or readme.

Now you can tag a version while publishing. For example, qiangwu/atlstl corresponds to the official “1.9.98” version:

Version tags now available in biicode 2.0

Using Version Tags

Let’s say you’re publishing a new version into biicode and you’re looking for a way to relate this version number to your SCM versions or your library’s official version release. Today, I’m tagging OSCPack library version 3 to the official release version 1.1.0:

OSCPack example of a version tag

That’s the basics.

Version Tags Utilities

Publish a new version with its tag:

Version tags, as seen in this other example, can now be implemented in biicode

Semantic Versioning

A versioning policy is just some simple rules specifying how to use version numbers. It can be very simple like the one biicode makes by default or more complex.

We encourage you developers to follow the Semantic Versioning standard for your block’s versions. Be mindful that  using a “non-rational” policy will be a disservice for those using your blocks.

Depending with Version Tags

To use a version based on a tag instead of biicode internal version number, write in [requirements] section in your biicode.conf:

And whenever you build your project, biicode will discover biicode version and update your [requirements] section in your biicode.conf:

Not to confuse them with Tags

Add tags and a description to your block, this is useful for other users and will be indexed better for our Search Engine.

Do not confuse version tags with tags

Just select settings and start writing and adding tags!

Hope you enjoy this post, and as always, we look forward to hear what you think. Just click on the sidebar button to try biicode and check our docs, forum, Stackoverflow tag for questions and answers.


Related Posts