跳转到主要内容

Flask + marshmallow 用于构建美观的API

项目描述

Latest version Build status Documentation marshmallow 3 compatible

Flask + marshmallow 用于构建美观的API

Flask-Marshmallow是一个轻量级的集成层,用于Flask(一个Python网络框架)和marshmallow(一个对象序列化/反序列化库),它向marshmallow添加了额外的功能,包括用于HATEOAS准备好的API的URL和超链接字段。它还(可选地)与Flask-SQLAlchemy集成。

立即获取

pip install flask-marshmallow

创建您的应用程序。

from flask import Flask
from flask_marshmallow import Marshmallow

app = Flask(__name__)
ma = Marshmallow(app)

编写您的模型。

from your_orm import Model, Column, Integer, String, DateTime


class User(Model):
    email = Column(String)
    password = Column(String)
    date_created = Column(DateTime, auto_now_add=True)

使用marshmallow定义您的输出格式。

class UserSchema(ma.Schema):
    class Meta:
        # Fields to expose
        fields = ("email", "date_created", "_links")

    # Smart hyperlinking
    _links = ma.Hyperlinks(
        {
            "self": ma.URLFor("user_detail", values=dict(id="<id>")),
            "collection": ma.URLFor("users"),
        }
    )


user_schema = UserSchema()
users_schema = UserSchema(many=True)

在视图函数中输出数据。

@app.route("/api/users/")
def users():
    all_users = User.all()
    return users_schema.dump(all_users)


@app.route("/api/users/<id>")
def user_detail(id):
    user = User.get(id)
    return user_schema.dump(user)


# {
#     "email": "fred@queen.com",
#     "date_created": "Fri, 25 Apr 2014 06:02:56 -0000",
#     "_links": {
#         "self": "/api/users/42",
#         "collection": "/api/users/"
#     }
# }

http://flask-marshmallow.readthedocs.io/

了解更多信息

要了解更多关于marshmallow的信息,请查看其文档

许可证

MIT许可证。有关详细信息,请参阅捆绑的LICENSE文件

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分发

flask_marshmallow-1.2.1.tar.gz (40.8 kB 查看哈希值)

上传时间

构建分发

flask_marshmallow-1.2.1-py3-none-any.whl (12.1 kB 查看哈希值)

上传时间 Python 3

由以下支持