-
Notifications
You must be signed in to change notification settings - Fork 3
/
README.txt
83 lines (50 loc) · 1.81 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
setuptools_trial Manual
=======================
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 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
-----
To use this plugin, you must first package your python module with
`setup.py` and use setuptools. The former is well documented in the
distutils manual:
http://docs.python.org/dist/dist.html
To use setuptools instead of distutils, just edit `setup.py` and
change
from distutils.core import setup
to
from setuptools import setup
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.py:
[aliases]
test = trial
See also the output of "python ./setup.py trial --help" for usage
options.
References
----------
How to distribute Python modules with Distutils:
http://docs.python.org/dist/dist.html
Setuptools complete manual:
http://peak.telecommunity.com/DevCenter/setuptools
Thanks to Yannick Gingras for providing the prototype for this
README.txt.