versipy v0.2.4.post1

---

Versatile version and medatada managment across the python packaging ecosystem with git integration

---

Summary

versipy is a versatile tool to centrally manage the package metadata and its version following the PEP 440 version specification. versipy propagates metadata values from a YAML file to target files specified by the user such as the setup.py, __init__.py, meta.yaml and README files. To do so it uses a simple string replacement strategy using templates files defined by the user containing placeholder values. In addition, versipy is able to automatically add, commit and push the modified files to a remote git repository and set a remote version tag.

Installation

Ideally, before installation, create a clean python3.6+ virtual environment to deploy the package. Earlier version of Python3 should also work but Python 2 is not supported. For example with conda:

bash conda create -n versipy python=3.6 conda activate versipy

Install or upgrade the package with pip from pypi

```bash

Install

pip install versipy

Update

pip install versipy --update ```

Install or upgrade the package with conda from Anacounda cloud

```bash

Install

conda install -c aleg -c anaconda -c bioconda -c conda-forge versipy=[VERSION]

Update

conda update -c aleg -c anaconda -c bioconda -c conda-forge versipy ```

Dependencies

The following dependencies are required but automatically installed with pip or conda package manager

• colorlog>=4.1.0
• pyyaml>=5.3.1
• gitpython>=3.1.9

Usage

Setting up your repository requires a bit of manual work but afterwards a single command can bumpup the version and propagate it to several python packaging ecosystem files including the setup.py, `init_.py,meta.yamland READMEfiles.versipy` can also optionally commit and push the changes to a remote git repository and set a git tag.

Setting up your repository

• Open a terminal in the root directory of the (git managed) code repository you want to use with versipy

• Create a template versipy YAML file

bash versipy init_repo

You should now be able to see 2 new files: versipy.yaml which will contain all the repository metadata and versipy_history.txt where versipy will keep a track of the version changes history.

The versipy.yaml file

Example file

• version section

This section contains individual numbers for each sections of the full version number. Although it can be manually modified, this is supposed to be managed directly via the command line with the set_version and bump_up_version subcommands.

• managed_values section

key:value fields corresponding to a placeholder key to be found in template managed files and the corresponding replacement value that can be customized. Users can add as many extra entries and they wish. It is recommended to define explicit descriptive keys and to use the python double underscore syntax to avoid replacing random words in the code

• managed_files section

key:value fields corresponding to the path of a template file containing placeholder keys as defined in the previous section and the corresponding destination path where to write a file containing the replacement values.

Bump up or set the version number

The version number can be easily incremented using bump_up_version according to the level selected by users following the PEP 440 version specification as defined above. Several levels can be incremented at once, but lower levels are always reset to 0 (or discarded for a, b, rc, post and dev). For example if incrementing the minor level, the micro is set to 0 and the alpha, beta, rc, post and dev levels are discarded if they were previously set.

```bash

Bumping up minor level version

versipy bumpupversion --minor

Bumping up minor and setting the dev level to 1

versipy bumpupversion --minor --dev

Bumping up post level + publish changes to a remote git branch

versipy bumpupversion --post --git_push

Bumping up major version + publish changes to a remote git branch + create a git tag and use a custom comment

versipy bumpupversion --major --gitpush --gittag --comment "Major version update" ```

If you want to jump to a different number, the required tag can be directly set by passing a specific value to set_version. An error will be raised if the version is not canonical.

bash versipy set_version --version_str "1.23rc1.post2"

Going further with continuous deployment

Used in combination with on tag continuous deployment, versipy provides a powerful toolset to greatly simplify package building and distribution. Here is an example YAML code snippet for Travis CI to auto-deploy a package upon tag publishing to PyPI, anaconda cloud and set a create Release

```yaml

dist: xenial language: python python: 3.6

install: true

script: true

deploy:

# Production version deployment - provider: pypi skipcleanup: true user: aleg password: "$PYPIPW" on: tags: true

• provider: script skipcleanup: true script: bash ./deployanaconda.sh $ANACONDA_TOKEN on: tags: true

• provider: releases apikey: $GITHUBTOKEN skip_cleanup: true on: tags: true ```

---

Classifiers

• Development Status :: 3 - Alpha
• Intended Audience :: Science/Research
• Topic :: Scientific/Engineering :: Bio-Informatics
• License :: OSI Approved :: GNU General Public License v3 (GPLv3)
• Programming Language :: Python :: 3

citation

Adrien Leger. (2020, October 27). a-slide/versipy 0.2.2 (Version 0.2.2). Zenodo. http://doi.org/10.5281/zenodo.4139248

licence

GPLv3 (https://www.gnu.org/licenses/gpl-3.0.en.html)

Copyright © 2020 Adrien Leger

Authors

• Adrien Leger / contact@adrienleger.com / https://adrienleger.com