【flask进阶】手把手带你搭建可扩展的flask项目脚手架

简介: flask不像我们的django可以用指令快速搭建我们的项目目录,因此,对于初学者,做一个项目结构稍微复杂一些,功能多一些的web项目时,用flask搭建一个可扩展且看起来比较舒服的项目时,可能会面临很多困难与bug,因此在这篇文章中,我将我花时间搭建的类似django的项目目录的flask项目分享给大家,让大家可以快速搭建flask的脚手架!

@TOC

前言

flask不像我们的django可以用指令快速搭建我们的项目目录,因此,对于初学者,做一个项目结构稍微复杂一些,功能多一些的web项目时,用flask搭建一个可扩展且看起来比较舒服的项目时,可能会面临很多困难与bug,因此在这篇文章中,我将我花时间搭建的类似django的项目目录的flask项目分享给大家,让大家可以快速搭建flask的脚手架!

脚手架所需主要扩展

  • flask_sqlalchemy - orm框架,操作数据库
  • flask_migrate - 管理迁移数据库
  • flask_script - 插入脚本,产生工程管理manage.py
  • flask-mysqldb - 连接数据库的扩展恰好底层是基于mysqlclient的

项目目录结构展示与介绍

先来看我搭建的项目目录
在这里插入图片描述

看到这个目录结构,django开发者的DNA是否有触动,没错这就是完美的django目录,当然要实现这样的目录也是非常辛苦,博主奋战两天,解决了多个bug才搭建好了这个脚手架!至于为什么,就要从django和flask的区别说起了:很明显,我们的django是一个庞大且功能全面的框架,他将我们的一些orm,工程管理manage等等一些系列东西都囊扩进去了,再看我们的flask,本着轻巧灵活的特性,许多我们需要的功能都需要额外的一些扩展来完成,将这些扩展很好的结合进项目中,当然要花费很多时间,解决一些bug!

那么接下来我来大概介绍一下这个目录结构:

  • settings.py是项目配置文件。
  • manage.py相当于django中的manage.py文件,是依靠flask的扩展flask_script 搭建的。
  • Service.py可以自己看需求是否有,可以看做这里面分装一些工具类或者函数,可以在视图中调用来处理请求。
  • app.py毫无疑问是flask的主文件,在里面生成flask对象,注册路由,蓝图,写拦截器之类的,当然,路由管理,拦截器你可以自己再单独建文件放在里面!
  • migrations目录你可以忽略,这是借助flask的orm扩展flask-sqlalchemy中的指令生成的数据库迁移文件。
  • static和templates就是静态资源和模板目录,和app.py同级就行,这样就不需要在代码中额外添加路径,默认就能找到这些资源!
  • 接下来就是重点,application就相当于django中的app,里面包含你这个App的models模型和views视图!(这里也是一个bug点,本文下面附解决方案)

脚手架主体代码展示与介绍

app.py

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

# 将application目录添加到项目路径,解决views里的文件导入models里的模型类时找不到models模块路径的问题
import sys,os
sys.path.append(os.getcwd() + "/application")
# print(sys.path)

app = Flask(__name__)

#从配置文件中settings加载配置
app.config.from_pyfile('settings.py')

# 将app中的数据库配置加载到app中
db = SQLAlchemy(app)

manage.py

from flask_script import Manager,Server
from flask_migrate import Migrate,MigrateCommand
from app import db,app
# 生成管理工具对象
manager = Manager(app)
# 添加服务器运行指令
manager.add_command("runserver",Server(host='0.0.0.0',use_debugger=True))

# 数据库迁移
Migrate(app,db)
# 添加数据库的操作指令
manager.add_command("db",MigrateCommand)

#如果是以此脚本作为主脚本程序,就执行
if __name__ == '__main__':
    manager.run()

主要是这两个文件,借助flask_script生成工程管理manage.py文件,使得我们的一系列操作可以向django一样依靠指令完成!

项目bug解决

导包时报错没有这个模块或者找不到父包

bug这一块主要产生在python 中 import导包这一块,先看application中的详细目录:

在这里插入图片描述
看一下model文件:
在这里插入图片描述
这里需要从app.py导入db对象,app是项目主文件(运行封装到了manage.py),所以用指令运行是这里导包不会报错!

再看view文件:
在这里插入图片描述
问题就出在从models里导入模型类会报错,当然上图你看到的是我解决后的
看下面这两种导入方式:

from application.models.user.User import User
from ...models.user.User import User

通过尝试,这两种导入方式都会报错:“没有这个模块”或者“找不到父包”,
对于这种,我找了好久解决方案,以下方式可解决:

你在上面的app.py中是否看到了这段代码:

# 将application目录添加到项目路径,解决views里的文件导入models里的模型类时找不到models模块路径的问题
import sys,os
sys.path.append(os.getcwd() + "/application")
# print(sys.path)

这段代码可以解决这个问题,我们将application这个目录路径添加到这个项目路径中,然后在视图中导入模型时:

