Phillip,
1. It's not really clear from the abstract 'what' this library
provides. You might want
to consider moving the text from 1.1 up to the same level as the abstract.
2. In section 1.1 you might want to consider dropping the sentence:
"Only authors
of web servers and programming frameworks need to know every detail..."
It doesn't offer any concrete information and just indirectly
makes WSGI look complicated.
3. From the abstract: "Having a standard interface makes it easy to use a
WSGI-supporting application with a number of different web servers."
is a little akward, how about:
"Having a standard interface makes it easy to use an application
that supports WSGI with a number of different web servers."
4. I believe the order of submodules presented is important and think that
they should be listed with 'handlers' and 'simple_server' first:
wsgiref.handlers - server/gateway base classes
wsgiref.simple_server - a simple WSGI HTTP server
wsgiref.util - WSGI environment utilities
wsgiref.headers - WSGI response header tools
wsgiref.validate - WSGI conformance checker
5. You might consider moving 'headers' into 'util'. Of course, you could
go all the way in simplifying and move 'validate' in there too.
wsgiref.handlers - server/gateway base classes
wsgiref.simple_server - a simple WSGI HTTP server
wsgiref.util - WSGI environment utilities
Besides those nits it looks very good and will be a fine
addition to the core library.
-joe
On 6/6/06, Phillip J. Eby <[EMAIL PROTECTED]> wrote:
> I've finished my draft for the wsgiref documentation (including stuff I
> swiped from AMK's draft; thanks AMK!), and am looking for comments before I
> add it to the stdlib documentation.
>
> Source: http://svn.eby-sarna.com/svnroot/wsgiref/docs
> PDF:http://peak.telecommunity.com/wsgiref.pdf
> HTML: http://peak.telecommunity.com/wsgiref_docs/
>
> My current plan is to make a hopefully-final release of the standalone
> version of wsgiref on PyPI, then clone that version for inclusion in the
> stdlib.
>
> The latest version of wsgiref in the eby-sarna SVN includes a new
> ``make_server()`` convenience function (addressing Titus' concerns about
> the constructor signatures while retaining backward compatibility) and it
> adds a ``wsgiref.validate`` module based on paste.lint.
>
> In addition to those two new features, tests were added for the new
> validate module and for WSGIServer. The test suite and directory layout of
> the package were also simplified and consolidated to make merging to the
> stdlib easier.
>
> Feedback welcomed.
>
> _______
> Web-SIG mailing list
> Web-SIG@python.org
> Web SIG: http://www.python.org/sigs/web-sig
> Unsubscribe:
> http://mail.python.org/mailman/options/web-sig/joe.gregorio%40gmail.com
>
--
Joe Gregoriohttp://bitworking.org
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
