Cornice 0.13

This is the core project for Pyramid-based Services applications
Cornice provides a Service class you can use to define web services in Pyramid.

Each instance of a Service class corresponds to a server path and you may implement various methods HTTP on the path with simple decorators.

Cornice will automatically return a 405 error with the right Allow header if a method that was not implemented is requested.

Cornice also provides a Sphinx directive that can be used to document your web services. The extension iterates over defined services and will automatically generate your web service documentation.

QuickStart

To use Cornice, start by including it in your project with the **include** method in Pyramid:

    def main(global_config, **settings):
        ...
        config.include("cornice")
        ...
        return config.make_wsgi_app()


Learn more about include at http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources

Then you can start to define web services in your views.

For example, let's define a service where you can **GET** and **POST** a value at **/values/{value}**, where *value* is an ascii value representing the name of the value:

    import json
    from cornice import Service

    values = Service(name='foo', path='/values/{value}',
                     description="Cornice Demo")

    _VALUES = {}

    @values.get()
    def get_value(request):
        """Returns the value.
        """
        key = request.matchdict['value']
        return _VALUES.get(key)

    @values.post()
    def set_value(request):
        """Set the value.

        Returns *True* or *False*.
        """
        key = request.matchdict['value']
        try:
            _VALUES.set(key, json.loads(request.body))
        except ValueError:
            return False
        return True


By default, Cornice uses a Json rendered.

last updated on:
August 31st, 2012, 14:09 GMT
price:
FREE!
developed by:
Mozilla Services Team
homepage:
github.com
license type:
Other/Proprietary License
category:
ROOT \ Internet \ HTTP (WWW)

FREE!

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

What's New in This Release:
  • Added Cross-Origin Resource Sharing (CORS) support.
read full changelog

Add your review!

SUBMIT