flask-maple使用文档

时间 2019-12-05

原文原文链接

安装

To install Flask-Maple:css

pip install flask-maple

Or alternatively, you can download the repository and install manually by doing:html

git clone git@github.com:honmaple/flask-maple.git
cd flask-maple
python setup.py install

用户系统

在 flask_maple/auth/model.py 中默认实现了 GroupMixin 与 UserMixin
若是要建立 user 表与 group 表,只须要python

from flask_maple.auth.models import UserMixin, GroupMixin

class User(db.Model, UserMixin):
    pass

class Group(db.Model, GroupMixin):
    pass

便可git

user 表默认建立如下字段, 可添加更多想要的字段github

id
username
password
email
is_superuser
is_confirmed
register_time
last_login
groups

group 表默认建立如下字段redis

id
name
users
parent_group
child_groups

权限

使用

from flask_maple.permission.models import PermissionMixin

class Permission(db.Model, PermissionMixin):
    pass

user 表与 group 表可继承 flask_maple.permission.models.UserMixin 与 flask_maple.permission.models.GroupMixin
或者直接使用 flask_maple.auth.models.UserMixin 与 flask_maple.auth.models.GroupMixinsql

添加权限数据库

identity = user # or group
identity.add_perm(
    action,
    resource,
    resource_type='endpoint',
    description=None)

删除权限django

identity.remove_perm(
    action,
    resource,
    resource_type='endpoint')

检查权限json

identity.has_perm(action, resource, resource_type='endpoint', and_=False)

权限缓存

默认权限会从数据库获取, 若是常常使用，可自行添加缓存, 并在添加删除权限后自行对缓存进行操做

class User(db.Model, UserMixin):
    def perm_cache(self,
                   action,
                   resource,
                   resource_type='endpoint',
                   and_=False):
        return

登陆

依赖于 flask-login, flask-mail

使用

from flask_maple import auth

auth.init_app(app)

# 或者
from flask_maple.auth.views import Auth

Auth(app)

将会建立6个 url

/login
/logout
/register
/forget
/confirm
/confirm/<token>

能够自定义登录，注册，忘记密码页面，以登录页面为例 (templates/maple/login.html)

{% extends "base/base.html" %}
{%- block content -%}
{% import 'maple/auth.html' as auth %}
<div class="panel panel-primary">
    <div class="panel-heading">
        <a href="{{ url_for('auth.login') }}" style="color:#fff">{{ _('Login')}}</a>
    </div>
    <div class="panel-body">
        {{ auth.login()}}
    </div>
</div>
{% endblock %}

注意事项

登录与登出默认使用 user.login(remember) , user.logout(), 若是未使用 flask_maple/auth/model.py 中的 UserMixin,则须要本身定义

验证码

使用 Pillow 生成验证码

pip install pillow

使用

from flask_maple import Captcha
captcha = Captcha(app)

# 由于字体可能存在版权问题，因此须要指定本身服务器字体, 默认为 /usr/share/fonts/TTF/DejaVuSans.ttf
captcha = Captcha(app, font="")

而后访问 http://127.0.0.1/captcha

配置

CAPTCHA_URL = "The captcha url,default 'captcha'"

错误处理

主要是对发生错误时的页面进行定制(403,404,500)

from flask_maple import Error
error = Error(app)

定制图片源于flask官网,侵删

邮箱

依赖于 flask-mail, 区别使用多线程发送

from flask_maple.mail import Mail

mail = Mail(app)
mail.send_email(*args, **kwargs)

此外，还有一个 MailMixin,实现了邮箱验证须要的密钥,

from flask_maple.mail import MailMixin

class User(db.Model, MailMixin):
    pass

print(user.email_token)
print(User.check_email_token(token, max_age=259200))

数据库

像django同样使用 flask-sqlalchemy
djang orm 与sqlalchemy相比,为何不少人都认为django orm更好用,大概就是由于django orm更方便

基本查询(已实现)

gt
lt
lte
gte
contains
in
exact
iexact
startswith
istartswith
iendswith
endswith
isnull
range
year
month
day

示例:

Post.query.filter_by(title__contains = 'sql').all()
Post.query.exclude_by(title__contains = 'sql').all()

关系查询

Post.query.filter_by(tags__name__contains = 'sql').all()

其它

Post.query.filter_by(tags__name__contains = 'sql').or(Post.id == 1,Post.id == 2).all()
Post.query.filter_by(tags__name__contains = 'sql').and(Post.id == 1,Post.id == 2).all()
Post.query.filter_by(tags__name__contains = 'sql').exists()
Post.query.load_only('title')

