setuptools_trial
About
This is a plugin for setuptools that integrates Twisted trial. Once installed, "python ./setup.py trial" will run the package's unit tests using Twisted trial. The package can also optionally be configured so that "python ./setup.py test" will use Twisted trial instead of pyunit a.k.a. unittest.
Installation
With pip
:
pip install setuptools_trial
or with easy_install
:
easy_install setuptools_trial
Alternative manual installation:
tar -zxvf setuptools_trial-X.Y.Z.tar.gz
cd setuptools_trial-X.Y.Z
python setup.py install
Where X.Y.Z
is a version number.
Alternative to make a specific package use setuptools_trial without installing setuptools_trial into the system:
Put setup_requires=['setuptools_trial']
in the call to setup()
in
the package's setup.py
file.
Usage
Once setuptools_trial is installed (either into the system or just for
the current package), then python ./setup.py trial
will run trial on
the package.
You can then make python ./setup.py test
use trial instead of pyunit
(unittest) by adding the following stanza to your project's setup.cfg
:
[aliases]
test = trial
See also the output of python ./setup.py trial --help
for usage
options.
References
To learn more about Python modules packaging visit https://www.pypa.io/en/latest/.
Thanks to Yannick Gingras for providing the prototype for this
README.rst
.