RETIRED, further work has moved to Debian project infrastructure
Go to file
Jonathan Lange 52b5d19191 UTF-8 encode Twisted logs (allenap) 2016-04-30 09:50:10 +01:00
doc Correct docs for skip deprecation 2016-04-12 19:19:33 -05:00
scripts Fix automation harder. 2014-01-29 23:03:43 +13:00
testtools UTF-8 encode Twisted logs (allenap) 2016-04-30 09:50:10 +01:00
.gitignore Switch to pbr as a build system 2015-05-05 11:18:00 +12:00
.gitreview Setup gerrit metadata. 2013-09-05 09:01:17 +12:00
.testr.conf Revert back to explicit test identification. 2014-08-22 05:18:23 +12:00
.travis.yml Drop support for Python 2.6 and 3.2 2016-01-25 16:43:44 +00:00
LICENSE Add matchers for detecting emitted warnings. 2016-03-16 08:26:26 +13:00
MANIFEST.in Switch to pbr as a build system 2015-05-05 11:18:00 +12:00
Makefile We now publish wheels of testtools. 2014-10-31 14:57:34 +13:00
NEWS Use inlineCallbacks instead of deferredGenerator 2016-04-27 10:31:51 +01:00
README.rst Add matchers for detecting emitted warnings. 2016-03-16 08:26:26 +13:00
readthedocs-requirements.txt Use non-inplace install and add a comment 2016-01-10 10:52:37 +00:00
requirements.txt Revert usage of pyrsistent 2016-03-04 09:56:59 +01:00
setup.cfg Decouple log handling from Deferred wrangling 2016-01-29 09:56:50 +00:00
setup.py Switch to pbr as a build system 2015-05-05 11:18:00 +12:00

README.rst

testtools

testtools is a set of extensions to the Python standard library's unit testing framework.

These extensions have been derived from years of experience with unit testing in Python and come from many different sources.

Documentation

If you would like to learn more about testtools, consult our documentation in the 'doc/' directory. You might like to start at 'doc/overview.rst' or 'doc/for-test-authors.rst'.

Licensing

This project is distributed under the MIT license and copyright is owned by Jonathan M. Lange and the testtools authors. See LICENSE for details.

Some code in 'testtools/run.py' is taken from Python's unittest module, and is copyright Steve Purcell and the Python Software Foundation, it is distributed under the same license as Python, see LICENSE for details.

Supported platforms

  • Python 2.7+ or 3.3+ / pypy (2.x+)

If you would like to use testtools for earlier Pythons, please use testtools 1.9.0, or for really old Pythons, testtools 0.9.15.

testtools probably works on all OSes that Python works on, but is most heavily tested on Linux and OS X.

Optional Dependencies

If you would like to use our Twisted support, then you will need Twisted.

If you want to use fixtures then you can either install fixtures (e.g. from https://launchpad.net/python-fixtures or http://pypi.python.org/pypi/fixtures) or alternatively just make sure your fixture objects obey the same protocol.

Bug reports and patches

Please report bugs using Launchpad at <https://bugs.launchpad.net/testtools>. Patches should be submitted as Github pull requests, or mailed to the authors. See doc/hacking.rst for more details.

There's no mailing list for this project yet, however the testing-in-python mailing list may be a useful resource:

History

testtools used to be called 'pyunit3k'. The name was changed to avoid conflating the library with the Python 3.0 release (commonly referred to as 'py3k').

Thanks

  • Canonical Ltd
  • Bazaar
  • Twisted Matrix Labs
  • Robert Collins
  • Andrew Bennetts
  • Benjamin Peterson
  • Jamu Kakar
  • James Westby
  • Martin [gz]
  • Michael Hudson-Doyle
  • Aaron Bentley
  • Christian Kampka
  • Gavin Panella
  • Martin Pool
  • Julia Varlamova
  • ClusterHQ Ltd
  • Tristan Seligmann
  • Jonathan Jacobs