1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
Python Paste
============
Python Paste -- 50% tastier than Elmer's!
Paste: making the web sticky.
Fix broken websites by applying a Paste liberally.
Paste: paper over your inconsistencies.
Paste: a soft mixture of malleable consistency.
Paste: a tasty mixture to be spread on bread or crackers.
Paste: the glue that won't hurt you when you eat it.
Python Paste: the web extruded into the form of a snake.
Paste: the vinegar eel.
Paste: you bring the cut.
Paste: a doughy substance from which to make metaphorical web cupcakes.
Python Paste brings consistency to Python web development and web
application installation, providing tools for both developers and
system administrators.
Paste for Administrators
------------------------
* Easily install, run, and configure multiple Paste-enabled web
applications at once, and integrate them into your website how you
want (SCGI, FCGI, AJP, WSGI)
* Manage and install web applications system-wide for easy maintenance
* `See an installation example <install-example.html>`_ or `read more
about what Paste-enabled means... <enabled.html>`_
Paste for Web Developers
------------------------
* Increase your web application's audience
* Provide starter templates and custom commands for using your web
framework
* Keep your development and deployment straightened out, and your
automated testing streamlined
* Attention payed to the full development cycle -- starting projects,
converting old projects, updating and deploying projects -- using a
set of `complimentary packages and tools <related-projects.html>`_
* `See a development example <develop-example.html>`_ or `read more
about using Paste in your
applications... <developer-features.html>`_
Documentation
=============
Tutorials and Introduction
==========================
* `To-Do Tutorial <http://pythonpaste.org/todo/TodoTutorial.html>`_
The core Paste package is a set of tools that use `WSGI
<http://www.python.org/peps/pep-0333.html>`_ heavily as the means of
communication. WSGI is an in-process CGI-like communication protocol.
Right now the best way to see the various tools available in Paste is
to `look through the source <module-index.html>`_.
Related Projects
================
Closely related packages:
* `Paste Deploy <http://pythonpaste.org/deploy/>`_
* `Paste Script <http://pythonpaste.org/script/>`_
* `Paste WebKit <http://pythonpaste.org/webkit/>`_
* `Wareweb <http://pythonpaste.org/wareweb/>`_
Developer Documentation
=======================
* `Developer Guidelines <DeveloperGuidelines.html>`_
* `Style Guide <StyleGuide.html>`_
Reference Documentation
=======================
* `Testing Applications With Paste <testing-applications.html>`_
* `URL Parsing with WSGI and Paste <url-parsing-with-wsgi.html>`_
License
=======
Paste is distributed under the `Python Software Foundation`__
license. This is a BSD/MIT-style license.
.. __: http://www.python.org/psf/license.html
Overview
========
If you don't want to look through source, here's a quick overview of
what there is here:
Testing
-------
* A fixture for testing WSGI applications conveniently and in-process,
in ``paste.fixture``
* A fixture for testing command-line applications, also in
``paste.fixture``
* Check components for WSGI-compliance in ``paste.lint``
Dispatching
-----------
* Chain and cascade WSGI applications (returning the first non-error
response) in ``paste.cascade``
* Dispatch to several WSGI applications based on URL prefixes, in
``paste.urlmap``
* Allow applications to make subrequests and forward requests
internally, in ``paste.recursive``
Web Application
---------------
* Run CGI programs as WSGI applications in ``paste.cgiapp`` (and
Python-sepcific CGI programs with ``paste.pycgiwrapper``)
* Traverse files and load WSGI applications from ``.py`` files (or
static files), in ``paste.urlparser``
* Serve static directories of files, also in ``paste.urlparser``
Tools
-----
* Catch HTTP-related exceptions (e.g., ``HTTPNotFound``) and turn them
into proper responses in ``paste.httpexceptions``
* Check for signed cookies for authentication, setting ``REMOTE_USER``
in ``paste.login``
* Create sessions in ``paste.session`` and ``paste.flup_session``
* Gzip responses in ``paste.gzip``
* A wide variety of routines for manipulating WSGI requests and
producing responses, in ``paste.wsgilib``
Debugging Filters
-----------------
* Catch (optionally email) errors with extended tracebacks (using
Zope/ZPT conventions) in ``paste.exceptions``
* Catch errors presenting a `cgitb
<http://python.org/doc/current/lib/module-cgitb.html>`_-based
output, in ``paste.cgitb_catcher``.
* Profile each request and append profiling information to the HTML,
in ``paste.profilemiddleware``
* Capture ``print`` output and present it in the browser for
debugging, in ``paste.printdebug``
* Validate all HTML output from applications using the `WDG Validator
<http://www.htmlhelp.com/tools/validator/>`_, appending any errors
or warnings to the page, in ``paste.wdg_validator``
Other Tools
-----------
* A file monitor to allow restarting the server when files have been
updated (for automatic restarting when editing code) in
``paste.reloader``
* A class for generating and traversing URLs, and creating associated
HTML code, in ``paste.url``
|