from models.user.User import User

直接从models目录开始就可以了,并且要注意,你在其他文件中导入这个模型类时也要用这种导入,不要变,变了flask-sqlalchemy就会报错,你可以理解为整个项目中这个模型类已经导入了,你换个路径就会重新导入,所以会报错(还有种解决方法就是在模型类中加个什么字段,支持重新加载,如果你遇到了这个问题可以百度查查,我的建议就是统一模型类的导入即可)。

导包时循环导入bug

循环导入这个问题很常见,尤其当我们的项目逻辑多起来的时候,导的包也就多了,我在搭建这个脚手架时也遇到了,关于这个bug我的建议是你看报错,然后自己分析导入逻辑,看看那一块冲突了,然后解决,当然为了防止出现这种循环导入的问题,你不要将所有导包都放到文件最上面,哪里需要就在那里import,这样可以很大程度避免循环导入的问题!当然这样导入也有他的缺点!

关于循环导入这块,你可以自行百度去了解!

项目数据迁移与启动

我们花这么久时间搭建是为什么,这里就有答案,这可以使得整个项目的数据迁移与启动变得和django一样十分简单!

在项目启动前先在项目根目录终端进行数据迁移(在settings.py文件中要写好数据库配置哦!):

1. python manage.py db init

  1. python manage.py db migrate
  2. python manage.py db upgrade

项目启动:

python manage.py runserver

这样的目录结构优点与缺点

花这么久的时间搭建这样的目录结构,到底是为了什么,很明显,是为了像django一样搭建一个可扩展的结构,你看到了,此项目中的application就相当于django中的app,你也可以像django一样建多个app,每一个大的功能就是一个app,比如网站后台就是一个app,前台就是一个app,你还可以在此基础上扩展其它app而不影响其他的服务!但要注意的是,你新建一个app都要记得将app目录添加到项目路径!(这里的app不是flask中的app.py哦!app.py只能有一个!)

当然,缺点也是很明显的,费时费精力,因此,对于没有经验的初学者,当你在做业务功能稍微多一点的项目时,我建议你豪不犹豫选择django吧!几行指令就搭建好脚手架了,结合实际情况再做调整就好,比flask快多了!

结语

后面我会做一个后台项目实践这个项目结构,敬请关注此专栏!

相关文章
|
4天前
|
缓存 前端开发 JavaScript
flask各种版本的项目,终端命令运行方式的实现
flask各种版本的项目,终端命令运行方式的实现
|
2月前
|
数据可视化 API 开发者
通俗易懂:一步步教你 Flask 项目自动生成 API 文档
Flasgger,作为一款强大的 Flask 扩展,自动从 Flask 应用中提取并生成 OpenAPI 规范文档,配备 SwaggerUI,为开发者提供了一条快捷通道,让 API 的文档编制和交互式测试变得简单易行。Flasgger 的设计原则是简化开发流程,通过与 Flask 框架的无缝整合,让开发者可以更专注于应用逻辑的构建。
|
5月前
|
前端开发 JavaScript Python
flask 项目目录结构
flask 项目目录结构
93 0
|
7月前
|
存储 前端开发 NoSQL
项目阶段之flask(三)
项目阶段之flask(三)
|
4月前
|
前端开发 JavaScript 数据库
Flask狼书笔记 | 09_图片社交网站 - 大型项目的架构与需求(2)
9.8 收藏图片 前面已经学习过如何使用关联表来表示多对多关系,缺点是只能表示关系,不能存储数据(如我还想记录下收藏图片的时间戳)。这种情况下,我们可以使用关联模型来表示多对多关系。 在关联模型中,我们将Photo模型与User模型的多对多关系,分离成了User模型和Collect模型的一对多关系,和Photo模型与Collect模型的一对多关系。
64 0
|
8天前
|
JSON 安全 API
Flask-Login与Flask-RESTful:扩展你的应用功能
【4月更文挑战第16天】本文介绍了两个实用的Flask扩展——Flask-Login和Flask-RESTful。Flask-Login提供用户认证和会话管理,简化了登录、注销和保护路由的逻辑。而Flask-RESTful则助力构建RESTful API,支持多种HTTP方法和请求解析。通过这两个扩展,开发者能轻松增强Flask应用的功能性,实现安全的用户认证和高效的API交互。
|
1月前
|
XML JSON API
通过Flask框架创建灵活的、可扩展的Web Restful API服务
通过Flask框架创建灵活的、可扩展的Web Restful API服务
|
9月前
|
SQL 关系型数据库 MySQL
【Flask】Flask项目sqlite数据库操作(代码实现)
Flask项目sqlite数据库操作(代码实现)
|
7月前
|
Python
项目阶段之flask(六)
项目阶段之flask(六)
|
7月前
|
前端开发 数据安全/隐私保护 Python
项目阶段之flask(五)
项目阶段之flask(五)
项目阶段之flask(五)