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中的信息,有助于理解项目结构.