Hooks

Hooks in general the way to override amend the exist functionality of app. Even you could extend the app, sometimes much easier if you attach a hook like authentication hook and the will process the request, make request.auth available. But also you can create your own hook handling special header values or give special error handling strategy.

The Hook class provide the skeleton of any further hooks.

class pyrs.resource.hooks.Hook[source]

Bases: object

Hooks help to extend the functionality of application. The 3 hooks executed in different time of execution. This class should be the base class of any further hook.

exception(request, exception)[source]

If the function raise any exception it can be handled with this hook. return will be used as response if it gives back any (should be Response instance or None)

request(request)[source]

Executed when the request is created. It can amend the request. If has any return value it will be used as return value of the call, the the function will be not called. Can raise any exception and that will be treated as the function exception, in that case the function will be not called.

response(response)[source]

Executed after successful call of the function. Response object created and passed to the hook. Can modify the response or give back a new response. Have to return the response object.