Flask extension for generating restful apis using type hints to automatically (de)serialize parameters and generate openapi docs.
Project description
Flask-Hintful
Flask-Hintful helps you write Restful APIs using Flask by taking advantage of Python's type hints.
Includes support for serializing/deserializing parameters according to type hints and automatically generating OpenApi documentation for your registered routes.
Requirements
- Python 3.7+
- Flask
- Marshmallow < 3
Installation
Install using pip
pip install flask-hintful
Quick Start
Construct a FlaskHintful object by passing the Flask application as a parameter, then use the FlaskHintful object @route
and .register_blueprint
to register routes.
Create your view functions with type hints and FlaskHintful will serialize pass path args, query args and even the request body for you.
from dataclasses import dataclass
from datetime import date, datetime
from flask import Flask
from flask_hintful import FlaskHintful
app = Flask('My API')
api = FlaskHintful(app)
@dataclass
class NestedModel():
str_field: str
@dataclass
class DataclassModel():
str_field: str
int_field: int
float_field: float
boolean_field: bool
list_field: list
date_field: date
datetime_field: datetime
nested_field: NestedModel
@api.route('/<id>/dataclass_test', methods=['POST'])
def dataclass_route(id: str, query_arg: int, model: DataclassModel) -> DataclassModel:
'''my dataclass route'''
return model
app.run()
You will be able to access the generated OpenApi on /swagger
.
Documentation
https://flask-hintful.readthedocs.io/
License
This project is licensed under the MIT License - see the LICENSE file for details
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flask_hintful-0.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 32edd98a005e38055d41805273720bbe3d7e6a9cbf301418968526d4bb346c13 |
|
MD5 | cb234f1a669daa4164b5664fd17dd7b0 |
|
BLAKE2b-256 | 0aac6214f3d931d5b9c3344d1fd6afd02b340d1d0a95671711e8c7286109e8f3 |