Reinitialize with buildout

Author: klette

LICENSE

@@ -0,0 +1,40 @@
+pyroutes
+=========
+A really small wrapper for rapid development of small python
+web applications
+
+Why?
+-----
+I got tired of dealing with the same boring WSGI-stuff everytime
+I wanted to make a small web-utility in django, but I didn't want
+to go to far away from it, so I made this little thing to ease the
+work a bit.
+
+How it works
+-------------
+The core of the system is WSGI, and a decorator called @route.
+You simple create add a route decorator in front of the function
+you want to handle requests to a certain path. pyroutes always
+tries to use the most specified path-handler available for the request.
+That means `@route('/foo/bar')` will always be used over `@route('/foo')`
+given that request path is `/foo/bar` or longer that is :-)
+Notice that paths have to be given without a trailing slash.
+
+The decorated function should return the helper `Response` class.
+The `Response` class takes three arguments: `content`, `headers` and `status_code`.
+`content` is the data that should be returned, `headers` a list of tuples representing
+the http-headers returned and `status_code` a valid HTTP status code. If `headers` and `status_code`
+is omitted it defaults to `text/html` as content type and `200 OK` as status code.
+
+Example:
+
+    @route('/')
+    def index(environ, data):
+        return(Response('Hello world!', [('Content-Type', 'text/html')], '200 OK'))
+
+
+Noticed the parameters to the index function? Those are mandatory. 
+The `environ`-parameter is the unmodified environment from WSGI and
+`data` is a dictionary with the GET and POST parameters.
+
+For more information about usage, see the wiki example.

README

