| 1 | =========
|
|---|
| 2 | testtools
|
|---|
| 3 | =========
|
|---|
| 4 |
|
|---|
| 5 | testtools is a set of extensions to the Python standard library's unit testing
|
|---|
| 6 | framework.
|
|---|
| 7 |
|
|---|
| 8 | These extensions have been derived from years of experience with unit testing
|
|---|
| 9 | in Python and come from many different sources.
|
|---|
| 10 |
|
|---|
| 11 | Licensing
|
|---|
| 12 | ---------
|
|---|
| 13 |
|
|---|
| 14 | This project is distributed under the MIT license and copyright is owned by
|
|---|
| 15 | Jonathan M. Lange. See LICENSE for details.
|
|---|
| 16 |
|
|---|
| 17 | Some code in testtools/run.py is taken from Python's unittest module, and
|
|---|
| 18 | is copyright Steve Purcell and the Python Software Foundation, it is
|
|---|
| 19 | distributed under the same license as Python, see LICENSE for details.
|
|---|
| 20 |
|
|---|
| 21 |
|
|---|
| 22 | Required Dependencies
|
|---|
| 23 | ---------------------
|
|---|
| 24 |
|
|---|
| 25 | * Python 2.4+ or 3.0+
|
|---|
| 26 |
|
|---|
| 27 | Optional Dependencies
|
|---|
| 28 | ---------------------
|
|---|
| 29 |
|
|---|
| 30 | If you would like to use our undocumented, unsupported Twisted support, then
|
|---|
| 31 | you will need Twisted.
|
|---|
| 32 |
|
|---|
| 33 | If you want to use ``fixtures`` then you can either install fixtures (e.g. from
|
|---|
| 34 | https://launchpad.net/python-fixtures or http://pypi.python.org/pypi/fixtures)
|
|---|
| 35 | or alternatively just make sure your fixture objects obey the same protocol.
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | Bug reports and patches
|
|---|
| 39 | -----------------------
|
|---|
| 40 |
|
|---|
| 41 | Please report bugs using Launchpad at <https://bugs.launchpad.net/testtools>.
|
|---|
| 42 | Patches can also be submitted via Launchpad, or mailed to the author. You can
|
|---|
| 43 | mail the author directly at jml@mumak.net.
|
|---|
| 44 |
|
|---|
| 45 | There's no mailing list for this project yet, however the testing-in-python
|
|---|
| 46 | mailing list may be a useful resource:
|
|---|
| 47 |
|
|---|
| 48 | * Address: testing-in-python@lists.idyll.org
|
|---|
| 49 | * Subscription link: http://lists.idyll.org/listinfo/testing-in-python
|
|---|
| 50 |
|
|---|
| 51 |
|
|---|
| 52 | History
|
|---|
| 53 | -------
|
|---|
| 54 |
|
|---|
| 55 | testtools used to be called 'pyunit3k'. The name was changed to avoid
|
|---|
| 56 | conflating the library with the Python 3.0 release (commonly referred to as
|
|---|
| 57 | 'py3k').
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | Thanks
|
|---|
| 61 | ------
|
|---|
| 62 |
|
|---|
| 63 | * Canonical Ltd
|
|---|
| 64 | * Bazaar
|
|---|
| 65 | * Twisted Matrix Labs
|
|---|
| 66 | * Robert Collins
|
|---|
| 67 | * Andrew Bennetts
|
|---|
| 68 | * Benjamin Peterson
|
|---|
| 69 | * Jamu Kakar
|
|---|
| 70 | * James Westby
|
|---|
| 71 | * Martin [gz]
|
|---|
| 72 | * Michael Hudson-Doyle
|
|---|
