Merge pull request #528 from mardy/fcgi-doc

docs: update deployment info for FastCGI

docs/docs/extras/deployment.rst

@@ -196,6 +196,10 @@ directory.
 `mod_fastcgi <http://www.fastcgi.com/mod_fastcgi/docs/mod_fastcgi.html>`__
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+You can use this method if your hosting provider doesn't allow you to have long
+running processes. If FastCGI has not yet been configured in your server,
+please follow these steps:
+
 .. note:: This information may be incorrect, if you have more knowledge on how
    to deploy Python via `mod_fastcgi`, consider extending/correcting this section.
 
@@ -219,21 +223,30 @@ directory.
         </Location>
     </VirtualHost>
 
-Next, copy'n'paste to `/var/www/isso.fcgi` (or whatever location you prefer):
+Next, to run isso as a FastCGI script you'll need to install ``flup`` with
+PIP:
+
+.. code-block:: sh
+
+    $ pip install flup
+
+Finally, copy'n'paste to `/var/www/isso.fcgi` (or whatever location you prefer):
 
 .. code-block:: python
 
     #!/usr/bin/env python
     #: uncomment if you're using a virtualenv
     # import sys
-    # sys.insert(0, '<your_local_path>/lib/python2.7/site-packages')
+    # sys.path.insert(0, '<your_local_path>/lib/python2.7/site-packages')
 
-    from isso import make_app
+    from isso import make_app, dist, config
-    from isso.core import Config
+    import os
 
     from flup.server.fcgi import WSGIServer
 
-    application = make_app(Config.load("/path/to/isso.cfg"))
+    application = make_app(config.load(
+            os.path.join(dist.location, dist.project_name, "defaults.ini"),
+            "/path/to/isso.cfg"))
     WSGIServer(application).run()
 
 `Openshift <http://openshift.com>`__