Skip to main content

setuptools command for running tests using tox

Project description

Command for running tox tests with setuptools.

This way the usual command for running tests will call tox:

python setup.py test

To achieve this the project should be using setuptools, and contain a setup.py file, where the test command will be overriden.

This is detailed in the usage section.

tox Test Command Pypi package page tox Test Command latest documentation Status tox Test Command development documentation Status

Features

  • Running test with tox in any project using setuptools

  • Running a specific tox profile

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.

Prerequisites

The project has been tested in the following versions of the interpreter:

  • Python 3.4

  • Python 3.5

  • Python 3.6

  • Pypy 3

All other dependencies are indicated on the requirements.txt file.

These can be installed with:

pip install –upgrade -r requirements.txt

Installing

The project is offered as a Pypi package, and using pip is the preferred way to install it. For this use the following command;

pip install bernardomg.tox-test-command

If needed, manual installation is possible:

python setup.py install

Usage

The application has been coded in Python, and is meant for projects using setuptools.

It can be used to override the default test command with ease:

from tox_test_command import ToxTestCommand

setup(
    ...
    cmdclass={'test': ToxTestCommand},
    ...
)

This way the usual command for running tests will call the new command:

python setup.py test

It is possible to run a specific tox profile:

python setup.py test -p [profile-name]

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

Issues management

Issues are managed at the GitHub project issues tracker, where any Github user may report bugs or ask for new features.

Getting the code

If you wish to fork or modify the code, visit the GitHub project page, where the latest versions are always kept. Check the ‘master’ branch for the latest release, and the ‘develop’ for the current, and stable, development version.

License

The project has been released under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bernardomg.tox-test-command-1.2.0.tar.gz (11.4 kB view details)

Uploaded Source

Built Distribution

bernardomg.tox_test_command-1.2.0-py2.py3-none-any.whl (4.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file bernardomg.tox-test-command-1.2.0.tar.gz.

File metadata

  • Download URL: bernardomg.tox-test-command-1.2.0.tar.gz
  • Upload date:
  • Size: 11.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.9.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for bernardomg.tox-test-command-1.2.0.tar.gz
Algorithm Hash digest
SHA256 e302c764c516c19c0b844031281c29ee824df9510d5fd4e7c177c64e5ee3996a
MD5 12c7b4bcb51c5096a647d57de7f4ce3c
BLAKE2b-256 a43a11a9fd97faab31712d255d510e64c1c587ac76cd8d8ec0f50710cbefd61f

See more details on using hashes here.

File details

Details for the file bernardomg.tox_test_command-1.2.0-py2.py3-none-any.whl.

File metadata

  • Download URL: bernardomg.tox_test_command-1.2.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.9.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for bernardomg.tox_test_command-1.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b7c51f3a3afb21a8cbc5d3eafd67e4acf1af7b3bd8a51ef66a771a3a2824429f
MD5 f49f79982ef744347bdb0a2726df78ea
BLAKE2b-256 9c51f5fb144b03cc8b5ae5f98295975cf93ed35b02ba43bd015d00e660367af8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page