Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/biosustain/potion

Flask-Potion is a RESTful API framework for Flask and SQLAlchemy, Peewee or MongoEngine
https://github.com/biosustain/potion

flask flask-extensions mongoengine peewee sqlalchemy

Last synced: 13 days ago
JSON representation

Flask-Potion is a RESTful API framework for Flask and SQLAlchemy, Peewee or MongoEngine

Awesome Lists containing this project

README 

        
============

Flask-Potion

============



.. image:: https://img.shields.io/travis/biosustain/potion/master.svg?style=flat-square

    :target: https://travis-ci.org/biosustain/potion



.. image:: https://img.shields.io/coveralls/biosustain/potion/master.svg?style=flat-square

    :target: https://coveralls.io/r/biosustain/potion



.. image:: https://img.shields.io/pypi/v/Flask-Potion.svg?style=flat-square

    :target: https://pypi.python.org/pypi/Flask-Potion



.. image:: https://img.shields.io/pypi/l/Flask-Potion.svg?style=flat-square

    :target: https://pypi.python.org/pypi/Flask-Potion



.. image:: https://badges.gitter.im/Join%20Chat.svg

   :alt: Join the chat at https://gitter.im/biosustain/potion

   :target: https://gitter.im/biosustain/potion?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge



|



.. image:: https://raw.githubusercontent.com/biosustain/potion/master/docs/_static/Potion.png

   :alt: Flask-Potion

   :align: center

   :height: 150



Description

===========



**Flask-Potion** is a powerful Flask extension for building RESTful JSON APIs.

Potion features include validation, model resources and routes, relations, object permissions, filtering, sorting,

pagination, signals, and automatic API schema generation.



Potion ships with backends for **SQLAlchemy**, **peewee** and **MongoEngine** models. It is possible to add backends for other data stores, or even to use a subset of Potion without any data store at all.



API client libraries for `Python `_ and `JavaScript/TypeScript `_ (generic Node as well as AngularJS and Angular) are available.



User's Guide

^^^^^^^^^^^^



The user's guide and documentation is published here:



   `http://potion.readthedocs.org/ `_



Versioning

^^^^^^^^^^



Potion will use semantic versioning from v1.0.0. Until then, the minor version is used for changes known to be breaking.



Features

========



- Powerful API framework both for data-store-linked and plain resources

- JSON-based and fully self-documenting with JSON Hyper-Schema

- Backend integrations:



  - Flask-SQLAlchemy

  - Peewee (contributed by `Michael Lavers `_)

  - Flask-MongoEngine



- Filtering, sorting, pagination, validation, built right in

- Smart system for handling relations between resources

- Natural keys for extra simple relation querying

- Easy-to-use, yet highly flexible, optional permissions system

- Signals for pre- and post-processing of requests

- Very customizable — everything is just a resource, route, or schema

- Access APIs more easily with client libraries for `Python `_ and `JavaScript/TypeScript `_



Example *(SQLAlchemy)*

======================



.. code-block:: python



    from flask import Flask

    from flask_sqlalchemy import SQLAlchemy

    from flask_potion import Api, ModelResource, fields

    from flask_potion.routes import ItemRoute



    app = Flask(__name__)

    db = SQLAlchemy(app)

    api = Api(app)



    class User(db.Model):

        id = db.Column(db.Integer, primary_key=True)

        name = db.Column(db.String(), nullable=False)



    db.create_all()



    class UserResource(ModelResource):

        class Meta:

            model = User



        @ItemRoute.GET

        def greeting(self, user) -> fields.String():

            return "Hello, {}!".format(user.name)



    api.add_resource(UserResource)



    if __name__ == '__main__':

        app.run()



Authors

=======



Potion is written and maintained by `Lars Schöning `_.



`Peewee `_ backend support has been contributed by `Michael Lavers `_.



`MongoEngine `_ backend support has been contributed by `João Cardoso `_.



`See here for the full list of contributors `_.