从零开始搭建一个Python Flask项目

liftword4周前 (12-12)技术文章19

Flask是一个轻量级的Web框架,以其简单的功能,深受众多开发者的喜爱,其核心功能非常简单,但可以通过扩展支持复杂的Web应用开发,下面我们就来演示一下如何从零开始搭建一个Flask项目。

环境准备

在搭建 Flask 项目之前,首先需要准备Python3的开发环境。通过在终端中运行以下命令来检查Python是否已经安装成功如果没有安装可以按照官网教程进行安装。

python3 --version

创建虚拟环境

在开发过程中我们可以使用虚拟环境来隔离项目依赖,避免与系统中的其他项目的依赖库产生不必要的冲突。

python3 -m venv venv

激活虚拟环境

#  macOS/Linux 上
source venv/bin/activate
# 在 Windows 上
venv\Scripts\activate

激活虚拟环境后,命令行提示符会发生变化,显示虚拟环境的名称,我们可以在项目的虚拟环境中来创建项目。

安装Flask

确保虚拟环境已激活后,运行以下命令通过pip安装Flask。

pip install flask

安装完成后,可以使用pip list命令查看已安装的库,确认Flask是否成功安装。

创建Flask项目结构

接下来,我们就可以搭建项目的基本目录结构。这里我们创建了一个名为flask_project的项目,然后通过如下的结构来构建项目。

flask_project/
│
├── app/
│   ├── __init__.py        # 项目的初始化文件
│   ├── routes.py          # 路由定义文件
│   └── templates/         # HTML 模板文件目录
│       └── index.html
│   └── static/            # 静态文件目录(CSS、JS、图片等)
│       └── style.css
├── venv/                  # 虚拟环境文件夹
├── requirements.txt       # 依赖文件
└── run.py                 # 启动项目的脚本

编写Flask应用

创建run.py文件

run.py是用于启动Flask的入库文件,如下所示。

from app import create_app

app = create_app()

if __name__ == '__main__':
    app.run(debug=True)

创建 app/__init__.py 文件

在app/__init__.py文件中,需要创建一个create_app函数来对Flask应用进行初始化操作,用来对项目进行扩展和配置管理。

from flask import Flask

def create_app():
    app = Flask(__name__)

    # 配置应用
    app.config['SECRET_KEY'] = 'your-secret-key'

    # 注册蓝图
    from .routes import main
    app.register_blueprint(main)

    return app

在这个文件中,初始化了Flask应用并配置密钥。除此之外还注册了路由模块,这样可以方便将路由逻辑与应用程序结构分离。

创建app/routes.py文件

接下来,我们需要定义应用的路由。将路由封装在一个Flask模块中,这样方便在应用规模扩展时,能够方便地管理不同的路由模块,如下所示。

from flask import Blueprint, render_template

main = Blueprint('main', __name__)

@main.route('/')
def index():
    return render_template('index.html')

创建 HTML 模板

在上面的代码中在根路径 (/) 上定义了一个index视图,接下来我们就在app/templates/目录下,创建一个简单的index.html文件来展示网页内容,如下所示。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Flask Web App</title>
    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
</head>
<body>
    <h1>Welcome to Flask!</h1>
    <p>This is your first Flask web application.</p>
</body>
</html>

添加静态文件

在app/static/目录下,创建CSS 文件style.css。如下所示

body {
    font-family: Arial, sans-serif;
    background-color: #f0f0f0;
    text-align: center;
    padding-top: 50px;
}

h1 {
    color: #2c3e50;
}

p {
    color: #7f8c8d;
}

运行项目

在项目根目录下,通过如下的命令来启动Flask项目。

python run.py

启动之后,就会看到如下的内容输出。

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

打开浏览器,访问 http://127.0.0.1:5000/,将看到显示 "Welcome to Flask!" 的网页内容。

总结

到目前为止,搭建了一个简单的Flask应用,展示了包括环境搭建、项目结构设计、路由定义、模板渲染以及静态文件管理等步骤的具体实现,当然我们也可以继续扩展上面的项目,例如添加数据支持、添加多路由、多视图支持,增加用户认证等操作逐渐对项目进行扩展形成一个完整的复杂的项目。

相关文章

Python Flask 大型应用的架构

这里推荐了一个Python Flask的应用架构,root路径是老乡鸡文件夹,里面一个app文件夹,加上一个go.py启动文件,虽然这个例子里面,我写的很挫,但是大概意思到位了,实际上业务代码都要写到...

做好架构师,要懂微服务,汇总微服务架构落地的15种框架

这两年,微服务这个概念火了,火到什么程度呢?2016年有一个统计说,两千家企业里,30%在使用微服务,15%在实验开发和测试微服务架构,24%在学习微服务准备转型,只有剩下的30%的企业没有使用微服务...

[python] 基于diagrams库绘制系统架构图

Python的Diagrams库允许通过简单的Python代码绘制云系统架构,实现对新的系统架构进行原型设计。Diagrams的官方仓库地址见:?diagrams???。Diagrams的官方文档和使...

超级实用 Python GUI 入门

有时候使用 python 做自动化运维操作,开发一个简单的应用程序非常方便。程序写好,每次都要通过命令行运行 python 程序,就不是那么人性化了。为了更方便的操作,使用 Python GUI 编写...

Python基础-Python常用的内置函数与标准库介绍?

在之前的分享中,我们介绍了关于Python入门级别的知识点,包括了Python的数据类型、流程控制语句、文件操作、异常处理以及面向对象相关的内容,这篇文章,我们主要来介绍一下关于Python中我们常用...

Python架构异步任务大师课:深入探索APSchedulerAsync高级应用

知识星球:写代码那些事----如果你有收获|欢迎|点赞|关注|转发----这里会定期更新|大厂的开发|架构|方案设计这里也会更新|如何摸鱼|抓虾欢迎来到写代码那些事!在现代软件开发中,异步任务的高效管...