Python Fast CRUD

目的

本项目采用了一系列Python中比较流行的组件,可以以本项目为基础快速搭建Restful Web API, 这里主要是放了一些常用的CRUD操作示例和自己积累的通用函数.

说明

本项目使用了下面的常用组件:

Flask: 轻量级Web框架,可以说是Python中最易用的了

Flask-SQLAlchemy: ORM工具。本项目需要配合Mysql使用,sqlalchemy的flask包装,更易使用

Redis: Python Redis客户端

apscheduler : python常用的定时任务管理库

本项目是使用token验证,

本项目已经预先实现了一些常用的代码方便参考和复用:

创建了用户模型

实现了/v1/user/register用户注册接口

实现了/v1/user/login用户登录接口

实现了/v1/user/logout用户登出接口(需要登录后获取token)

图片分组的CRUD /v1/advert/group,/v1/advert/image

图片的展示策略的CRUD /v1/advert/style

图片以及连接的访问触发的访问量/点击量/统计等CRUD /v1/advert/list,/v1/advert/statistic,

本项目已经预先创建了一系列文件夹划分出下列模块:

app 放app,db,log的实例

route 放的是路由,以及进来的请求的预处理

service 负责处理比较复杂的业务,把业务代码模型化可以有效提高业务代码的质量(比如用户注册,充值,下单,查询列表等等)

cache 负责redis以及本地缓存相关的代码

tools 放一些通用的小工具,小函数,方便server中各处调用和model(负责存储数据库模型和数据库操作相关的代码)

help 下放test(测试文件此处未补全),db_script(放历次版本的对mysql的库表结构的变更脚本),以及历次版本的说明以及一些帮助文件

logs 放运行产生的日志文件

本地运行

python runserver.py

项目运行后启动在3000端口(可以修改,参考Flask文档),可以配置是否启用定时任务(访问量/点击量的定时统计)

生产环境推荐使用nginx代理 uwsgi_config.ini

uwsgi --ini uwsgi_config.ini --daemonize /var/log/flask_crud.log
server {
listen 3001 default_server;
server_name localhost;
location /static/ {
root /data/;
expires 30d;
}
location / {
include uwsgi_params;
uwsgi_pass unix:/tmp/simpleflask.sock; # 必须和uwsgi_config.ini 中的socket配置一致
# 并且需要权限
}
}

注意tools中的tools_readme.md中的信息,有助于理解项目结构.