taskotron-python-versions 0.1.dev6

Taskotron checks regarding Python versions

This represents the automatic checks happening in the Fedora infrastructure after any package is built.

Currently the following checks are available:

• Whether a package does not require Python 2 and Python 3 at the same time;

• Whether the package name follows the Python package naming scheme;

• Whether the package uses versioned Python prefix in requirements’ names;

• Whether only Python 2 version of the package contains the executables;

• Whether the package supports Python 3 upstream but not in the package;

• Whether the package requires /usr/bin/python (or python-unversioned-command).

Running

To run this task locally, execute the following command as root (don’t do this on a production machine!):

$ ansible-playbook tests.yml -e taskotron_item=<nevr>

where nevr is a Koji build name-(epoch:)version-release identifier.

For example:

$ ansible-playbook tests.yml -e taskotron_item=python-gear-0.11.0-1.fc27

You can see the results in ./artifacts/ directory.

You can also run the above in mock:

$ mock -r ./mock.cfg --init
$ mock -r ./mock.cfg --copyin taskotron_python_versions *.py tests.yml /
$ mock -r ./mock.cfg --shell 'ansible-playbook tests.yml -e taskotron_item=python-gear-0.11.0-1.fc27'
$ mock -r ./mock.cfg --copyout artifacts artifacts

Tests

This task is covered with functional and integration tests. You can run them using tox, but you will need mock, python3-rpm and python3-dnf installed. For mock configuration see mock setup instructions. Use the following command to run the test suite:

$ tox

The integration tests may take a while to execute, as they are running real tasks in mock. However, for development you may speed them up by reusing the results of the previous test run. This is useful if you modify the test itself, without changing the implementation of task checks. Use the following command to run integration tests in a fake mode:

$ tox -e integration -- --fake

The tests are also being executed on Travis CI. Since Travis CI runs on Ubuntu and Ubuntu lacks the RPM Python bindings and mock, Docker is used to run the tests on Fedora. You can run the tests in Docker as well, just use the commands from the .travis.yml file.

License

This code has been dedicated to the Public Domain, it is licensed with CC0 1.0 Universal Public Domain Dedication, full text of the license is available in the LICENSE file in this repository.

Please note that the RPM packages in this repository used for testing have their own license terms and are not dedicated to the Public Domain.

The sources of those packages can be found in Koji by searching the package name and selecting the appropriate version.