From dc767e196b853e7dd8e4fc08de2dcb48e3688d03 Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.com>
Date: Sat, 23 Apr 2011 15:27:18 -0400
Subject: [PATCH] packaging

---
 docs/contents.rst.inc |   1 +
 docs/packaging.rst    | 121 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 docs/packaging.rst

diff --git a/docs/contents.rst.inc b/docs/contents.rst.inc
index 48d5093..7c0932b 100644
--- a/docs/contents.rst.inc
+++ b/docs/contents.rst.inc
@@ -12,6 +12,7 @@ instructions for web development with Flask.
    installation
    useful-tools
    tutorial/index
+   packaging
    templating
    testing
    errorhandling
diff --git a/docs/packaging.rst b/docs/packaging.rst
new file mode 100644
index 0000000..39ce9a9
--- /dev/null
+++ b/docs/packaging.rst
@@ -0,0 +1,121 @@
+Packaging Your Code
+==========================
+
+For PyPi
+::::::::
+
+If you're writing an open source Python module, PyPi, more properly known as *The Cheeseshop*, is the place to host it.
+
+Package Manager
+---------------
+
+While Snow Leopard comes with a large number of UNIX utilities, those
+familiar with Linux systems will notice one key component missing: a
+package manager. Mxcl's *Homebrew* is the answer.
+
+To install Homebrew, simply run: ::
+
+    $ ruby -e "$(curl -fsS http://gist.github.com/raw/323731/install_homebrew.rb)"
+
+
+It's basic commands are **update**, **install**, and **remove**.
+
+.. man brew
+
+
+
+Python Interpreter
+------------------
+
+And we can now install Python 2.7: ::
+
+    $ brew install python --framework
+
+
+The ``--framework`` option tells Homebrew to compile a Framework-style Python build, rather than a UNIX-style build. The outdated version of Python that Snow Leopard comes packaged with
+is built as a Framework, so this helps avoid some future module installation
+bugs.
+
+*Don't forget to update your environment PATH.*
+
+
+Distribute & Pip
+----------------
+
+*Distribute* is a fantastic drop-in replacement for *easy_install* and
+*setuptools*. It allows you to install and manage python packages from
+pypi.python.org, amongst a few other sources. It also plays well with
+*virtualenv* and user-enviornments.
+
+**easy_install** is considered by many to be a deprecated system, so we
+will install it's replacement: **pip**. Pip allows for uninstallation
+of packages, and is actively maintained, unlike setuptool's easy_install.
+
+To install *pip* and Distribute's *easy_install*:
+
+If you have homebrew: ::
+
+    $ brew install pip
+
+...And, if you're a masochist: ::
+
+    $ curl -O http://python-distribute.org/distribute_setup.py
+    $ python distribute_setup.py
+
+    $ easy_install pip
+
+
+
+To install ``pip``: ::
+
+Hopefully you'll never have to use **easy_install** again.
+
+
+Updating Python
+---------------
+
+Homebrew makes it simple. ::
+
+    $ brew update
+    $ brew install --force python
+
+
+Windows
+:::::::
+
+
+
+Prerequisites:
+--------------
+
+* Python2.7 (x86) from Python.org
+* Microsoft Visual Studio
+
+
+Step 1: Install Distribute & Pip
+--------------------------------
+
+**Distribute** is a fantastic drop-in replacement for **easy_install** and **setuptools**. It allows you to install and manage python packages from PyPi, amongst a few other sources.
+
+To install it, run the python script available here:
+  <http://python-distribute.org/distribute_setup.py>
+
+Make sure that ```C:\Python27\```, and  ```C:\Python27\Scripts``` are in your PATH.
+
+**easy_install** is considered by many to be a deprecated system, so we will install it's replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike setuptool's easy_install.
+
+To install pip, simply run: ::
+
+    $ easy_install pip
+
+
+Linux (Ubuntu)
+::::::::::::::
+
+
+
+Linux (Manual)
+::::::::::::::
+
+
+