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
2864 2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	250	if (self.headers.get('Cache-Control') == 'no-cache' and
2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	251	not self.headers.get('Expires')):
2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	252	self.headers['Expires'] = 'Fri, 01 Jan 1990 00:00:00 GMT'
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	253	self.headers['Content-Length'] = str(len(body))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	254	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	255	write(body)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	256	self.out.close()
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	def http_status_message(code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	259	"""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	260
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	261	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	262	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	263	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	264	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	265	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	266	return Response.__HTTP_STATUS_MESSAGES[code]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	267	http_status_message = staticmethod(http_status_message)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	268
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	269	__HTTP_STATUS_MESSAGES = {
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	270	100: 'Continue',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	271	101: 'Switching Protocols',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	272	200: 'OK',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	273	201: 'Created',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	274	202: 'Accepted',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	275	203: 'Non-Authoritative Information',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	276	204: 'No Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	277	205: 'Reset Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	278	206: 'Partial Content',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	279	300: 'Multiple Choices',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	280	301: 'Moved Permanently',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	281	302: 'Moved Temporarily',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	282	303: 'See Other',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	283	304: 'Not Modified',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	284	305: 'Use Proxy',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	285	306: 'Unused',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	286	307: 'Temporary Redirect',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	287	400: 'Bad Request',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	288	401: 'Unauthorized',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	289	402: 'Payment Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	290	403: 'Forbidden',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	291	404: 'Not Found',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	292	405: 'Method Not Allowed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	293	406: 'Not Acceptable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	294	407: 'Proxy Authentication Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	295	408: 'Request Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	296	409: 'Conflict',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	297	410: 'Gone',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	298	411: 'Length Required',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	299	412: 'Precondition Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	300	413: 'Request Entity Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	301	414: 'Request-URI Too Large',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	302	415: 'Unsupported Media Type',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	303	416: 'Requested Range Not Satisfiable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	304	417: 'Expectation Failed',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	305	500: 'Internal Server Error',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	306	501: 'Not Implemented',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	307	502: 'Bad Gateway',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	308	503: 'Service Unavailable',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	309	504: 'Gateway Time-out',
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	310	505: 'HTTP Version not supported'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	311	}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	312
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	class RequestHandler(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	315	"""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	316
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	317	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	318	different HTTP methods.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	319	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	320	def initialize(self, request, response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	321	"""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	322	self.request = request
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	323	self.response = response
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	324
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	325	def get(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	326	"""Handler method for GET requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	327	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	328
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	329	def post(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	330	"""Handler method for POST requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	331	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	332
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	333	def head(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	334	"""Handler method for HEAD requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	335	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	336
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	337	def options(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	338	"""Handler method for OPTIONS requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	339	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	340
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	341	def put(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	342	"""Handler method for PUT requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	343	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	344
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	345	def delete(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	346	"""Handler method for DELETE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	347	self.error(405)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	348
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	349	def trace(self, *args):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	350	"""Handler method for TRACE requests."""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	351	self.error(405)
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	def error(self, code):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	354	"""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	355
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	356	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	357	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	358	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	359	self.response.set_status(code)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	360	self.response.clear()
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	def redirect(self, uri, permanent=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	363	"""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	364
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	365	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	366	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	367	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	368	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	369	if permanent:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	370	self.response.set_status(301)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	371	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	372	self.response.set_status(302)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	373	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	374	self.response.headers['Location'] = str(absolute_url)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	375	self.response.clear()
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	def handle_exception(self, exception, debug_mode):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	378	"""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	379
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	380	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	381	if debug_mode is True.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	382
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	383	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	384	exception: the exception that was thrown
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	385	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	386	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	387	self.error(500)
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	388	logging.exception(exception)
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	389	if debug_mode:
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	390	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	391	self.response.clear()
828 f5fd65cc3bf3 Load /Users/solydzajs/Downloads/google_appengine into Pawel Solyga <Pawel.Solyga@gmail.com> parents: 297 diff changeset	392	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	393
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	394	@classmethod
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	395	def get_url(cls, args, *kargs):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	396	"""Returns the url for the given handler.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	397
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	398	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	399	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	400	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	401	- 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	402	- It does not support named arguments
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	403	- 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	404	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	405	- 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	406	used in the active request.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	407
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	408	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	409	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	410	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	411	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	412	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	413	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	414	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	415	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	416
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	417	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	418	The url for this handler/args combination.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	419
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	420	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	421	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	422	number of args that were passed in.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	423	"""
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	app = WSGIApplication.active_instance
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	426	pattern_map = app._pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	427
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	428	implicit_args = kargs.get('implicit_args', ())
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	429	if implicit_args == True:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	430	implicit_args = app.current_request_args
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	431
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	432	min_params = len(args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	433
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	434	urlresolvers = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	435
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	436	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	437	num_params_in_pattern = pattern_tuple[1]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	438	if num_params_in_pattern < min_params:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	439	continue
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	if urlresolvers is None:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	442	from django.core import urlresolvers
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	443
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	444	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	445	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	446	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	447	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	448	url = url.replace('\\', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	449	url = url.replace('?', '')
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	450	return url
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	451	except urlresolvers.NoReverseMatch:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	452	continue
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	453
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	454	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	455	cls.__name__, args)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	456	raise NoUrlFoundError
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	457
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	class WSGIApplication(object):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	460	"""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	461
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	462	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	463	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	464	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	465
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	466	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	467	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	468
2864 2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	469	REQUEST_CLASS = Request
2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	470	RESPONSE_CLASS = Response
2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	471
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	472	def __init__(self, url_mapping, debug=False):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	473	"""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	474
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	475	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	476	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	477	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	478	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	479	self._init_url_mappings(url_mapping)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	480	self.__debug = debug
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	481	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	482	self.current_request_args = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	483
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	484	def __call__(self, environ, start_response):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	485	"""Called by WSGI when a request comes in."""
2864 2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	486	request = self.REQUEST_CLASS(environ)
2e0b0af889be Update Google App Engine from 1.2.3 to 1.2.5 in thirdparty folder. Pawel Solyga <Pawel.Solyga@gmail.com> parents: 2273 diff changeset	487	response = self.RESPONSE_CLASS()
109 620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	488
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	489	WSGIApplication.active_instance = self
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	490
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	491	handler = None
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	492	groups = ()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	493	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	494	match = regexp.match(request.path)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	495	if match:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	496	handler = handler_class()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	497	handler.initialize(request, response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	498	groups = match.groups()
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	499	break
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	500
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	501	self.current_request_args = groups
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	502
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	503	if handler:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	504	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	505	method = environ['REQUEST_METHOD']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	506	if method == 'GET':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	507	handler.get(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	508	elif method == 'POST':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	509	handler.post(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	510	elif method == 'HEAD':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	511	handler.head(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	512	elif method == 'OPTIONS':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	513	handler.options(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	514	elif method == 'PUT':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	515	handler.put(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	516	elif method == 'DELETE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	517	handler.delete(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	518	elif method == 'TRACE':
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	519	handler.trace(*groups)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	520	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	521	handler.error(501)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	522	except Exception, e:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	523	handler.handle_exception(e, self.__debug)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	524	else:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	525	response.set_status(404)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	526
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	527	response.wsgi_write(start_response)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	528	return ['']
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	529
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	530	def _init_url_mappings(self, handler_tuples):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	531	"""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	532	to urls.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	533
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	534	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	535	handler_tuples: list of (URI, RequestHandler) pairs.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	536	"""
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 = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	539	pattern_map = {}
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	540	url_mapping = []
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	541
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	542	for regexp, handler in handler_tuples:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	543
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	544	handler_map[handler.__name__] = handler
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	545
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	546	if not regexp.startswith('^'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	547	regexp = '^' + regexp
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	548	if not regexp.endswith('$'):
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	549	regexp += '$'
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	550
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	551	compiled = re.compile(regexp)
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	552	url_mapping.append((compiled, handler))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	553
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	554	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	555	handler_patterns = pattern_map.setdefault(handler, [])
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	556	handler_patterns.append((compiled, num_groups))
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	557
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	558	self._handler_map = handler_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	559	self._pattern_map = pattern_map
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	560	self._url_mapping = url_mapping
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	561
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	562	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	563	"""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	564
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	565	This uses the application's url mapping.
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	Args:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	568	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	569
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	570	Returns:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	571	The handler with the given name.
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	572
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	573	Raises:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	574	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	575	"""
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	576	try:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	577	return self._handler_map[handler_name]
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	578	except:
620f9b141567 Load ../../google_appengine into trunk/thirdparty/google_appengine. Todd Larsen <tlarsen@google.com> parents: diff changeset	579	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	580	raise

author	Mario Ferraro <fadinlight@gmail.com>
	Sun, 15 Nov 2009 22:12:20 +0100
changeset 3093	d1be59b6b627
parent 2864	2e0b0af889be
permissions	-rwxr-xr-x