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

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

前言

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快多了!

结语

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

相关文章
|
6月前
|
缓存 前端开发 JavaScript
flask各种版本的项目,终端命令运行方式的实现
flask各种版本的项目,终端命令运行方式的实现
285 4
|
6月前
|
数据可视化 API 开发者
通俗易懂:一步步教你 Flask 项目自动生成 API 文档
Flasgger,作为一款强大的 Flask 扩展,自动从 Flask 应用中提取并生成 OpenAPI 规范文档,配备 SwaggerUI,为开发者提供了一条快捷通道,让 API 的文档编制和交互式测试变得简单易行。Flasgger 的设计原则是简化开发流程,通过与 Flask 框架的无缝整合,让开发者可以更专注于应用逻辑的构建。
|
前端开发 JavaScript Python
flask 项目目录结构
flask 项目目录结构
165 0
|
2月前
|
存储 安全 数据库
Flask-Login 扩展中,如何安全地存储用户密码
Flask-Login 扩展中,如何安全地存储用户密码
|
1月前
|
存储 安全 数据库
Flask-Login 扩展中,如何安全地存储用户密码?
【10月更文挑战第4天】Flask-Login 扩展中,如何安全地存储用户密码?
|
3月前
|
SQL 缓存 数据库
神秘编程领域惊现宝藏!Flask 扩展生态究竟隐藏着怎样的神奇力量?快来揭开提升开发效率的秘密!
【8月更文挑战第31天】在 Flask 的世界里,其简洁而强大的核心框架搭配丰富多彩的扩展生态,为开发者带来了无尽可能性。从数据库集成到用户认证,从表单验证到缓存管理,Flask 提供了众多高质量插件,如 Flask-SQLAlchemy、Flask-WTF 和 Flask-Login,大幅提升了开发效率和代码质量。这些扩展如同宝库中的珍宝,等待着我们去探索和利用,但需谨慎选择以避免不必要的复杂性和性能问题。总之,Flask 的扩展生态助力我们更高效地开发 Web 应用,创造更多优秀作品。
34 0
|
3月前
|
Linux Python
【Azure 应用服务】Azure App Service For Linux 上实现 Python Flask Web Socket 项目 Http/Https
【Azure 应用服务】Azure App Service For Linux 上实现 Python Flask Web Socket 项目 Http/Https
|
4月前
|
安全 前端开发 API
震惊!掌握Django/Flask后,我竟然轻松征服了所有Web项目难题!
【7月更文挑战第15天】Python Web开发中,Django以其全面功能见长,如ORM、模板引擎,助你驾驭复杂需求;Flask则以轻量灵活取胜,适合快速迭代。两者结合使用,无论是数据库操作、用户认证还是API开发,都能让你应对Web挑战游刃有余。掌握这两者,Web项目难题变得易如反掌!
75 10
|
5月前
|
数据处理 Python
Flask 项目工程目录层级划分
本文介绍了如何将 Flask 项目工程目录层级按照主题分类划分,主要包括模型层、视图层、表单层、模板文件和静态文件。通过合理地组织项目文件,可以提高项目的可读性、可维护性和可扩展性。
85 5
|
6月前
|
前端开发 JavaScript 数据库
Flask狼书笔记 | 09_图片社交网站 - 大型项目的架构与需求(2)
9.8 收藏图片 前面已经学习过如何使用关联表来表示多对多关系,缺点是只能表示关系,不能存储数据(如我还想记录下收藏图片的时间戳)。这种情况下,我们可以使用关联模型来表示多对多关系。 在关联模型中,我们将Photo模型与User模型的多对多关系,分离成了User模型和Collect模型的一对多关系,和Photo模型与Collect模型的一对多关系。
141 0