缘由
Python在AI,AR VR这块使用越来越广泛。同时在Web方面也有很多成熟的框架。而我本身由于使用
Flask 比较多,个人认为就是比较简单,容易入手,可定制化强。这里我将我经过多个项目多次迭代的
自认为还可以的框架结构整理出来。方便自己可以更容易创建新项目。
目录结构
.
├── api api存放
│ ├── controllers 所有的C层放在这里
│ ├── interceptors 拦截器相关
├── application.py 封装的Flask的全局变量,包括app,数据库等
├── common 存放公用部分
│ ├── libs 公用方法或者类
│ ├── models 所有的数据库model
├── config 配置文件
│ ├── base_setting.py 基础配置
│ ├── develop_setting.py 开发环境
│ ├── local_setting_demo.py 本地开发环境配置demo
│ └── production_setting.py 生产环境的配置
├── docs 文档存放
│ ├── Mysql.md 所有数据库变更必须在这里记录
├── jobs 定时任务
│ ├── bin
│ └── tasks 所有定时任务都存放在这里
├── router 路由配置入口
│ ├── www.py 对应web的路由配置
│ └── api.py 对应api的路由配置
├── manage_web.py web启动入口
├── manage_job.py job定时器启动入口
├── manage_api.py api启动入口 (如果有api的话)
├── requirements.txt python 扩展
├── uwsgi.ini 生产环境uwsgi
├── web HTTP存放
│ ├── controllers 所有的C层放在这里
│ ├── interceptors 拦截器相关
│ ├── static 静态文件
│ └── templates 模板文件
功能特性
目录结构分层
相信代码分层很多人都听说。但是未必都能理解这样做会有什么好处。对于小型项目可能分不分不会有什么太大的问题,但是如果对于一个大型项目,分层就会带来特别明显的好处。大家翻阅代码知道去什么地方找,让开发和维护更加简洁。
多环境配置隔离
flask默认官方是有环境配置隔离方法的,我个人觉得官方的方式不太好,所以就结合以前使用php和在实际开发和运维当做自己规定了一套方案。如下 通过不同的配置文件做到多环境覆盖
例如 develop 可以是开发环境,production 是 生产环境,还可以增加test 为测试环境
通过环境变量ops_config 来进行切换
├── config 配置文件
│ ├── base_setting.py 基础配置
│ ├── develop_setting.py 开发环境
│ ├── local_setting_demo.py 本地开发环境配置demo
│ └── production_setting.py 生产环境的配置
支持多APP模式
很多情况我们可能要开发好几个应用,只有一个满足不了我们的需求。例如增加一个api,增加一个admin 都有可能。为了满足这种情况我就做了定制化架构。
通过不同的入口来决定不同的应用
├── api api存放
│ ├── controllers 所有的C层放在这里
│ ├── interceptors 拦截器相关
├── router 路由配置入口
│ ├── www.py 对应web的路由配置
│ └── api.py 对应api的路由配置
├── manage_web.py web启动入口
├── manage_api.py api启动入口 (如果有api的话)
├── web HTTP存放
│ ├── controllers 所有的C层放在这里
│ ├── interceptors 拦截器相关
│ ├── static 静态文件
│ └── templates 模板文件
支持定时器
为了方便我们写定时器,我自己写了一个简单的脚手架。方便使用。网上也有很多其他的定时器插件。但是从我时间实践得来,定时器当成一个独立的应用会更好,不要和其他应用有任何耦合最好。
├── jobs 定时任务
│ ├── bin
│ └── tasks 所有定时任务都存放在这里
├── manage_job.py job定时器启动入口
快速使用
- github:https://github.com/apanly/python3_flask_frame
- 码云:https://gitee.com/apanly/python3_flask_frame
网友评论