Versionix
###########
.. image:: https://badge.fury.io/py/versionix.svg
:target: https://pypi.python.org/pypi/versionix
.. image:: https://github.com/sequana/versionix/actions/workflows/main.yml/badge.svg
:target: https://github.com/sequana/versionix/actions/workflows/main.yml
.. image:: https://coveralls.io/repos/github/sequana/versionix/badge.svg?branch=main
:target: https://coveralls.io/github/sequana/versionix?branch=main
.. image:: https://zenodo.org/badge/658721856.svg
:target: https://zenodo.org/badge/latestdoi/658721856
:Python version: Python 3.8, 3.9, 3.10, 3.11
:Source: See `http://github.com/sequana/versionix <https://github.com/sequana/versionix/>`__.
:Issues: Please fill a report on `github <https://github.com/sequana/versionix/issues>`__
Overview
========
Versionix is a simple tool that attemps to print on screen the version of a given standalone.
Installation
----------------
If you are in a hurry, just type::
pip install versionix --upgrade
This is pure Python so no need for fancy libraries.
Usage
-----
Then, just type e.g::
versionix fastqc
This tool uses a registry so it will work only with resgistered tools, which list can be obtained with::
versionix --registered
Type::
versionix --help
to get more help like this example:
.. image:: doc/versionix_usage.png
DESCRIPTION
===========
The first difficulty is that standalone applications have different ways to obtain their version information. Some require the use of a long or short argument (--version or -v), while others do not require any argument at all. In addition, display channels (stdout or stderr) and formats of the version output differs between applications. To handle these various cases, we define a dictionnary of **metadata** related to the different standalones. These metadata helps in the identification of the command to run, the options to use, if the information is directed to stdout or stderr and the method to parse the output to obtain the version number.
Versionix is designed to be used with all Sequana pipelines and is not intended to be universal. It will only work for tools that are registered. You can add your own standalone version in the versionix/register.py file and provide a Pull Request.
Changelog
=========
========= ========================================================================
Version Description
========= ========================================================================
0.2.3 More tools in the registry
0.2.2 add all tools required by sequana pipelines (oct 2023)
0.2.1 More tools added.
0.2 simplification. Add tests. Add more tools
0.1 first draft
========= ========================================================================
Raw data
{
"_id": null,
"home_page": "https://github.com/sequana/versionix",
"name": "versionix",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "versioning,bioinformatics",
"author": "Sequana Team",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/02/99/5a7b1c749a3e9a89b3dfc863f7ffbd1d345050004395808f2862e9adcf72/versionix-0.2.3.tar.gz",
"platform": null,
"description": "Versionix\n###########\n\n\n.. image:: https://badge.fury.io/py/versionix.svg\n :target: https://pypi.python.org/pypi/versionix\n\n\n.. image:: https://github.com/sequana/versionix/actions/workflows/main.yml/badge.svg\n :target: https://github.com/sequana/versionix/actions/workflows/main.yml\n\n.. image:: https://coveralls.io/repos/github/sequana/versionix/badge.svg?branch=main\n :target: https://coveralls.io/github/sequana/versionix?branch=main\n\n.. image:: https://zenodo.org/badge/658721856.svg\n :target: https://zenodo.org/badge/latestdoi/658721856\n\n:Python version: Python 3.8, 3.9, 3.10, 3.11\n:Source: See `http://github.com/sequana/versionix <https://github.com/sequana/versionix/>`__.\n:Issues: Please fill a report on `github <https://github.com/sequana/versionix/issues>`__\n\nOverview\n========\n\nVersionix is a simple tool that attemps to print on screen the version of a given standalone.\n\nInstallation\n----------------\n\nIf you are in a hurry, just type::\n\n pip install versionix --upgrade\n\nThis is pure Python so no need for fancy libraries.\n\nUsage\n-----\n\nThen, just type e.g::\n\n versionix fastqc\n\nThis tool uses a registry so it will work only with resgistered tools, which list can be obtained with::\n\n versionix --registered\n\nType::\n\n versionix --help \n\nto get more help like this example:\n\n.. image:: doc/versionix_usage.png\n\n\nDESCRIPTION\n===========\n\n\nThe first difficulty is that standalone applications have different ways to obtain their version information. Some require the use of a long or short argument (--version or -v), while others do not require any argument at all. In addition, display channels (stdout or stderr) and formats of the version output differs between applications. To handle these various cases, we define a dictionnary of **metadata** related to the different standalones. These metadata helps in the identification of the command to run, the options to use, if the information is directed to stdout or stderr and the method to parse the output to obtain the version number.\n\nVersionix is designed to be used with all Sequana pipelines and is not intended to be universal. It will only work for tools that are registered. You can add your own standalone version in the versionix/register.py file and provide a Pull Request.\n\nChangelog\n=========\n\n========= ========================================================================\nVersion Description\n========= ========================================================================\n0.2.3 More tools in the registry\n0.2.2 add all tools required by sequana pipelines (oct 2023)\n0.2.1 More tools added.\n0.2 simplification. Add tests. Add more tools\n0.1 first draft\n========= ========================================================================\n",
"bugtrack_url": null,
"license": "BSD-3",
"summary": "Get version of any tools",
"version": "0.2.3",
"project_urls": {
"Homepage": "https://github.com/sequana/versionix",
"Repository": "https://github.com/sequana/versionix"
},
"split_keywords": [
"versioning",
"bioinformatics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "995daf234bb6ed6ada556d4e7ae73bc9aaa958d69af618929886e9af73a716e4",
"md5": "ccb5be28789ae20b88db4735bdbe3539",
"sha256": "40ef836474f79830a42f0ae16669f2146fe6addb86e090ec74653f493b25bb1e"
},
"downloads": -1,
"filename": "versionix-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccb5be28789ae20b88db4735bdbe3539",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 7405,
"upload_time": "2023-11-26T15:24:44",
"upload_time_iso_8601": "2023-11-26T15:24:44.550479Z",
"url": "https://files.pythonhosted.org/packages/99/5d/af234bb6ed6ada556d4e7ae73bc9aaa958d69af618929886e9af73a716e4/versionix-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "02995a7b1c749a3e9a89b3dfc863f7ffbd1d345050004395808f2862e9adcf72",
"md5": "cfbe7837d31c02380cfd11686a10c8ed",
"sha256": "b8a83f09615ffb233115d64cbb42a193a187f62ce9f8769d3900cfbcc2e085c1"
},
"downloads": -1,
"filename": "versionix-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "cfbe7837d31c02380cfd11686a10c8ed",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 6434,
"upload_time": "2023-11-26T15:24:46",
"upload_time_iso_8601": "2023-11-26T15:24:46.369444Z",
"url": "https://files.pythonhosted.org/packages/02/99/5a7b1c749a3e9a89b3dfc863f7ffbd1d345050004395808f2862e9adcf72/versionix-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-26 15:24:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sequana",
"github_project": "versionix",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "versionix"
}