restart-falcon's Introduction

RESTArt-Falcon

A RESTArt extension for integrating RESTArt into Falcon, which has the benefit of high performance.

Why

Pros: With RESTArt-Falcon, you can benefit from the high performance of Falcon, while still using the RESTArt-style API code, which I think is more Pythonic.

Cons: The Werkzeug-style converters (with the separator :) is not supported in RESTArt-Falcon. Captured parameters in URI can only be specified in the form of <arg>, which will be automatically converted to Falcon-style {arg}.

Installation

Install RESTArt-Falcon with pip:

$ pip install RESTArt-Falcon

Install development version from GitHub:

$ git clone https://github.com/RussellLuo/restart-falcon.git
$ cd restart-falcon
$ python setup.py install

Benchmarks

Codebase

The pure RESTArt API:

from restart.api import RESTArt
from restart.resource import Resource
from restart.serving import Service

api = RESTArt()

@api.route(methods=['GET'])
class Action(Resource):
    name = 'action'

    def read(self, request):
        return 'Go'

app = Service(api)

The RESTArt-Falcon API:

from restart.api import RESTArt
from restart.resource import Resource
from restart.serving import Service
from restart.ext.falcon.adapter import FalconAdapter

api = RESTArt()

@api.route(methods=['GET'])
class Action(Resource):
    name = 'action'

    def read(self, request):
        return 'Go'

app = Service(api, FalconAdapter)

The pure Falcon API:

import falcon

class Action(object):

    def on_get(self, req, resp):
        resp.status = falcon.HTTP_200
        resp.body = 'Go'

app = falcon.API()
app.add_route('/action', Action())