Features

• Extract the value from a version field inside any Python file

Documentation

Documentation sources are included with the project, and used to generate the documentation sites:

• The latest docs are always generated for the latest release, kept in the ‘master’ branch

• The development docs are generated from the latest code in the ‘develop’ branch

You can also create the documentation from the source files, kept in the ‘docs’ folder, with the help of Sphinx. For this use the makefile, or the make.bat file, contained on that folder.

Usage

Just import and use the function:

from version_extractor import extract_version

version = extract_version('tests/resources/__init__.py')

Or use a preconfigured function:

from version_extractor import extract_version_init

version = extract_version_init('tests/resources')

This is useful when setting up a setup.py file:

setup(
    ...
    version=extract_version_init(_source_package),
    ...
)

Testing

The tests included with the project can be run with:

$ python setup.py test

This will delegate the execution to tox.

It is possible to run just one of the test profiles, in this case the py36 profile:

$ python setup.py test -p "py36"

Collaborate

Any kind of help with the project will be well received, and there are two main ways to give such help:

• Reporting errors and asking for extensions through the issues management

• or forking the repository and extending the project

License

The project has been released under the MIT License.