summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2012-08-15 12:57:29 -0400
committerChris McDonough <chrism@plope.com>2012-08-15 12:57:29 -0400
commitcdcea948c3f6f3abbd1772500029066e80825082 (patch)
tree875a2a015f9c7f81ce5c8f033cd91352290d1c1d
parent4a1144673a30f284c45ec5a95fa6160efe2b6f4c (diff)
downloadpyramid-cdcea948c3f6f3abbd1772500029066e80825082.tar.gz
pyramid-cdcea948c3f6f3abbd1772500029066e80825082.tar.bz2
pyramid-cdcea948c3f6f3abbd1772500029066e80825082.zip
note whitespace rules, explain setup.py dev
-rw-r--r--HACKING.txt15
1 files changed, 10 insertions, 5 deletions
diff --git a/HACKING.txt b/HACKING.txt
index 38c263ed7..87d1422dc 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -30,11 +30,13 @@ checkout.
$ env/bin/easy_install setuptools-git
- Install Pyramid from the checkout into the virtualenv using ``setup.py
- develop`` (running ``setup.py develop`` *must* be done while the current
- working directory is the ``pyramid`` checkout directory)::
+ dev``. ``setup.py dev`` is an alias for "setup.py develop" which also
+ installs testing requirements such as nose and coverage. Running
+ ``setup.py dev`` *must* be done while the current working directory is the
+ ``pyramid`` checkout directory::
$ cd pyramid
- $ ../env/bin/python setup.py develop
+ $ ../env/bin/python setup.py dev
- At that point, you should be able to create new Pyramid projects by using
``pcreate``::
@@ -85,6 +87,9 @@ Coding Style
2 newlines between classes. But 80-column lines, in particular, are
mandatory.
+- Please do not remove trailing whitespace. Configure your editor to reduce
+ diff noise.
+
Running Tests
--------------
@@ -110,8 +115,8 @@ Test Coverage
- The codebase *must* have 100% test statement coverage after each commit.
You can test coverage via ``tox -e coverage``, or alternately by installing
- ``nose`` and ``coverage`` into your virtualenv, and running ``setup.py
- nosetests --with-coverage``.
+ ``nose`` and ``coverage`` into your virtualenv (easiest via ``setup.py
+ dev``) , and running ``setup.py nosetests --with-coverage``.
Documentation Coverage and Building HTML Documentation
------------------------------------------------------