py_tasks_melange: thirdparty/google_appengine/google/appengine/ext/webapp/__init_

109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	1	#!/usr/bin/env python
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	2	#
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	3	# Copyright 2007 Google Inc.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	4	#
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	5	# Licensed under the Apache License, Version 2.0 (the "License");
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	6	# you may not use this file except in compliance with the License.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	7	# You may obtain a copy of the License at
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	8	#
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	9	# http://www.apache.org/licenses/LICENSE-2.0
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	10	#
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	11	# Unless required by applicable law or agreed to in writing, software
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	12	# distributed under the License is distributed on an "AS IS" BASIS,
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	13	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	14	# See the License for the specific language governing permissions and
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	15	# limitations under the License.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	16	#
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	17
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	18	"""An extremely simple WSGI web application framework.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	19
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	20	This module exports three primary classes: Request, Response, and
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	21	RequestHandler. You implement a web application by subclassing RequestHandler.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	22	As WSGI requests come in, they are passed to instances of your RequestHandlers.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	23	The RequestHandler class provides access to the easy-to-use Request and
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	24	Response objects so you can interpret the request and write the response with
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	25	no knowledge of the esoteric WSGI semantics. Here is a simple example:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	26
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	27	from google.appengine.ext import webapp
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	28	import wsgiref.simple_server
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	29
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	30	class MainPage(webapp.RequestHandler):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	31	def get(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	32	self.response.out.write(
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	33	'<html><body><form action="/hello" method="post">'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	34	'Name: <input name="name" type="text" size="20"> '
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	35	'<input type="submit" value="Say Hello"></form></body></html>')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	36
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	37	class HelloPage(webapp.RequestHandler):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	38	def post(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	39	self.response.headers['Content-Type'] = 'text/plain'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	40	self.response.out.write('Hello, %s' % self.request.get('name'))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	41
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	42	application = webapp.WSGIApplication([
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	43	('/', MainPage),
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	44	('/hello', HelloPage)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	45	], debug=True)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	46
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	47	server = wsgiref.simple_server.make_server('', 8080, application)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	48	print 'Serving on port 8080...'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	49	server.serve_forever()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	50
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	51	The WSGIApplication class maps URI regular expressions to your RequestHandler
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	52	classes. It is a WSGI-compatible application object, so you can use it in
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	53	conjunction with wsgiref to make your web application into, e.g., a CGI
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	54	script or a simple HTTP server, as in the example above.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	55
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	56	The framework does not support streaming output. All output from a response
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	57	is stored in memory before it is written.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	58	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	59
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	60
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	61	import cgi
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	62	import StringIO
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	63	import logging
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	64	import re
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	65	import sys
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	66	import traceback
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	67	import urlparse
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	68	import webob
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	69	import wsgiref.headers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	70	import wsgiref.util
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	71
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	72	RE_FIND_GROUPS = re.compile('$.*?$')
297 35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	73	_CHARSET_RE = re.compile(r';\scharset=([^;\s])', re.I)
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	74
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	75	class Error(Exception):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	76	"""Base of all exceptions in the webapp module."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	77	pass
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	78
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	79
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	80	class NoUrlFoundError(Error):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	81	"""Thrown when RequestHandler.get_url() fails."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	82	pass
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	83
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	84
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	85	class Request(webob.Request):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	86	"""Abstraction for an HTTP request.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	87
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	88	Properties:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	89	uri: the complete URI requested by the user
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	90	scheme: 'http' or 'https'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	91	host: the host, including the port
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	92	path: the path up to the ';' or '?' in the URL
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	93	parameters: the part of the URL between the ';' and the '?', if any
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	94	query: the part of the URL after the '?'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	95
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	96	You can access parsed query and POST values with the get() method; do not
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	97	parse the query string yourself.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	98	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	99	uri = property(lambda self: self.url)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	100	query = property(lambda self: self.query_string)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	101
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	102	def __init__(self, environ):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	103	"""Constructs a Request object from a WSGI environment.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	104
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	105	If the charset isn't specified in the Content-Type header, defaults
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	106	to UTF-8.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	107
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	108	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	109	environ: A WSGI-compliant environment dictionary.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	110	"""
297 35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	111	match = _CHARSET_RE.search(environ.get('CONTENT_TYPE', ''))
35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	112	if match:
35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	113	charset = match.group(1).lower()
35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	114	else:
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	115	charset = 'utf-8'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	116
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	117	webob.Request.__init__(self, environ, charset=charset,
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	118	unicode_errors= 'ignore', decode_param_names=True)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	119
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	120	def get(self, argument_name, default_value='', allow_multiple=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	121	"""Returns the query or POST argument with the given name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	122
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	123	We parse the query string and POST payload lazily, so this will be a
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	124	slower operation on the first call.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	125
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	126	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	127	argument_name: the name of the query or POST argument
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	128	default_value: the value to return if the given argument is not present
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	129	allow_multiple: return a list of values with the given name (deprecated)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	130
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	131	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	132	If allow_multiple is False (which it is by default), we return the first
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	133	value with the given name given in the request. If it is True, we always
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	134	return an list.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	135	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	136	param_value = self.get_all(argument_name)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	137	if allow_multiple:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	138	return param_value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	139	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	140	if len(param_value) > 0:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	141	return param_value[0]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	142	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	143	return default_value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	144
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	145	def get_all(self, argument_name):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	146	"""Returns a list of query or POST arguments with the given name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	147
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	148	We parse the query string and POST payload lazily, so this will be a
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	149	slower operation on the first call.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	150
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	151	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	152	argument_name: the name of the query or POST argument
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	153
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	154	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	155	A (possibly empty) list of values.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	156	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	157	if self.charset:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	158	argument_name = argument_name.encode(self.charset)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	159
149 f2e327a7c5de Load ../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: 109 diff changeset	160	param_value = self.params.getall(argument_name)
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	161
149 f2e327a7c5de Load ../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: 109 diff changeset	162	for i in xrange(len(param_value)):
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	163	if isinstance(param_value[i], cgi.FieldStorage):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	164	param_value[i] = param_value[i].value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	165
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	166	return param_value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	167
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	168	def arguments(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	169	"""Returns a list of the arguments provided in the query and/or POST.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	170
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	171	The return value is a list of strings.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	172	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	173	return list(set(self.params.keys()))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	174
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	175	def get_range(self, name, min_value=None, max_value=None, default=0):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	176	"""Parses the given int argument, limiting it to the given range.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	177
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	178	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	179	name: the name of the argument
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	180	min_value: the minimum int value of the argument (if any)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	181	max_value: the maximum int value of the argument (if any)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	182	default: the default value of the argument if it is not given
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	183
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	184	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	185	An int within the given range for the argument
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	186	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	187	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	188	value = int(self.get(name, default))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	189	except ValueError:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	190	value = default
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	191	if max_value != None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	192	value = min(value, max_value)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	193	if min_value != None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	194	value = max(value, min_value)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	195	return value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	196
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	197
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	198	class Response(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	199	"""Abstraction for an HTTP response.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	200
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	201	Properties:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	202	out: file pointer for the output stream
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	203	headers: wsgiref.headers.Headers instance representing the output headers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	204	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	205	def __init__(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	206	"""Constructs a response with the default settings."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	207	self.out = StringIO.StringIO()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	208	self.__wsgi_headers = []
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	209	self.headers = wsgiref.headers.Headers(self.__wsgi_headers)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	210	self.headers['Content-Type'] = 'text/html; charset=utf-8'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	211	self.headers['Cache-Control'] = 'no-cache'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	212	self.set_status(200)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	213
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	214	def set_status(self, code, message=None):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	215	"""Sets the HTTP status code of this response.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	216
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	217	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	218	message: the HTTP status string to use
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	219
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	220	If no status string is given, we use the default from the HTTP/1.1
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	221	specification.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	222	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	223	if not message:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	224	message = Response.http_status_message(code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	225	self.__status = (code, message)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	226
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	227	def clear(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	228	"""Clears all data written to the output stream so that it is empty."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	229	self.out.seek(0)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	230	self.out.truncate(0)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	231
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	232	def wsgi_write(self, start_response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	233	"""Writes this response using WSGI semantics with the given WSGI function.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	234
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	235	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	236	start_response: the WSGI-compatible start_response function
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	237	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	238	body = self.out.getvalue()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	239	if isinstance(body, unicode):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	240	body = body.encode('utf-8')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	241	elif self.headers.get('Content-Type', '').endswith('; charset=utf-8'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	242	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	243	body.decode('utf-8')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	244	except UnicodeError, e:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	245	logging.warning('Response written is not UTF-8: %s', e)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	246
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	247	self.headers['Content-Length'] = str(len(body))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	248	write = start_response('%d %s' % self.__status, self.__wsgi_headers)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	249	write(body)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	250	self.out.close()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	251
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	252	def http_status_message(code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	253	"""Returns the default HTTP status message for the given code.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	254
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	255	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	256	code: the HTTP code for which we want a message
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	257	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	258	if not Response.__HTTP_STATUS_MESSAGES.has_key(code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	259	raise Error('Invalid HTTP status code: %d' % code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	260	return Response.__HTTP_STATUS_MESSAGES[code]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	261	http_status_message = staticmethod(http_status_message)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	262
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	263	__HTTP_STATUS_MESSAGES = {
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	264	100: 'Continue',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	265	101: 'Switching Protocols',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	266	200: 'OK',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	267	201: 'Created',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	268	202: 'Accepted',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	269	203: 'Non-Authoritative Information',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	270	204: 'No Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	271	205: 'Reset Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	272	206: 'Partial Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	273	300: 'Multiple Choices',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	274	301: 'Moved Permanently',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	275	302: 'Moved Temporarily',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	276	303: 'See Other',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	277	304: 'Not Modified',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	278	305: 'Use Proxy',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	279	306: 'Unused',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	280	307: 'Temporary Redirect',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	281	400: 'Bad Request',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	282	401: 'Unauthorized',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	283	402: 'Payment Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	284	403: 'Forbidden',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	285	404: 'Not Found',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	286	405: 'Method Not Allowed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	287	406: 'Not Acceptable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	288	407: 'Proxy Authentication Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	289	408: 'Request Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	290	409: 'Conflict',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	291	410: 'Gone',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	292	411: 'Length Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	293	412: 'Precondition Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	294	413: 'Request Entity Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	295	414: 'Request-URI Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	296	415: 'Unsupported Media Type',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	297	416: 'Requested Range Not Satisfiable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	298	417: 'Expectation Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	299	500: 'Internal Server Error',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	300	501: 'Not Implemented',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	301	502: 'Bad Gateway',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	302	503: 'Service Unavailable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	303	504: 'Gateway Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	304	505: 'HTTP Version not supported'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	305	}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	306
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	307
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	308	class RequestHandler(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	309	"""Our base HTTP request handler. Clients should subclass this class.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	310
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	311	Subclasses should override get(), post(), head(), options(), etc to handle
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	312	different HTTP methods.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	313	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	314	def initialize(self, request, response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	315	"""Initializes this request handler with the given Request and Response."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	316	self.request = request
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	317	self.response = response
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	318
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	319	def get(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	320	"""Handler method for GET requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	321	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	322
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	323	def post(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	324	"""Handler method for POST requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	325	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	326
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	327	def head(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	328	"""Handler method for HEAD requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	329	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	330
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	331	def options(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	332	"""Handler method for OPTIONS requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	333	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	334
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	335	def put(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	336	"""Handler method for PUT requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	337	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	338
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	339	def delete(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	340	"""Handler method for DELETE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	341	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	342
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	343	def trace(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	344	"""Handler method for TRACE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	345	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	346
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	347	def error(self, code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	348	"""Clears the response output stream and sets the given HTTP error code.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	349
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	350	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	351	code: the HTTP status error code (e.g., 501)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	352	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	353	self.response.set_status(code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	354	self.response.clear()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	355
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	356	def redirect(self, uri, permanent=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	357	"""Issues an HTTP redirect to the given relative URL.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	358
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	359	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	360	uri: a relative or absolute URI (e.g., '../flowers.html')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	361	permanent: if true, we use a 301 redirect instead of a 302 redirect
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	362	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	363	if permanent:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	364	self.response.set_status(301)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	365	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	366	self.response.set_status(302)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	367	absolute_url = urlparse.urljoin(self.request.uri, uri)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	368	self.response.headers['Location'] = str(absolute_url)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	369	self.response.clear()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	370
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	371	def handle_exception(self, exception, debug_mode):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	372	"""Called if this handler throws an exception during execution.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	373
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	374	The default behavior is to call self.error(500) and print a stack trace
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	375	if debug_mode is True.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	376
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	377	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	378	exception: the exception that was thrown
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	379	debug_mode: True if the web application is running in debug mode
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	380	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	381	self.error(500)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	382	lines = ''.join(traceback.format_exception(*sys.exc_info()))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	383	logging.error(lines)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	384	if debug_mode:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	385	self.response.clear()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	386	self.response.headers['Content-Type'] = 'text/plain'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	387	self.response.out.write(lines)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	388
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	389	@classmethod
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	390	def get_url(cls, args, *kargs):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	391	"""Returns the url for the given handler.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	392
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	393	The default implementation uses the patterns passed to the active
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	394	WSGIApplication and the django urlresolvers module to create a url.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	395	However, it is different from urlresolvers.reverse() in the following ways:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	396	- It does not try to resolve handlers via module loading
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	397	- It does not support named arguments
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	398	- It performs some post-prosessing on the url to remove some regex
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	399	operators that urlresolvers.reverse_helper() seems to miss.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	400	- It will try to fill in the left-most missing arguments with the args
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	401	used in the active request.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	402
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	403	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	404	args: Parameters for the url pattern's groups.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	405	kwargs: Optionally contains 'implicit_args' that can either be a boolean
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	406	or a tuple. When it is True, it will use the arguments to the
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	407	active request as implicit arguments. When it is False (default),
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	408	it will not use any implicit arguments. When it is a tuple, it
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	409	will use the tuple as the implicit arguments.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	410	the left-most args if some are missing from args.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	411
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	412	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	413	The url for this handler/args combination.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	414
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	415	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	416	NoUrlFoundError: No url pattern for this handler has the same
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	417	number of args that were passed in.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	418	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	419
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	420	app = WSGIApplication.active_instance
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	421	pattern_map = app._pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	422
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	423	implicit_args = kargs.get('implicit_args', ())
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	424	if implicit_args == True:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	425	implicit_args = app.current_request_args
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	426
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	427	min_params = len(args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	428
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	429	urlresolvers = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	430
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	431	for pattern_tuple in pattern_map.get(cls, ()):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	432	num_params_in_pattern = pattern_tuple[1]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	433	if num_params_in_pattern < min_params:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	434	continue
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	435
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	436	if urlresolvers is None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	437	from django.core import urlresolvers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	438
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	439	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	440	num_implicit_args = max(0, num_params_in_pattern - len(args))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	441	merged_args = implicit_args[:num_implicit_args] + args
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	442	url = urlresolvers.reverse_helper(pattern_tuple[0], *merged_args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	443	url = url.replace('\\', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	444	url = url.replace('?', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	445	return url
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	446	except urlresolvers.NoReverseMatch:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	447	continue
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	448
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	449	logging.warning('get_url failed for Handler name: %r, Args: %r',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	450	cls.__name__, args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	451	raise NoUrlFoundError
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	452
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	453
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	454	class WSGIApplication(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	455	"""Wraps a set of webapp RequestHandlers in a WSGI-compatible application.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	456
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	457	To use this class, pass a list of (URI regular expression, RequestHandler)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	458	pairs to the constructor, and pass the class instance to a WSGI handler.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	459	See the example in the module comments for details.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	460
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	461	The URL mapping is first-match based on the list ordering.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	462	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	463
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	464	def __init__(self, url_mapping, debug=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	465	"""Initializes this application with the given URL mapping.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	466
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	467	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	468	url_mapping: list of (URI, RequestHandler) pairs (e.g., [('/', ReqHan)])
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	469	debug: if true, we send Python stack traces to the browser on errors
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	470	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	471	self._init_url_mappings(url_mapping)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	472	self.__debug = debug
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	473	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	474	self.current_request_args = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	475
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	476	def __call__(self, environ, start_response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	477	"""Called by WSGI when a request comes in."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	478	request = Request(environ)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	479	response = Response()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	480
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	481	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	482
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	483	handler = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	484	groups = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	485	for regexp, handler_class in self._url_mapping:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	486	match = regexp.match(request.path)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	487	if match:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	488	handler = handler_class()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	489	handler.initialize(request, response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	490	groups = match.groups()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	491	break
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	492
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	493	self.current_request_args = groups
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	494
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	495	if handler:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	496	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	497	method = environ['REQUEST_METHOD']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	498	if method == 'GET':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	499	handler.get(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	500	elif method == 'POST':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	501	handler.post(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	502	elif method == 'HEAD':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	503	handler.head(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	504	elif method == 'OPTIONS':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	505	handler.options(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	506	elif method == 'PUT':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	507	handler.put(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	508	elif method == 'DELETE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	509	handler.delete(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	510	elif method == 'TRACE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	511	handler.trace(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	512	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	513	handler.error(501)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	514	except Exception, e:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	515	handler.handle_exception(e, self.__debug)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	516	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	517	response.set_status(404)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	518
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	519	response.wsgi_write(start_response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	520	return ['']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	521
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	522	def _init_url_mappings(self, handler_tuples):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	523	"""Initializes the maps needed for mapping urls to handlers and handlers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	524	to urls.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	525
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	526	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	527	handler_tuples: list of (URI, RequestHandler) pairs.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	528	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	529
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	530	handler_map = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	531	pattern_map = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	532	url_mapping = []
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	533
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	534	for regexp, handler in handler_tuples:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	535
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	536	handler_map[handler.__name__] = handler
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	537
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	538	if not regexp.startswith('^'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	539	regexp = '^' + regexp
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	540	if not regexp.endswith('$'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	541	regexp += '$'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	542
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	543	compiled = re.compile(regexp)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	544	url_mapping.append((compiled, handler))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	545
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	546	num_groups = len(RE_FIND_GROUPS.findall(regexp))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	547	handler_patterns = pattern_map.setdefault(handler, [])
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	548	handler_patterns.append((compiled, num_groups))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	549
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	550	self._handler_map = handler_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	551	self._pattern_map = pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	552	self._url_mapping = url_mapping
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	553
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	554	def get_registered_handler_by_name(self, handler_name):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	555	"""Returns the handler given the handler's name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	556
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	557	This uses the application's url mapping.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	558
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	559	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	560	handler_name: The __name__ of a handler to return.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	561
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	562	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	563	The handler with the given name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	564
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	565	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	566	KeyError: If the handler name is not found in the parent application.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	567	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	568	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	569	return self._handler_map[handler_name]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	570	except:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	571	logging.error('Handler does not map to any urls: %s', handler_name)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	572	raise

author	Pawel Solyga <Pawel.Solyga@gmail.com>
	Fri, 10 Oct 2008 13:14:24 +0000
changeset 297	35211afcd563
parent 149	f2e327a7c5de
child 828	f5fd65cc3bf3
permissions	-rwxr-xr-x