reliqua 0.0.12

Simple, efficient, intuitive API Framework

This is sample template to create a quick Python Falcon API application. It uses a schema defined in the resource for the route path and OpenAPI documentation. The base application will handle creating the routes and documentation automatically at runtime.

You define a resource and the documentation will be auto-generated at startup using the docstrings.

from reliqua.resources.base import Resource
from reliqua import status_codes as status


class User(Resource):

    __routes__ = [
        '/users/{id}',
    ]

    phone = phone

    def on_get(self, req, resp, id=None):
        """
        Retrieve a user. This value
        is awesome

        :param str id:       [in=path, required] User ID
        :param str email:    [in=query] User Email
        :param str phone:    [in=query enum] Phone Numbers

        :response 200:
        :response 400:

        :return json:
        """
        try:
            resp.media = users[int(id)]
        except IndexError:
            resp.status = status.HTTP_404

    def on_delete(self, req, resp, id=None):
        try:
            users.pop(int(id))
            resp.media = {'success': True}
        except IndexError
            resp.status = status.HTTP_400

This will create the /users/{id} endpoint and corresponding API documentation. The OpenAPI documentation and swagger.json will be dynamically generate at application startup. The OpenAPI ui will be available at:

http://<api-url>/docs/

and the swagger.json file located at:

http://<api-url>/docs/swagger.json

To create an application, you import the application template.

from reliqua.app import Application

    
app = Application(
    bind='0.0.0.0:8000',
    ui_url = 'http://example.com/api',
    workers=1,
    resource_path='/var/www/html/resources'
)
app.run()

Where:

bind:           Address and port to listen for requests. [host:port]
ui_url:         The URL to the API when being used with a proxy, like nginx. If not supplied,
                then the bind address is used.
workers:        Number of worker threads to start.
resource_path:  This is where your python resource files are located.

Refer to the example application for more examples. You can install the library and example application

python setup.py install

You can execute the example application

$ reliqua-example 

From here the openapi-ui will be available at

http://localhost:8000/docs/