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	"""
2273 e4cb9c53db3e Load /Users/solydzajs/Desktop/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 828 diff changeset	99
e4cb9c53db3e Load /Users/solydzajs/Desktop/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 828 diff changeset	100	request_body_tempfile_limit = 0
e4cb9c53db3e Load /Users/solydzajs/Desktop/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 828 diff changeset	101
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	102	uri = property(lambda self: self.url)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	103	query = property(lambda self: self.query_string)
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	def __init__(self, environ):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	106	"""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	107
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	108	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	109	to UTF-8.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	110
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	111	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	112	environ: A WSGI-compliant environment dictionary.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	113	"""
297 35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	114	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	115	if match:
35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	116	charset = match.group(1).lower()
35211afcd563 Load /Users/solydzajs/Downloads/google_appengine/ into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 149 diff changeset	117	else:
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	118	charset = 'utf-8'
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	webob.Request.__init__(self, environ, charset=charset,
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	121	unicode_errors= 'ignore', decode_param_names=True)
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	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	124	"""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	125
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	126	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	127	slower operation on the first call.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	128
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	129	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	130	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	131	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	132	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	133
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	134	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	135	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	136	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	137	return an list.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	138	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	139	param_value = self.get_all(argument_name)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	140	if allow_multiple:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	141	return param_value
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	if len(param_value) > 0:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	144	return param_value[0]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	145	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	146	return default_value
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	def get_all(self, argument_name):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	149	"""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	150
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	151	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	152	slower operation on the first call.
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	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	155	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	156
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	157	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	158	A (possibly empty) list of values.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	159	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	160	if self.charset:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	161	argument_name = argument_name.encode(self.charset)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	162
149 f2e327a7c5de Load ../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: 109 diff changeset	163	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	164
149 f2e327a7c5de Load ../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: 109 diff changeset	165	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	166	if isinstance(param_value[i], cgi.FieldStorage):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	167	param_value[i] = param_value[i].value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	168
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	169	return param_value
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	def arguments(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	172	"""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	173
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	174	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	175	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	176	return list(set(self.params.keys()))
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	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	179	"""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	180
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	181	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	182	name: the name of the argument
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	183	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	184	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	185	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	186
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	187	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	188	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	189	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	190	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	191	value = int(self.get(name, default))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	192	except ValueError:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	193	value = default
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	194	if max_value != None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	195	value = min(value, max_value)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	196	if min_value != None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	197	value = max(value, min_value)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	198	return value
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	199
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	class Response(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	202	"""Abstraction for an HTTP response.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	203
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	204	Properties:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	205	out: file pointer for the output stream
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	206	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	207	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	208	def __init__(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	209	"""Constructs a response with the default settings."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	210	self.out = StringIO.StringIO()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	211	self.__wsgi_headers = []
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	212	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	213	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	214	self.headers['Cache-Control'] = 'no-cache'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	215	self.set_status(200)
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	def set_status(self, code, message=None):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	218	"""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	219
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	220	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	221	message: the HTTP status string to use
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 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	224	specification.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	225	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	226	if not message:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	227	message = Response.http_status_message(code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	228	self.__status = (code, message)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	229
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	230	def clear(self):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	231	"""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	232	self.out.seek(0)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	233	self.out.truncate(0)
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	def wsgi_write(self, start_response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	236	"""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	237
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	238	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	239	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	240	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	241	body = self.out.getvalue()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	242	if isinstance(body, unicode):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	243	body = body.encode('utf-8')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	244	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	245	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	246	body.decode('utf-8')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	247	except UnicodeError, e:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	248	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	249
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	250	self.headers['Content-Length'] = str(len(body))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	251	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	252	write(body)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	253	self.out.close()
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	def http_status_message(code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	256	"""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	257
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	258	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	259	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	260	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	261	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	262	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	263	return Response.__HTTP_STATUS_MESSAGES[code]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	264	http_status_message = staticmethod(http_status_message)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	265
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	266	__HTTP_STATUS_MESSAGES = {
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	267	100: 'Continue',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	268	101: 'Switching Protocols',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	269	200: 'OK',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	270	201: 'Created',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	271	202: 'Accepted',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	272	203: 'Non-Authoritative Information',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	273	204: 'No Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	274	205: 'Reset Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	275	206: 'Partial Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	276	300: 'Multiple Choices',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	277	301: 'Moved Permanently',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	278	302: 'Moved Temporarily',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	279	303: 'See Other',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	280	304: 'Not Modified',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	281	305: 'Use Proxy',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	282	306: 'Unused',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	283	307: 'Temporary Redirect',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	284	400: 'Bad Request',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	285	401: 'Unauthorized',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	286	402: 'Payment Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	287	403: 'Forbidden',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	288	404: 'Not Found',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	289	405: 'Method Not Allowed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	290	406: 'Not Acceptable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	291	407: 'Proxy Authentication Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	292	408: 'Request Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	293	409: 'Conflict',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	294	410: 'Gone',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	295	411: 'Length Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	296	412: 'Precondition Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	297	413: 'Request Entity Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	298	414: 'Request-URI Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	299	415: 'Unsupported Media Type',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	300	416: 'Requested Range Not Satisfiable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	301	417: 'Expectation Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	302	500: 'Internal Server Error',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	303	501: 'Not Implemented',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	304	502: 'Bad Gateway',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	305	503: 'Service Unavailable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	306	504: 'Gateway Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	307	505: 'HTTP Version not supported'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	308	}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	309
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	class RequestHandler(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	312	"""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	313
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	314	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	315	different HTTP methods.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	316	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	317	def initialize(self, request, response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	318	"""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	319	self.request = request
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	320	self.response = response
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	321
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	322	def get(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	323	"""Handler method for GET requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	324	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	325
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	326	def post(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	327	"""Handler method for POST requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	328	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	329
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	330	def head(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	331	"""Handler method for HEAD requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	332	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	333
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	334	def options(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	335	"""Handler method for OPTIONS requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	336	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	337
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	338	def put(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	339	"""Handler method for PUT requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	340	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	341
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	342	def delete(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	343	"""Handler method for DELETE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	344	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	345
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	346	def trace(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	347	"""Handler method for TRACE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	348	self.error(405)
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	def error(self, code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	351	"""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	352
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	353	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	354	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	355	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	356	self.response.set_status(code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	357	self.response.clear()
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	def redirect(self, uri, permanent=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	360	"""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	361
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	362	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	363	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	364	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	365	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	366	if permanent:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	367	self.response.set_status(301)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	368	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	369	self.response.set_status(302)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	370	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	371	self.response.headers['Location'] = str(absolute_url)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	372	self.response.clear()
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	def handle_exception(self, exception, debug_mode):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	375	"""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	376
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	377	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	378	if debug_mode is True.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	379
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	380	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	381	exception: the exception that was thrown
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	382	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	383	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	384	self.error(500)
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	385	logging.exception(exception)
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	386	if debug_mode:
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	387	lines = ''.join(traceback.format_exception(*sys.exc_info()))
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	388	self.response.clear()
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	389	self.response.out.write('<pre>%s</pre>' % (cgi.escape(lines, quote=True)))
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	390
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	391	@classmethod
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	392	def get_url(cls, args, *kargs):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	393	"""Returns the url for the given handler.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	394
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	395	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	396	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	397	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	398	- 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	399	- It does not support named arguments
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	400	- 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	401	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	402	- 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	403	used in the active request.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	404
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	405	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	406	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	407	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	408	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	409	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	410	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	411	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	412	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	413
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	414	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	415	The url for this handler/args combination.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	416
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	417	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	418	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	419	number of args that were passed in.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	420	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	421
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	422	app = WSGIApplication.active_instance
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	423	pattern_map = app._pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	424
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	425	implicit_args = kargs.get('implicit_args', ())
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	426	if implicit_args == True:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	427	implicit_args = app.current_request_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	min_params = len(args)
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	urlresolvers = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	432
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	433	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	434	num_params_in_pattern = pattern_tuple[1]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	435	if num_params_in_pattern < min_params:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	436	continue
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	437
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	438	if urlresolvers is None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	439	from django.core import urlresolvers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	440
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	441	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	442	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	443	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	444	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	445	url = url.replace('\\', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	446	url = url.replace('?', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	447	return url
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	448	except urlresolvers.NoReverseMatch:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	449	continue
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	450
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	451	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	452	cls.__name__, args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	453	raise NoUrlFoundError
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	454
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	455
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	456	class WSGIApplication(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	457	"""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	458
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	459	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	460	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	461	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	462
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	463	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	464	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	465
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	466	def __init__(self, url_mapping, debug=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	467	"""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	468
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	469	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	470	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	471	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	472	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	473	self._init_url_mappings(url_mapping)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	474	self.__debug = debug
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	475	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	476	self.current_request_args = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	477
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	478	def __call__(self, environ, start_response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	479	"""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	480	request = Request(environ)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	481	response = Response()
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	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	484
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	485	handler = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	486	groups = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	487	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	488	match = regexp.match(request.path)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	489	if match:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	490	handler = handler_class()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	491	handler.initialize(request, response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	492	groups = match.groups()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	493	break
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	self.current_request_args = groups
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	496
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	497	if handler:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	498	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	499	method = environ['REQUEST_METHOD']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	500	if method == 'GET':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	501	handler.get(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	502	elif method == 'POST':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	503	handler.post(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	504	elif method == 'HEAD':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	505	handler.head(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	506	elif method == 'OPTIONS':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	507	handler.options(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	508	elif method == 'PUT':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	509	handler.put(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	510	elif method == 'DELETE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	511	handler.delete(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	512	elif method == 'TRACE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	513	handler.trace(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	514	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	515	handler.error(501)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	516	except Exception, e:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	517	handler.handle_exception(e, self.__debug)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	518	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	519	response.set_status(404)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	520
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	521	response.wsgi_write(start_response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	522	return ['']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	523
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	524	def _init_url_mappings(self, handler_tuples):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	525	"""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	526	to urls.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	527
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	528	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	529	handler_tuples: list of (URI, RequestHandler) pairs.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	530	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	531
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	532	handler_map = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	533	pattern_map = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	534	url_mapping = []
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	for regexp, handler in handler_tuples:
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	handler_map[handler.__name__] = handler
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	539
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	540	if not regexp.startswith('^'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	541	regexp = '^' + regexp
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	542	if not regexp.endswith('$'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	543	regexp += '$'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	544
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	545	compiled = re.compile(regexp)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	546	url_mapping.append((compiled, handler))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	547
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	548	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	549	handler_patterns = pattern_map.setdefault(handler, [])
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	550	handler_patterns.append((compiled, num_groups))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	551
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	552	self._handler_map = handler_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	553	self._pattern_map = pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	554	self._url_mapping = url_mapping
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	555
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	556	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	557	"""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	558
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	559	This uses the application's url mapping.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	560
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	561	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	562	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	563
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	564	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	565	The handler with the given name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	566
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	567	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	568	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	569	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	570	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	571	return self._handler_map[handler_name]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	572	except:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	573	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	574	raise

author	Pawel Solyga <Pawel.Solyga@gmail.com>
	Fri, 24 Apr 2009 14:16:00 +0000
changeset 2273	e4cb9c53db3e
parent 828	f5fd65cc3bf3
child 2864	2e0b0af889be
permissions	-rwxr-xr-x