Metadata-Version: 1.1
Name: taskotron-python-versions
Version: 0.1.dev3
Summary: Taskotron checks regarding Python versions
Home-page: https://github.com/fedora-python/taskotron-python-versions
Author: Miro Hrončok, Iryna Shcherbina, Michal Cyprian
Author-email: mhroncok@redhat.com, ishcherb@redhat.com, mcyprian@redhat.com
License: Public Domain
Description-Content-Type: UNKNOWN
Description: `Taskotron <https://fedoraproject.org/wiki/Taskotron>`__ task 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 uses versioned shebangs in its executables;
        
        -  Whether the package supports Python 3 upstream but not in the package.
        
        
        Running
        -------
        
        You can run the checks locally with
        `Taskotron <https://fedoraproject.org/wiki/Taskotron>`__. First,
        install it (you can
        follow the
        `Quickstart <https://qa.fedoraproject.org/docs/libtaskotron/latest/quickstart.html>`__).
        You'll also need the ``rpm``, ``dnf`` and ``libarchive-c`` Python 2 modules
        (``python2-rpm``, ``python2-dnf``, ``python2-libarchive-c``).
        Note that Taskotron unfortunately runs on Python 2, but the code in
        this repository is Python 3 compatible as well.
        
        Once everything is installed you can run the task on a Koji build
        using the
        ``name-(epoch:)version-release`` (``nevr``) identifier.
        
        .. code:: console
        
            $ runtask -i <nevr> -t koji_build runtask.yml
        
        For example:
        
        .. code:: console
        
            $ runtask -i eric-6.1.6-2.fc25 -t koji_build runtask.yml
        
        Tests
        -----
        
        There are also automatic tests available. You can run them using
        `tox <https://tox.readthedocs.io/>`__.
        You'll need the above mentioned dependencies and ``python3-rpm``
        and ``python3-dnf`` installed as well.
        
        .. code:: console
        
            $ tox
        
        Automatic tests also happen on `Tarvis
        CI <https://travis-ci.org/fedora-python/taskotron-python-versions/>`__.
        Since Travis CI runs on Ubuntu
        and Ubuntu lacks the RPM Python bindings and Taskotron,
        `Docker <https://docs.travis-ci.com/user/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 <https://creativecommons.org/publicdomain/zero/1.0/>`__,
        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 <https://koji.fedoraproject.org/koji/>`__ by searching the
        package name and selecting the appropriate version.
        
Keywords: taskotron fedora python rpm
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
