Document changes to unit testing

ddale · ddale · commit 6917c5990e9d · 2011-02-15T09:31:12.000-05:00
diff --git a/CHANGES.txt b/CHANGES.txt
@@ -8,8 +8,18 @@ CHANGES
 
 The dalton has been added as an alias for the unified atomic mass
 unit, in response to the 2005 IUPAP report recognizing that both
-terms should be officially recognized. Da is recognized as the
-symbol for the dalton.
+terms should be officially recognized. Da is recognized as the symbol
+for the dalton.
+
+The test suite has been refactored to use the unittest package
+provided by the python-2.7 and python-3.2 standard library. With
+python-2.6 or python-3.{0,1}, unittest2 is required. The test suite
+is run with::
+
+   python setup.py test
+
+Quantities no longer requires or uses Distribute or Setuptools.
+
 
 -----
 0.9.0
diff --git a/doc/devel/devnotes.rst b/doc/devel/devnotes.rst
@@ -1,25 +1,12 @@
 Development
 ===========
 
-In order to work on quantities development, after installing the dependencies,
-it is recommended to do the following::
+Quantities development uses the principles of test-driven development. New
+features or bug fixes need to be accompanied by unit tests based on Python's
+unittest package. Unit tests can be run with the following::
 
-  python setup.py develop
+  python setup.py test
 
-This uses setuptools to install a link in your site-packages directory which
-points to your source directory. This allows you to make changes in the source
-directory without having to reinstall quantities. Note, however, that after 
-changing extension code, which needs to be compiled, you will need to run
-"python setup.py develop" again. Also note that executable scripts are copied
-to their install directory, rather than being linked, so you need to run
-"python setup.py develop" after editing scripts.
-
-Unit tests are collected by the nose package, and can be run with the following::
-
-  python setup.py nosetests --with-coverage --cover-package=quantities \
-  --cover-erase --cover-tests
-
-This assumes you have both nose_ and coverage_ installed on your system. 
-
-.. _nose: http://somethingaboutorange.com/mrl/projects/nose
-.. _coverage: http://nedbatchelder.com/code/modules/rees-coverage.html
+This works with the version of unittest provided by the python-2.7 and
+python-3.2 standard library. If you are running python-2.6 or python-3.1, you
+need to install unittest2 to run the test suite.
diff --git a/doc/user/installation.rst b/doc/user/installation.rst
@@ -9,17 +9,11 @@ Prerequisites
 Quantities has a few dependencies:
 
 * Python_ (>=2.6)
-* NumPy_ (>=1.3)
+* NumPy_ (>=1.4)
 
-in order to run the test suite, you will need:
+If you want to run the test suite on python-2.6 or python-3.1, install the
+unittest2_ or unittest2py3k_ package, respectively.
 
-* nose_
-
-The following are also suggested for anyone contributing to
-quantities:
-
-* distribute_ (>=0.6.10) or setuptools_ (=>0.6c11)
-* coverage_
 
 Source Code Installation
 ========================
@@ -32,17 +26,15 @@ Development
 
 You can follow and contribute to Quantities' development using git::
 
-  git clone git@github.com:darrendale/python-quantities.git
+  git clone git@github.com:python-quantities/python-quantities.git
 
 Bugs, feature requests, and questions can be directed to the github_
 website.
 
 
 .. _Python: http://www.python.org/
-.. _distribute: http://pypi.python.org/pypi/distribute
-.. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools
 .. _NumPy: http://www.scipy.org
-.. _nose: http://somethingaboutorange.com/mrl/projects/nose
-.. _coverage: http://nedbatchelder.com/code/modules/rees-coverage.html
 .. _PyPi: http://pypi.python.org/pypi/quantities
+.. _unittest2: http://pypi.python.org/pypi/unittest2
+.. _unittest2py3k: http://pypi.python.org/pypi/unittest2py3k
 .. _github: http://github.com/python-quantities/python-quantities
