.. _citkversionupdater:


Citk Version Updater
=====================

This script is partly used by the release script and helps to upgrade project tags and versions in the citk project and distribution files.

+--------------+----------------------------------------------------------------------------------+
|**bin**       |``citk-version-updater``                                                           |
+--------------+----------------------------------------------------------------------------------+
|**help**      |``citk-version-updater --help``                                                    |
+--------------+----------------------------------------------------------------------------------+
|**repository**|``https://github.com/csra/citk-version-updater.git``                               |
+--------------+----------------------------------------------------------------------------------+

**How to upgrade tags within the project description**

.. code-block:: bash

    $ citk-version-updater --citk ~/workspace/csra/citk --project jul
    cache repo https://github.com/openbase/jul.git into /tmp/divine/jul
    tags[0] of project jul updated in /home/divine/workspace/csra/citk/projects/jul.project!
    skip project upgrade within distribution because no distribution was defined!


**How to upgrade tags within the project description and setup latest release in distribution description.**

.. code-block:: bash

    $ citk-version-updater --citk ~/workspace/csra/citk --project jul --distribution lsp-csra-0.12
    cache repo https://github.com/openbase/jul.git into /tmp/divine/jul
    tags[0] of project jul updated in /home/divine/workspace/csra/citk/projects/jul.project!
    upgrade jul version from v1.0.0-beta to v1.1.1-beta