序列化

把 sqlalchemy 对象序列化为 json, 使用方法参考于 django rest framework

多个实例

from flask_maple.serializer import Serializer

posts = Post.query.all()
serializer = Serializer(posts)
data = serializer.data

单个实例

post = Post.query.first()
serializer = Serializer(post)
data = serializer.data

排除字段

serializer = Seralizer(post,exclude=['title'])

仅包括字段

serializer = Seralizer(post,include=['title'])

关系查询深度

serializer = Seralizer(post,depth=3)

depth默认为2

额外的字段

class Post(Model):
    ......
    def get_post_count(self):
        return 11

serializer = Serializer(post,extra=['get_post_count'])

自定义

from flask_maple.serializer import Serializer

class PostSerializer(Serializer):
    class Meta:
        include = []
        depth = 2
        include = []
        exclude = []
        extra = ['count']

serializer = PostSerializer(post,include=['title'])

中间件

参考于 django

from flask_maple.middleware import Middleware

app = ...
Middleware(app)

中间件写法(以一个简单的性能测试中间件为例)

class ProfileMiddleware(object):
    def preprocess_request(self):
        pr = cProfile.Profile()
        pr.enable()
        request.pr = pr

    def process_response(self, response):
        pr = request.pr
        pr.disable()
        s = StringIO()
        sortby = 'cumulative'
        ps = pstats.Stats(pr, stream=s).sort_stats(sortby)
        ps.print_stats()
        print(s.getvalue())
        return response

重要，须要加入中间件配置

MIDDLEWARE = ["path.to.ProfileMiddleware"]

日志

记录 info 和 error 两个日志level, 使用很简单

from flask_maple.log import Logging

app = ...
Logging(app)

配置文件

LOGGING = {
    'info': 'logs/info.log',   # 记录info level的日志,与配置文件同级下的logs目录,可修改
    'error': 'logs/error.log', # 记录error level的日志
    'send_mail': False,        # 当有错误发生时，是否发送邮件到管理员邮箱
    'toaddrs': [],             # 管理员邮箱，可为多个
    'subject': 'Your Application Failed',
    'formatter': '''
            Message type:       %(levelname)s
            Location:           %(pathname)s:%(lineno)d
            Module:             %(module)s
            Function:           %(funcName)s
            Time:               %(asctime)s

            Message:

            %(message)s
            '''
}

当send_mail为 True时, 配置依赖于 flask_mail的配置(主要是不想写多份)

MAIL_USERNAME
MAIL_PASSWORD
MAIL_SERVER
MAIL_PORT
MAIL_DEFAULT_SENDER

App

建立两个经常使用的 url

/robots.txt
/favicon.ico

使用

from flask_maple.app import App

App(app)

此外,由于国际化等缘由,能够传递 flask_maple.json.CustomJSONEncoder 给App

from flask_maple.app import App
from flask_maple.json import CustomJSONEncoder

App(app, json=CustomJSONEncoder)

配置

参考于 django,能够懒加载 blueprint

INSTALLED_APPS = [
    "path.to.blueprint1",
    "path.to.blueprint2",
    {
        "kwargs":{},
        "blueprint":{}
    }
]

Bootstrap

主要是我的常常使用的一些模板,好比bootstrap的js,css文件，分页模板, 上下撑满等
并依赖于 flask-assets ,对js,css文件进行压缩

使用

from flask_maple import Bootstrap
bootstrap = Bootstrap(
    app,
    css=('styles/monokai.css', 'styles/mine.css'),
    js=('styles/upload.js', 'styles/forums.js', 'styles/following.js',
        'styles/topic.js'),
    use_auth=True)

或者

bootstrap = Bootstrap()
bootstrap.init_app(app)

模板

{% extends 'maple/base.html' %}
{% block main -%}
<button class="btn btn-primary">submit</button>
<span class="glyphicon glyphicon-search" aria-hidden="true"></span>
{% endblock -%}

配置

AUTHOR_NAME = "This will show you name at html footer"

Redis

默认会加载 rediscluster.StrictRedisCluster ,若是rediscluster未安装则加载 redis.StrictRedis

使用

from flask_maple.redis import Redis

redis = Redis(app)

# 像平时使用redispy同样使用
print(redis.get(...))

配置

REDSI = {...}

具体例子可查看maple-bbs/extension

Github 原文