tacker.wsgi module

Utility methods for working with WSGI servers

class tacker.wsgi.ActionDispatcher

Bases: object

Maps method name to local methods through action name.

default(data)
dispatch(*args, **kwargs)

Find and call local method.

class tacker.wsgi.Application

Bases: object

Base WSGI application wrapper. Subclasses need to implement __call__.

classmethod factory(global_config, **local_config)

Used for paste app factories in paste.deploy config files.

Any local configuration (that is, values under the [app:APPNAME] section of the paste config) will be passed into the __init__ method as kwargs.

A hypothetical configuration would look like:

[app:wadl] latest_version = 1.3 paste.app_factory = nova.api.fancy_api:Wadl.factory

which would result in a call to the Wadl class as

import tacker.api.fancy_api fancy_api.Wadl(latest_version=’1.3’)

You could of course re-implement the factory method in subclasses, but using the kwarg passing it shouldn’t be necessary.

class tacker.wsgi.Controller

Bases: object

WSGI app that dispatched to methods.

WSGI app that reads routing information supplied by RoutesMiddleware and calls the requested action method upon itself. All action methods must, in addition to their normal parameters, accept a ‘req’ argument which is the incoming wsgi.Request. They raise a webob.exc exception, or return a dict which will be serialized by requested content type.

class tacker.wsgi.Debug(application)

Bases: Middleware

Middleware for debugging.

Helper class that can be inserted into any WSGI application chain to get information about the request and response.

static print_generator(app_iter)

Print contents of a wrapper string iterator when iterated.

class tacker.wsgi.DefaultMethodController

Bases: object

Controller that handles the OPTIONS request method.

This controller handles the OPTIONS request method and any of the HTTP methods that are not explicitly implemented by the application.

options(request, **kwargs)

Return a response that includes the ‘Allow’ header.

Return a response that includes the ‘Allow’ header listing the methods that are implemented. A 204 status code is used for this response.

reject(request, **kwargs)

Return a 405 method not allowed error.

As a convenience, the ‘Allow’ header with the list of implemented methods is included in the response as well.

class tacker.wsgi.DictSerializer

Bases: ActionDispatcher

Default request body serialization.

default(data)
serialize(data, action='default')
exception tacker.wsgi.Fault(exception)

Bases: HTTPException

Wrap webob.exc.HTTPException to provide API friendly response.

class tacker.wsgi.JSONDeserializer

Bases: TextDeserializer

default(datastring)
class tacker.wsgi.JSONDictSerializer

Bases: DictSerializer

Default JSON request body serialization.

default(data)
class tacker.wsgi.Middleware(application)

Bases: object

Base WSGI middleware wrapper.

These classes require an application to be initialized that will be called next. By default the middleware will simply call its wrapped app, or you can override __call__ to customize its behavior.

classmethod factory(global_config, **local_config)

Used for paste app factories in paste.deploy config files.

Any local configuration (that is, values under the [filter:APPNAME] section of the paste config) will be passed into the __init__ method as kwargs.

A hypothetical configuration would look like:

[filter:analytics] redis_host = 127.0.0.1 paste.filter_factory = nova.api.analytics:Analytics.factory

which would result in a call to the Analytics class as

import nova.api.analytics analytics.Analytics(app_from_paste, redis_host=’127.0.0.1’)

You could of course re-implement the factory method in subclasses, but using the kwarg passing it shouldn’t be necessary.

process_request(req)

Called on each request.

If this returns None, the next application down the stack will be executed. If it returns a response then that response will be returned and execution will stop here.

process_response(response)

Do whatever you’d like to the response.

class tacker.wsgi.Request(environ, charset=None, unicode_errors=None, decode_param_names=None, **kw)

Bases: Request

best_match_content_type()

Determine the most acceptable content-type.

Based on:
  1. URI extension (.json)

  2. Content-type header

  3. Accept* headers

best_match_language()

Determines best available locale from the Accept-Language header.

Returns:

the best language match or None if the ‘Accept-Language’ header was not available in the request.

property context
get_content_type()
class tacker.wsgi.RequestDeserializer(body_deserializers=None, headers_deserializer=None)

Bases: object

Break up a Request object into more useful pieces.

deserialize(request)

