summaryrefslogtreecommitdiff
path: root/paste
diff options
context:
space:
mode:
authorianb <devnull@localhost>2005-05-14 18:04:55 +0000
committerianb <devnull@localhost>2005-05-14 18:04:55 +0000
commitbcd801b0be4a7dca09789810f49945e17449ff7e (patch)
tree6cb5dbbded636f2454eb8221bb32cde820ae5c67 /paste
parentb6279c708fa184f504a393f9ea291a55efcd3639 (diff)
downloadpaste-bcd801b0be4a7dca09789810f49945e17449ff7e.tar.gz
Added description
Diffstat (limited to 'paste')
-rw-r--r--paste/servers/README.txt24
1 files changed, 24 insertions, 0 deletions
diff --git a/paste/servers/README.txt b/paste/servers/README.txt
new file mode 100644
index 0000000..7b91d24
--- /dev/null
+++ b/paste/servers/README.txt
@@ -0,0 +1,24 @@
+This directory contains plugins for servers. Each plugin is
+identified by having "_server" on the end of its name. Plugins can be
+directories (Python packages), Python modules, or text (.txt) files.
+
+A text file must contain one (non-empty, non-comment) line, which is
+the name of a module that should be considered a server. E.g., you'd
+put "myapp.my_paste_server" in there, so that you could implement a
+server in your own package.
+
+Modules should have certain symbols (only 'serve' is required):
+
+serve(conf, app):
+ Required; this serves the given application, using the given
+ configuration options.
+options:
+ A list of (option_name, option_help), describing the options this
+ servers uses.
+description:
+ A fairly short (2-3 line) description of this server.
+help:
+ A longer help text.
+
+Note: if you have a package, __init__.py must contain these
+variables. \ No newline at end of file