# HG changeset patch
# User paulb
# Date 1075419745 0
# Node ID 99a2a5eed28628f2e49055f72e56712c37765f4e
# Parent  64b71491020c1855b9c04917f3de478b2d5f2a76
[project @ 2004-01-29 23:42:25 by paulb]
Added some new abstractions and some documentation.

diff -r 64b71491020c -r 99a2a5eed286 WebStack/Generic.py
--- a/WebStack/Generic.py	Fri Jun 20 22:20:19 2008 +0200
+++ b/WebStack/Generic.py	Thu Jan 29 23:42:25 2004 +0000
@@ -2,6 +2,17 @@
 
 """
 Generic Web framework interfaces.
+The WebStack architecture consists of the following layers:
+
+  * Framework - The underlying Web framework implementation.
+  * Adapter   - Code operating under the particular framework which creates
+                WebStack abstractions and issues them to the application.
+  * Resources - Units of functionality operating within the hosted Web
+                application.
+
+Resources can act as both content producers within an application and as request
+dispatchers to other resources; in the latter role, they may be referred to as
+directors.
 """
 
 class ContentType:
@@ -163,6 +174,13 @@
 
     "A generic resource interface."
 
-    pass
+    def respond(self, trans):
+
+        """
+        An application-specific method which performs activities on the basis of
+        the transaction object 'trans'.
+        """
+
+        raise NotImplementedError, "respond"
 
 # vim: tabstop=4 expandtab shiftwidth=4