Extract necessary pieces of the request.

Parameters:

request – Request object

Returns:

tuple of expected controller action name, dictionary of keyword arguments to pass to the controller, the expected content type of the response

deserialize_body(request, action)
deserialize_headers(request, action)
get_action_args(request_environment)

Parse dictionary created by routes library.

get_body_deserializer(content_type)
get_expected_content_type(request)
class tacker.wsgi.RequestHeadersDeserializer

Bases: ActionDispatcher

Default request headers deserializer.

default(request)
deserialize(request, action)
class tacker.wsgi.Resource(controller, deserializer=None, serializer=None)

Bases: Application

WSGI app that handles (de)serialization and controller dispatch.

WSGI app that reads routing information supplied by RoutesMiddleware and calls the requested action method upon its controller. All controller action methods must accept a ‘req’ argument, which is the incoming wsgi.Request. If the operation is a PUT or POST, the controller method must also accept a ‘body’ argument (the deserialized request body). They may raise a webob.exc exception or return a dict, which will be serialized by requested content type.

dispatch(request, action, action_args)

Find action-spefic method on controller and call it.

class tacker.wsgi.ResourceExceptionHandler

Bases: object

Context manager to handle Resource exceptions.

Used when processing exceptions generated by API implementation methods. Converts most exceptions to Fault exceptions, with the appropriate logging.

class tacker.wsgi.ResponseHeaderSerializer

Bases: ActionDispatcher

Default response headers serialization.

default(response, data)
serialize(response, data, action)
class tacker.wsgi.ResponseObject(obj, code=None, headers=None)

Bases: object

Bundles a response object

Object that app methods may return in order to allow its response to be modified by extensions in the code. Its use is optional (and should only be used if you really know what you are doing).

property code

Retrieve the response status.

property headers

Retrieve the headers.

serialize(request, content_type)

Serializes the wrapped object.

Utility method for serializing the wrapped object. Returns a webob.Response object.

Header values are set to the appropriate Python type and encoding demanded by PEP 3333: whatever the native str type is.

class tacker.wsgi.ResponseSerializer(body_serializers=None, headers_serializer=None)

Bases: object

Encode the necessary pieces into a response object.

get_body_serializer(content_type)
serialize(response_data, content_type, action='default')

Serialize a dict into a string and wrap in a wsgi.Request object.

Parameters:
  • response_data – dict produced by the Controller

  • content_type – expected mimetype of serialized response body

serialize_body(response, data, content_type, action)
serialize_headers(response, data, action)
class tacker.wsgi.Router(mapper)

Bases: object

WSGI middleware that maps incoming requests to WSGI apps.

classmethod factory(global_config, **local_config)

Return an instance of the WSGI Router class.

class tacker.wsgi.Serializer(metadata=None)

Bases: object

Serializes and deserializes dictionaries to certain MIME types.

deserialize(datastring, content_type)

Deserialize a string to a dictionary.

The string must be in the format of a supported MIME type.

get_deserialize_handler(content_type)
serialize(data, content_type)

Serialize a dictionary into the specified content type.

class tacker.wsgi.Server(name, threads=1000)

Bases: object

Server class to manage multiple WSGI sockets and applications.

property host
property port
start(application, port, host='0.0.0.0')

Run a WSGI server with the given application.

stop()
wait()

Wait until all servers have completed running.

class tacker.wsgi.TextDeserializer

Bases: ActionDispatcher

Default request body deserialization.

default(datastring)
deserialize(datastring, action='default')
class tacker.wsgi.ZipDeserializer

Bases: ActionDispatcher

default(body_file)
deserialize(body_file, action='default')
tacker.wsgi.config_opts()
tacker.wsgi.deprecate_legacy_warning(req)
tacker.wsgi.encode_body(body)

Encode unicode body.

WebOb requires to encode unicode body used to update response body.

tacker.wsgi.expected_errors(errors)

Decorator for Restful API methods which specifies expected exceptions.

Specify which exceptions may occur when an API method is called. If an unexpected exception occurs then return a 500 instead and ask the user of the API to file a bug report.

tacker.wsgi.response(code)

Attaches response code to a method.

This decorator associates a response code with a method. Note that the function attributes are directly manipulated; the method is not wrapped.