README filedebian

1 files changed, 45 insertions, 0 deletions

diff --git a/README-Debian b/README-Debian
new file mode 100644
index 0000000..77dccd4
--- /dev/null
+++ b/README-Debian
@@ -0,0 +1,45 @@
+This repository is used for building the python-requests .deb package for debian and ubuntu.
+
+The debian packaging files are located in the debian branch.
+
+Building the package
+-------------------------
+
+1. set up environment variables, making sure the full name and email exactly match the GPG key used to sign:
+$ export DEBFULLNAME="Your Name"
+$ export DEBEMAIL="Your.Email@address.here"
+
+2. Download the tarball from http://pypi.python.org/pypi/requests 
+
+3. Unpack the tarball
+
+4. cd into the source directory
+
+5. run dh_make:
+$ dh_make -s -f ../requests-0.14.0.tar.gz -e <Your.Email@address.here> -p python-requests
+
+6. edit the debian/control file using the following fields:
+
+    Source: python-requests
+    Maintainer: Your Name <Your.Email@address.here> 
+    Section: python
+    Priority: optional
+    Build-Depends: python-setuptools (>= 0.6b3), debhelper (>= 7), python-support (>= 0.8.4)
+    Standards-Version: 3.8.4
+    
+    Package: python-requests
+    Architecture: all
+    Depends: ${misc:Depends}, ${python:Depends}
+    XB-Python-Version: ${python:Versions}
+    Provides: ${python:Provides}
+    Description: Python HTTP for Humans.
+
+7. edit the debian/copyright file, using the COPYING file in the source tree for the copyright text.
+
+8. specify supported python versions:
+$ echo "2.6-" > debian/pyversions
+
+9. [TODO] edit the debian/changelog file
+
+10. run debuild
+$ debuild