README

   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