summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2010-10-30 19:46:32 -0400
committerChris McDonough <chrism@plope.com>2010-10-30 19:46:32 -0400
commit051e27a386e9a774b3b1e8c705aa0c8de8e129c3 (patch)
tree82d74c5b95682d22323eb87b2a4b66b274bdbced
parentabf8249430fdc23901099d9e848d3a3b97c69526 (diff)
downloadpyramid-051e27a386e9a774b3b1e8c705aa0c8de8e129c3.tar.gz
pyramid-051e27a386e9a774b3b1e8c705aa0c8de8e129c3.tar.bz2
pyramid-051e27a386e9a774b3b1e8c705aa0c8de8e129c3.zip
Remove setuptools-git setup_requires (inappropriate for deployment), add instructions about how to set up a development checkout to HACKING.txt
-rw-r--r--HACKING.txt45
-rw-r--r--setup.py3
2 files changed, 45 insertions, 3 deletions
diff --git a/HACKING.txt b/HACKING.txt
index 464b653c1..c3a40900d 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -3,6 +3,51 @@ Hacking on Pyramid
Here are some guidelines about hacking on Pyramid.
+Using a Development Checkout
+----------------------------
+
+Below is a quick start on creating a development environment using a Pyramid
+checkout.
+
+- Create a new directory somewhere and ``cd`` to it::
+
+ $ mkdir ~/hack-on-pyramid
+ $ cd ~/hack-on-pyramid
+
+- Check out a read-only copy of the Pyramid source::
+
+ $ git clone git://github.com/Pylons/pyramid.git
+
+ (alternately, create a writeable fork on GitHub and check that out).
+
+- Create a virtualenv in which to install Pyramid::
+
+ $ virtualenv2.6 --no-site-packages env
+
+- Install ``setuptools-git`` into the virtualenv (for good measure, as we're
+ using git to do version control)::
+
+ $ 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)::
+
+ $ cd pyramid
+ $ ../env/bin/python setup.py develop
+
+- At that point, you should be able to create new Pyramid projects by using
+ ``paster create``::
+
+ $ cd ../env
+ $ bin/paster create -t pyramid_starter starter
+
+- And install those projects (also using ``setup.py develop``) into the
+ virtualenv::
+
+ $ cd starter
+ $ ../bin/python setup.py develop
+
Adding Features
---------------
diff --git a/setup.py b/setup.py
index 0b03851b3..b8330013e 100644
--- a/setup.py
+++ b/setup.py
@@ -27,8 +27,6 @@ try:
except IOError:
README = CHANGES = ''
-setup_requires = ['setuptools-git']
-
install_requires=[
'Chameleon >= 1.2.3',
'Mako',
@@ -76,7 +74,6 @@ setup(name='pyramid',
include_package_data=True,
zip_safe=False,
install_requires = install_requires,
- setup_requires = setup_requires,
tests_require = tests_require,
test_suite="pyramid.tests",
entry_points = """\