1.1 --- a/README.txt Fri Sep 09 20:47:25 2005 +0000
1.2 +++ b/README.txt Sat Sep 10 23:50:39 2005 +0000
1.3 @@ -55,133 +55,138 @@
1.4 New in WebStack 1.0 (Changes since WebStack 0.10)
1.5 -------------------------------------------------
1.6
1.7 -Changed the behaviour of get_path, get_path_without_query, get_path_info,
1.8 -get_virtual_path_info, get_processed_virtual_path_info and
1.9 -get_fields_from_path to return Unicode data decoded using the optional
1.10 -encoding parameter or a common default encoding.
1.11 -Fixed file upload values so that FileContent objects are returned for such
1.12 -fields in get_fields_from_body and get_fields. (Warning! Except for Twisted!)
1.13 -Fixed the JavaServlet support so that streams and file content are obtained as
1.14 -"almost" plain strings.
1.15 -Updated/fixed LoginResource and LoginRedirectResource to use the updated path
1.16 -API and to handle special characters properly.
1.17 -Added convenience methods to Transaction for the decoding and encoding of path
1.18 -values (to and from Unicode objects) - see the decode_path and encode_path
1.19 -methods.
1.20 -Added the notion of processed virtual path info - the part of the original
1.21 -path info not represented in the current virtual path info.
1.22 -Added "pass through" behaviour to ResourceMap.MapResource (prompted by a patch
1.23 -from Scott Robinson).
1.24 -Fixed ResourceMap.MapResource to handle non-existent resources properly (where
1.25 -the virtual path info is only one component in length).
1.26 -Added Debian package support.
1.27 -Added automatic session directory creation for the WebStack sessions
1.28 -implementation.
1.29 -Added support for the repeated retrieval of sessions from the same WebStack
1.30 -session store, avoiding deadlocks.
1.31 -Fixed the calendar example, making it perform a proper function.
1.32 -Made the BaseHTTPRequestHandler and Twisted SimpleWithLogin applications
1.33 -include the Login application, since Konqueror (at least) does not share
1.34 -cookies across different port numbers on the same host.
1.35 -Added the SimpleWithLogin and Login applications to the demonstration.
1.36 -Improved the documentation, adding information on request headers, and
1.37 -describing file upload and session support limitations.
1.38 + * Changed the behaviour of get_path, get_path_without_query, get_path_info,
1.39 + get_virtual_path_info, get_processed_virtual_path_info and
1.40 + get_fields_from_path to return Unicode data decoded using the optional
1.41 + encoding parameter or a common default encoding.
1.42 + * Fixed file upload values so that FileContent objects are returned for such
1.43 + fields in get_fields_from_body and get_fields.
1.44 + (Warning! Except for Twisted!)
1.45 + * Fixed the JavaServlet support so that streams and file content are
1.46 + obtained as "almost" plain strings.
1.47 + * Updated/fixed LoginResource and LoginRedirectResource to use the updated
1.48 + path API and to handle special characters properly.
1.49 + * Added convenience methods to Transaction for the decoding and encoding of
1.50 + path values (to and from Unicode objects) - see the decode_path and
1.51 + encode_path methods.
1.52 + * Added the notion of processed virtual path info - the part of the original
1.53 + path info not represented in the current virtual path info.
1.54 + * Added "pass through" behaviour to ResourceMap.MapResource (prompted by a
1.55 + patch from Scott Robinson).
1.56 + * Fixed ResourceMap.MapResource to handle non-existent resources properly
1.57 + (where the virtual path info is only one component in length).
1.58 + * Added Debian package support.
1.59 + * Added automatic session directory creation for the WebStack sessions
1.60 + implementation.
1.61 + * Added support for the repeated retrieval of sessions from the same
1.62 + WebStack session store, avoiding deadlocks.
1.63 + * Fixed the calendar example, making it perform a proper function.
1.64 + * Made the BaseHTTPRequestHandler and Twisted SimpleWithLogin applications
1.65 + include the Login application, since Konqueror (at least) does not share
1.66 + cookies across different port numbers on the same host.
1.67 + * Added the SimpleWithLogin and Login applications to the demonstration.
1.68 + * Improved the documentation, adding information on request headers, and
1.69 + describing file upload and session support limitations.
1.70
1.71 New in WebStack 0.10 (Changes since WebStack 0.9)
1.72 -------------------------------------------------
1.73
1.74 -Changes to make the tools/demo.py script work on Windows (and other) platforms
1.75 -(suggested by Jim Madsen).
1.76 -Fixed end of header newlines for CGI (suggested by Matt Harrison).
1.77 -Minor documentation fixes and improvements, adding information on AOLserver in
1.78 -the CGI and Webware notes.
1.79 -Changed the mod_python server name method to use the server object rather than
1.80 -the connection object.
1.81 -Added a parameter to the ResourceMap.MapResource class to permit automatic
1.82 -redirects into resource hierarchies when no trailing "/" was given in the URL;
1.83 -changed the updated virtual path info so that empty values may be set (the
1.84 -guarantee that "/" will always appear no longer applies).
1.85 -Fixed virtual path info retrieval when the value is an empty string.
1.86 + * Changes to make the tools/demo.py script work on Windows (and other)
1.87 + platforms (suggested by Jim Madsen).
1.88 + * Fixed end of header newlines for CGI (suggested by Matt Harrison).
1.89 + * Minor documentation fixes and improvements, adding information on
1.90 + AOLserver in the CGI and Webware notes.
1.91 + * Changed the mod_python server name method to use the server object rather
1.92 + than the connection object.
1.93 + * Added a parameter to the ResourceMap.MapResource class to permit automatic
1.94 + redirects into resource hierarchies when no trailing "/" was given in the
1.95 + URL; changed the updated virtual path info so that empty values may be set
1.96 + (the guarantee that "/" will always appear no longer applies).
1.97 + * Fixed virtual path info retrieval when the value is an empty string.
1.98
1.99 New in WebStack 0.9 (Changes since WebStack 0.8)
1.100 ------------------------------------------------
1.101
1.102 -Standardised error handling in the adapters so that tracebacks can be
1.103 -suppressed and an internal server error condition raised.
1.104 -Added overriding of path info in transactions.
1.105 -Added a ResourceMap resource for dispatching to different resources
1.106 -according to path components.
1.107 -Standardised deployment for some frameworks (see docs/deploying.html).
1.108 -Introductory documentation in XHTML format.
1.109 -Added server name and port methods to the transaction.
1.110 -Added a simple demonstration application, incorporating many of the examples
1.111 -and launched under a single script.
1.112 -Fixed mod_python native sessions.
1.113 -Fixed Zope request stream access.
1.114 -WebStack is now licensed under the LGPL - see docs/COPYING.txt for details.
1.115 + * Standardised error handling in the adapters so that tracebacks can be
1.116 + suppressed and an internal server error condition raised.
1.117 + * Added overriding of path info in transactions.
1.118 + * Added a ResourceMap resource for dispatching to different resources
1.119 + according to path components.
1.120 + * Standardised deployment for some frameworks (see docs/deploying.html).
1.121 + * Introductory documentation in XHTML format.
1.122 + * Added server name and port methods to the transaction.
1.123 + * Added a simple demonstration application, incorporating many of the
1.124 + examples and launched under a single script.
1.125 + * Fixed mod_python native sessions.
1.126 + * Fixed Zope request stream access.
1.127 + * WebStack is now licensed under the LGPL - see docs/COPYING.txt for
1.128 + details.
1.129
1.130 New in WebStack 0.8 (Changes since WebStack 0.7)
1.131 ------------------------------------------------
1.132
1.133 -Added a standard exception, EndOfResponse, which can be used to immediately
1.134 -stop the processing/production of a response; this is useful when resources
1.135 -need to issue a redirect without unnecessary content being generated, for
1.136 -example.
1.137 -Fixed path information for Zope.
1.138 -Added WSGI support.
1.139 -Verified Twisted 1.3.0 support with Python 2.3.3.
1.140 + * Added a standard exception, EndOfResponse, which can be used to
1.141 + immediately stop the processing/production of a response; this is useful
1.142 + when resources need to issue a redirect without unnecessary content being
1.143 + generated, for example.
1.144 + * Fixed path information for Zope.
1.145 + * Added WSGI support.
1.146 + * Verified Twisted 1.3.0 support with Python 2.3.3.
1.147
1.148 New in WebStack 0.7 (Changes since WebStack 0.6)
1.149 ------------------------------------------------
1.150
1.151 -Fixed path information semantics.
1.152 -Fixed file upload semantics.
1.153 -Fixed content type handling for Unicode output and for interpreting request
1.154 -body fields/parameters (although some improvement remains).
1.155 -Added a method to discover the chosen response stream encoding.
1.156 -Fixed field/parameter retrieval so that path and body fields are distinct,
1.157 -regardless of the framework employed.
1.158 -Added a method to get a combination of path and body fields (suggested by
1.159 -Jacob Smullyan).
1.160 -Introduced Zope 2 support.
1.161 -Improved Jython/Java Servlet API support (although a special PyServlet class
1.162 -must now be used, and certain libraries must be deployed with applications).
1.163 -Introduced authentication/authorisation support for Jython/Java Servlet API.
1.164 -Session support has been added (except for Webware 0.8.1).
1.165 -Alternative cookie support for mod_python has been added.
1.166 -Cookie support now supports encoded Unicode sequences for names and values.
1.167 + * Fixed path information semantics.
1.168 + * Fixed file upload semantics.
1.169 + * Fixed content type handling for Unicode output and for interpreting
1.170 + request body fields/parameters (although some improvement remains).
1.171 + * Added a method to discover the chosen response stream encoding.
1.172 + * Fixed field/parameter retrieval so that path and body fields are distinct,
1.173 + regardless of the framework employed.
1.174 + * Added a method to get a combination of path and body fields (suggested by
1.175 + Jacob Smullyan).
1.176 + * Introduced Zope 2 support.
1.177 + * Improved Jython/Java Servlet API support (although a special PyServlet
1.178 + class must now be used, and certain libraries must be deployed with
1.179 + applications).
1.180 + * Introduced authentication/authorisation support for Jython/Java Servlet
1.181 + API.
1.182 + * Session support has been added (except for Webware 0.8.1).
1.183 + * Alternative cookie support for mod_python has been added.
1.184 + * Cookie support now supports encoded Unicode sequences for names and
1.185 + values.
1.186
1.187 New in WebStack 0.6 (Changes since WebStack 0.5)
1.188 ------------------------------------------------
1.189
1.190 -Introduced Jython/Java Servlet API support.
1.191 -Minor fixes to example applications and to BaseHTTPRequestHandler.
1.192 + * Introduced Jython/Java Servlet API support.
1.193 + * Minor fixes to example applications and to BaseHTTPRequestHandler.
1.194
1.195 New in WebStack 0.5 (Changes since WebStack 0.4)
1.196 ------------------------------------------------
1.197
1.198 -Changed request body fields/parameters so that they are now represented
1.199 -using Unicode objects rather than plain strings.
1.200 -Introduced better support for Unicode in response streams.
1.201 + * Changed request body fields/parameters so that they are now represented
1.202 + using Unicode objects rather than plain strings.
1.203 + * Introduced better support for Unicode in response streams.
1.204
1.205 New in WebStack 0.4 (Changes since WebStack 0.3)
1.206 ------------------------------------------------
1.207
1.208 -Added application definition of user identity, permitting alternative
1.209 -authentication mechanisms.
1.210 -Improved BaseHTTPRequestHandler and mod_python reliability around fields
1.211 -from request bodies.
1.212 -Provided stream and environment parameterisation in the CGI adapter.
1.213 -Added LoginRedirect and Login examples.
1.214 -Added get_path_without_query and fixed get_path behaviour.
1.215 + * Added application definition of user identity, permitting alternative
1.216 + authentication mechanisms.
1.217 + * Improved BaseHTTPRequestHandler and mod_python reliability around fields
1.218 + from request bodies.
1.219 + * Provided stream and environment parameterisation in the CGI adapter.
1.220 + * Added LoginRedirect and Login examples.
1.221 + * Added get_path_without_query and fixed get_path behaviour.
1.222
1.223 New in WebStack 0.3 (Changes since WebStack 0.2)
1.224 ------------------------------------------------
1.225
1.226 -Added better header support for Webware (suggested by Ian Bicking).
1.227 -Introduced CGI and Java Servlet support (the latter is currently
1.228 -broken/unfinished).
1.229 -Introduced support for cookies.
1.230 + * Added better header support for Webware (suggested by Ian Bicking).
1.231 + * Introduced CGI and Java Servlet support (the latter is currently
1.232 + broken/unfinished).
1.233 + * Introduced support for cookies.
1.234
1.235 Future Work
1.236 -----------
1.237 @@ -307,15 +312,15 @@
1.238
1.239 To make Debian packages:
1.240
1.241 - 1. Create new package directories under packages/debian if necessary.
1.242 - 2. Make a symbolic link in the distribution's root directory to keep the
1.243 - Debian tools happy:
1.244 + 1. Create new package directories under packages/debian if necessary.
1.245 + 2. Make a symbolic link in the distribution's root directory to keep the
1.246 + Debian tools happy:
1.247
1.248 - ln -s packages/debian/python2.4-webstack/debian/
1.249 + ln -s packages/debian/python2.4-webstack/debian/
1.250
1.251 - 3. Run the package builder:
1.252 + 3. Run the package builder:
1.253
1.254 - dpkg-buildpackage -rfakeroot
1.255 + dpkg-buildpackage -rfakeroot
1.256
1.257 - 4. Locate and tidy up the packages in the parent directory of the
1.258 - distribution's root directory.
1.259 + 4. Locate and tidy up the packages in the parent directory of the
1.260 + distribution's root directory.