【轻量级NoSQL数据库与PythonWeb-Flask框架组合使用】4-项目布局及应用配置

创建并进入项目文件夹:

$ mkdir flask-tutorial
$ cd flask-tutorial

本教程假定项目文件夹名称为 flask-tutorial ,本教程中代码块的顶端的文件 名是基于该文件夹的相对名称。

一个最简单的 Flask 应用可以是单个文件。

hello.py

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, World!'

然而,当项目越来越大的时候,把所有代码放在单个文件中就有点不堪重负了。 Python 项目使用 来管理代码,把代码分为不同的模块,然后在需要的地方导入 模块。本教程也会按这一方式管理代码。

教程项目包含如下内容:

  • flaskr/ ,一个包含应用代码和文件的 Python 包。
  • tests/ ,一个包含测试模块的文件夹。
  • venv/ ,一个 Python 虚拟环境,用于安装 Flask 和其他依赖的包。
  • 告诉 Python 如何安装项目的安装文件。
  • 版本控制配置,如 git 。不管项目大小,应当养成使用版本控制的习惯。
  • 项目需要的其他文件。

最后,项目布局如下:

/home/user/Projects/flask-tutorial
├── flaskr/
│   ├── __init__.py
│   ├── db.py
│   ├── schema.sql
│   ├── auth.py
│   ├── blog.py
│   ├── templates/
│   │   ├── base.html
│   │   ├── auth/
│   │   │   ├── login.html
│   │   │   └── register.html
│   │   └── blog/
│   │       ├── create.html
│   │       ├── index.html
│   │       └── update.html
│   └── static/
│       └── style.css
├── tests/
│   ├── conftest.py
│   ├── data.sql
│   ├── test_factory.py
│   ├── test_db.py
│   ├── test_auth.py
│   └── test_blog.py
├── venv/
├── setup.py
└── MANIFEST.in

如果使用了版本控制,那么应当忽略运行项目时产生的临时文件以及编辑代码时编辑 器产生的临时文件。忽略文件的基本原则是:不是你自己写的文件就可以忽略。举例 来说,假设使用 git 来进行版本控制,那么使用 .gitignore 来设置应当忽略 的文件, .gitignore 文件应当与下面类似:

.gitignore

venv/

*.pyc
__pycache__/

instance/

.pytest_cache/
.coverage
htmlcov/

dist/
build/
*.egg-info/

创建一个 Flask 应用最粗暴直接的方法是在代码的最开始创建一个全局 Flask 实例。前面的 “Hello, World!” 示例就是这样做的。有的情况下这 样做是简单和有效的,但是当项目越来越大的时候就会有些力不从心了。

可以在一个函数内部创建 Flask 实例来代替创建全局实例。这个函数被 称为 应用工厂 。所有应用相关的配置、注册和其他设置都会在函数内部完成, 然后返回这个应用。

写代码的时候到了!创建 flaskr 文件夹并且文件夹内添加 __init__.py 文件。 __init__.py 有两个作用:一是包含应用工厂;二是 告诉 Python flaskr 文件夹应当视作为一个包。

$ mkdir flaskr

flaskr/__init__.py

import os

from flask import Flask

def create_app(test_config=None):
    # create and configure the app
    app = Flask(__name__, instance_relative_config=True)
    app.config.from_mapping(
        SECRET_KEY='dev',
        DATABASE=os.path.join(app.instance_path, 'flaskr.sqlite'),
    )

    if test_config is None:
        # load the instance config, if it exists, when not testing
        app.config.from_pyfile('config.py', silent=True)
    else:
        # load the test config if passed in
        app.config.from_mapping(test_config)

    # ensure the instance folder exists
    try:
        os.makedirs(app.instance_path)
    except OSError:
        pass

    # a simple page that says hello
    @app.route('/hello')
    def hello():
        return 'Hello, World!'

    return app

create_app 是一个应用工厂函数,后面的教程中会用到。这个看似简单的函数其实 已经做了许多事情。

现在可以通过使用 flask 命令来运行应用。在终端中告诉 Flask 你的应用在哪里, 然后在开发模式下运行应用。请记住,现在还是应当在最顶层的flask-tutorial 目录下,不是在 flaskr 包里面。

开发模式下,当页面出错的时候会显示一个可以互动的调试器;当你修改代码保存的 时候会重启服务器。在学习本教程的过程中,你可以一直让它保持运行,只需要刷新 页面就可以了。

Bash

$ export FLASK_APP=flaskr
$ export FLASK_ENV=development
$ flask run

CMD

> set FLASK_APP=flaskr
> set FLASK_ENV=development
> flask run

Powershell

> $env:FLASK_APP = "flaskr"
> $env:FLASK_ENV = "development"
> flask run

可以看到类似如下输出内容:

* Serving Flask app "flaskr"
* Environment: development
* Debug mode: on
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!

* Debugger PIN: 855-212-761

Original: https://blog.csdn.net/qq_41823684/article/details/119025342
Author: Vax_Loves_1314
Title: 【轻量级NoSQL数据库与PythonWeb-Flask框架组合使用】4-项目布局及应用配置

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/816687/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球