@@ -0,0 +1,84 @@
+##############################################################################
+#
+# Copyright (c) 2006 Zope Corporation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Bootstrap a buildout-based project
+
+Simply run this script in a directory containing a buildout.cfg.
+The script accepts buildout command-line options, so you can
+use the -c option to specify an alternate configuration file.
+
+$Id$
+"""
+
+import os, shutil, sys, tempfile, urllib2
+
+tmpeggs = tempfile.mkdtemp()
+
+is_jython = sys.platform.startswith('java')
+
+try:
+    import pkg_resources
+except ImportError:
+    ez = {}
+    exec urllib2.urlopen('http://peak.telecommunity.com/dist/ez_setup.py'
+                         ).read() in ez
+    ez['use_setuptools'](to_dir=tmpeggs, download_delay=0)
+
+    import pkg_resources
+
+if sys.platform == 'win32':
+    def quote(c):
+        if ' ' in c:
+            return '"%s"' % c # work around spawn lamosity on windows
+        else:
+            return c
+else:
+    def quote (c):
+        return c
+
+cmd = 'from setuptools.command.easy_install import main; main()'
+ws  = pkg_resources.working_set
+
+if len(sys.argv) > 2 and sys.argv[1] == '--version':
+    VERSION = ' == %s' % sys.argv[2]
+    args = sys.argv[3:] + ['bootstrap']
+else:
+    VERSION = ''
+    args = sys.argv[1:] + ['bootstrap']
+
+if is_jython:
+    import subprocess
+
+    assert subprocess.Popen([sys.executable] + ['-c', quote(cmd), '-mqNxd',
+           quote(tmpeggs), 'zc.buildout' + VERSION],
+           env=dict(os.environ,
+               PYTHONPATH=
+               ws.find(pkg_resources.Requirement.parse('setuptools')).location
+               ),
+           ).wait() == 0
+
+else:
+    assert os.spawnle(
+        os.P_WAIT, sys.executable, quote (sys.executable),
+        '-c', quote (cmd), '-mqNxd', quote (tmpeggs), 'zc.buildout' + VERSION,
+        dict(os.environ,
+            PYTHONPATH=
+            ws.find(pkg_resources.Requirement.parse('setuptools')).location
+            ),
+        ) == 0
+
+ws.add_entry(tmpeggs)
+ws.require('zc.buildout' + VERSION)
+import zc.buildout.buildout
+zc.buildout.buildout.main(args)
+shutil.rmtree(tmpeggs)

bootstrap.py

@@ -0,0 +1,10 @@
+[buildout]
+parts = python
+develop = .
+eggs = pyroutes
+
+[python]
+recipe = zc.recipe.egg
+interpreter = python
+eggs = ${buildout:eggs}
+

buildout.cfg

@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# encoding: utf-8
+
+from setuptools import setup, find_packages
+import os
+
+setup(
+    name = "pyroutes",
+    version = "0.1.2",
+    url = 'http://github.com/klette/pyroutes',
+    license = 'GPLv2',
+    description = "A small WSGI wrapper for creating small python web apps",
+    long_description = open(os.path.join(os.path.dirname(__file__), 'README')).read(),
+    author = 'Kristian Klette',
+    author_email = '[email protected]',
+    packages = find_packages('src'),
+    package_dir = {'': 'src'},
+    install_requires = ['setuptools'],
+
+    classifiers = [
+        'Development Status :: 3 - Alpha',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: GNU General Public License (GPL)',
+        'Programming Language :: Python',
+        'Topic :: Internet :: WWW/HTTP',
+        'Topic :: Internet :: WWW/HTTP :: WSGI',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+        'Operating System :: OS Independent',
+        ]
+
+)
+

setup.py

@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+#encoding: utf-8
+
+from wsgiref.util import shift_path_info
+import cgi
+    
+global __request__handlers__
+__request__handlers__ = {}
+
+def route(path):
+    """
+    Decorates a function for handling page requests to
+    a certain path
+    """
+    global __request__handlers__
+    
+    def decorator(func):
+        __request__handlers__[path] = func
+    return decorator
+    
+def application(environ, start_response):
+    """
+    Searches for a handler for a certain request and
+    dispatches it if found. Returns 404 if not found.
+    """
+    _environ = environ.copy()
+    handlers = __request__handlers__.keys()
+    path = shift_path_info(_environ)
+    request = [] 
+    if not path:
+        request = ['/']
+    else:
+        while path:
+            request.append(path)
+            path = shift_path_info(_environ)
+
+    handler = None
+    complete_path = '/%s' % '/'.join(request)
+    current_path = complete_path
+    
+    while handler is None:
+        if current_path in handlers:
+            handler = __request__handlers__[current_path]
+            break
+        current_path = current_path[:current_path.rfind("/")]
+        if not current_path:
+            start_response('404 Not Found', [('Content-type', 'text/plain')])
+            return ["No handler found for path %s" % complete_path]
+    try:
+        _data = cgi.FieldStorage(
+            fp=environ['wsgi.input'],
+            environ=environ,
+            keep_blank_values=False
+        )
+        data = {}
+        for key in _data.keys():
+            data[key] = _data.getvalue(key)
+        response = handler(environ, data)
+        start_response(response.status_code, response.headers)
+        return[response.content]
+    except Exception, exception:
+        start_response('500 Error', [('Content-type', 'text/plain')])
+        return ["An error occurred\n%s" % str(exception)]
+
+    

src/pyroutes/__init__.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python
+# encoding: utf-8
+"""
+http.py
+
+A collection of Response classes for pyroutes
+"""
+
+class Response():
+    """
+    A wrapper class for a response to a route. Takes
+    a content, headers and status_code parameter.
+    headers should be passed in as a tuple.
+    """
+    def __init__(self, content=None, headers=[('Content-Type', 'text/html')], status_code='200 OK'):
+        self.content = content
+        self.headers = headers
+        self.status_code  = status_code
+        
+
+class Redirect(Response):
+    """
+    A redirect shortcut class for redirection responses
+    """
+    
+    def __init__(self, location):
+        self.content = "redirect"
+        self.headers = [('Location', location)]
+        self.status_code = "302 See Other"
+
+