From 5ddc8460de1d3bf1ea41eb4fdc7079d15dcf6837 Mon Sep 17 00:00:00 2001 From: Helmut Grohne Date: Thu, 27 Mar 2008 14:40:50 +0100 Subject: epydoc update --- wsgitools/middlewares.py | 44 +++++++++++++++++++++++++++++++++++--------- 1 file changed, 35 insertions(+), 9 deletions(-) (limited to 'wsgitools/middlewares.py') diff --git a/wsgitools/middlewares.py b/wsgitools/middlewares.py index bee0ac3..871105c 100644 --- a/wsgitools/middlewares.py +++ b/wsgitools/middlewares.py @@ -13,10 +13,17 @@ __all__.append("SubdirMiddleware") class SubdirMiddleware: """Middleware choosing wsgi applications based on a dict.""" def __init__(self, default, mapping={}): + """ + @type default: wsgi app + @type mapping: {str: wsgi app} + """ self.default = default self.mapping = mapping def __call__(self, environ, start_response): - """wsgi interface""" + """wsgi interface + @type environ: {str: str} + @rtype: gen([str]) + """ assert isinstance(environ, dict) app = None script = environ["PATH_INFO"] @@ -45,7 +52,10 @@ class NoWriteCallableMiddleware: """Wraps wsgi application app.""" self.app = app def __call__(self, environ, start_response): - """wsgi interface""" + """wsgi interface + @type environ: {str, str} + @rtype: gen([str]) + """ assert isinstance(environ, dict) todo = [] def modified_start_response(status, headers, exc_info=None): @@ -196,7 +206,9 @@ class CachingMiddleware: self.cacheable = cacheable self.cache = {} def __call__(self, environ, start_response): - """wsgi interface""" + """wsgi interface + @type environ: {str: str} + """ assert isinstance(environ, dict) if not self.storable(environ): return self.app(environ, start_response) @@ -241,11 +253,17 @@ __all__.append("DictAuthChecker") class DictAuthChecker: """Verifies usernames and passwords by looking them up in a dict.""" def __init__(self, users): - """@param users: is a dict mapping usernames to password.""" + """ + @type users: {str: str} + @param users: is a dict mapping usernames to password.""" self.users = users def __call__(self, username, password): """check_function interface taking username and password and resulting - in a bool.""" + in a bool. + @type username: str + @type password: str + @rtype: bool + """ return username in self.users and self.users[username] == password __all__.append("BasicAuthMiddleware") @@ -256,13 +274,17 @@ class BasicAuthMiddleware: @param app: is a WSGI application. @param check_function: is a function taking two arguments username and password returning a bool indicating whether the request may is - allowed.""" + allowed. + @type realm: str + """ self.app = app self.check_function = check_function self.realm = realm def __call__(self, environ, start_response): - """wsgi interface""" + """wsgi interface + @type environ: {str: str} + """ assert isinstance(environ, dict) auth = environ.get("HTTP_AUTHORIZATION") if not auth or ' ' not in auth: @@ -281,7 +303,9 @@ class BasicAuthMiddleware: return self.authorization_required(environ, start_response) def authorization_required(self, environ, start_response): - """wsgi application for indicating authorization is required.""" + """wsgi application for indicating authorization is required. + @type environ: {str: str} + """ status = "401 Authorization required" html = "Authorization required" + \ "

Authorization required

\n" @@ -301,7 +325,9 @@ class TracebackMiddleware: """app is the wsgi application to proxy.""" self.app = app def __call__(self, environ, start_response): - """wsgi interface""" + """wsgi interface + @type environ: {str: str} + """ try: assert isinstance(environ, dict) ret = self.app(environ, start_response) -- cgit v1.2.3