Module rhino.resource

Represents a REST resource.

This class can be used in multiple ways:

As a standalone resource, using it's methods to register handlers:

my_resource = Resource()

@my_resource.get
def get_resource(request):
    # ...

As a class decorator for class-based resources:

@Resource
class MyResource(object):
    @get
    def index(self, request):
        # ...

As a wrapper to create resouces from custom objects:

class MyClass(object):
    def __init_(self, *args):
        # ...

    @get
    def index(self, request):
        # ...

my_resource = Resource(MyClass())

When used as a wrapper or class decorator, handlers will be picked up from methods of the wrapped instance or class that have been decorated with one of the decorator functions provided by this module (get, post, etc.)

Additionally, if the wrapped object implements from_url, that method will be called before any handler to filter the URL parameters that will be passed to the handler as keyword arguments.

When used as a standalone instance, functions can be registered as handlers using the instance's methods, as shown above. The from_url method can be used in the same way to register a filter for URL parameters.

Try to coerce an object into a Response instance.

Mark the decorated function as a handler for GET requests.

Mark the decorated function as a handler for POST requests.

Mark the decorated function as a handler for PUT requests.

Mark the decorated function as a handler for DELETE requests.

Mark the decorated function as a handler for PATCH requests.

Mark the decorated function as a handler for OPTIONS requests.