[python3.6 flask web学习]Flask项目目录结构

一个良好的项目结构目录可以清晰的看出来各个模块的作用,方便扩展,易于修改。虽然Flask并没有强制要求开发者项目的目录层次结构应该是怎么样的,但是如果我们以包和模块的形式组织项目的话,后期的开发会非常的有条理。

| - projectName
	| - app  //程序包
		| - templates //jinjia2模板
		|- static //css,js 图片等静态文件
		| - main  //py程序包 ,可以有多个这种包,每个对应不同的功能
			| - __init__.py
			|- errors.py
			|- forms.py
			|- views.py
		|- __init__.py
		|- email.py //邮件处理程序
		|- models.py //数据库模型
	|- migrations //数据迁移文件夹
	| - tests  //单元测试
		|- __init__.py
		|- test*.py //单元测试程序,可以包含多个对应不同的功能点测试
	|- venv  //虚拟环境
	|- requirements.txt //列出了所有依赖包以及版本号,方便在其他位置生成相同的虚拟环境以及依赖
	|- config.py //全局配置文件,配置全局变量
	|- manage.py //启动程序

由上图可以看出,项目主要包含四个子目录.。

1.全局config配置文件

系统经常要用到很多全局配置变量以及多套环境(开发,测试,生产)配置变量,因此单独的使用配置文件来进行配置可以做到方便管理。本示例项目主要包含加密使用的SECRET_KEY,发送邮件的相关配置,数据库配置等

import os
basedir = os.path.abspath(os.path.dirname(__file__))

class Config:
	SECRET_KEY = os.environ.get('SECRET_KEY') or 'hard to guess string'
	SQLALCHEMY_COMMIT_ON_TEARDOWN = True
	FLASKY_MAIL_SUBJECT_PREFIX = '[Flasky]'
	FLASKY_MAIL_SENDER = 'Flasky Admin '
	FLASKY_ADMIN = os.environ.get('FLASKY_ADMIN')
	
	@staticmethod //此注释可表明使用类名可以直接调用该方法
	def init_app(app): //执行当前需要的环境的初始化
		pass
		
class DevelopmentConfig(Config): //开发环境
	DEBUG = True
	MAIL_SERVER = 'smtp.googlemail.com'
	MAIL_PORT = 587
	MAIL_USE_TLS = True
	MAIL_USERNAME = os.environ.get('MAIL_USERNAME')
	MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD')
	SQLALCHEMY_DATABASE_URI = os.environ.get('DEV_DATABASE_URL') or \
	'sqlite:///' + os.path.join(basedir, 'data-dev.sqlite')

class TestingConfig(Config): //测试环境
	TESTING = True
	SQLALCHEMY_DATABASE_URI = os.environ.get('TEST_DATABASE_URL') or \
	'sqlite:///' + os.path.join(basedir, 'data-test.sqlite')

class ProductionConfig(Config): //生产环境
	SQLALCHEMY_DATABASE_URI = os.environ.get('DATABASE_URL') or \
	'sqlite:///' + os.path.join(basedir, 'data.sqlite')

config = {
	'development': DevelopmentConfig,
	'testing': TestingConfig,
	'production': ProductionConfig,
	'default': DevelopmentConfig
}

2.app程序包


如果所有的程序都写在一个文件中,程序在执行的时候配置数据就在程序实例执行之前就导入了,但是为了能够动态的修改配置文件,需要在程序实例初始化之前留时间或者或是留加载空隙给配置文件,需要采用程序实例延迟初始化。因此单独创建一个app_create()函数实现程序实例初始化。在app的__init__.py文件中新建方法app_create():
from flask import Flask, render_template
from flask.ext.bootstrap import Bootstrap
from flask.ext.mail import Mail
from flask.ext.moment import Moment
from flaskext.sqlalchemy import SQLAlchemy
from config import conifg


bootstrap = Bootstrap()
mail = Mail()
moment = Moment()
db = SQLAlchemy()


def app_create(config_name):
    app = Flask(__name__)
    app.config.from_object(config[config_name]) //可以直接把对象里面的配置数据转换到app.config里面
    config[config_name].init_app(app)
  
    bootstrap.app_init(app)
    mail.init_app(app)
    moment.init_app(app)
    db.init_app(app)
    #路由和其他处理程序定义
    #...
    return app



当然这个初始化只是初始化了扩展程序。路由和错误页面还没有定义,由于现在程序是在运行的时候创建而不是在解释的时候,只有在调用了app_create()之后才能使用app_route装饰器定义路由,但是这时定义路由就太晚了。因此Flask提供了蓝本功能,在蓝本中定义的路由跟程序实例延迟初始化类似,定义的路由是处于休眠的状态的,只有在蓝本注册到程序之后,路由才真正成为程序的一部分
所有的蓝本可以定义在一个文件中,也可以分模块单独定义。下面定义main包中的蓝本app/main/__init__.py
from flask import Blueprint

main = Blueprint('main', __name__)

from . import views, errors //由于路由和错误处理页面定义在这个文件里面,导入到蓝本把他们关联起来,又因为views.py,error.py需要导入蓝本main,防止循环导入所以放到最后


修改app_create函数,注册蓝本
def app_create(config_name):
    #...
    from .main import main as main_blueprint //从当前目录下面的main子目录导入main
    app.register_blueprint(main_blueprint)


    #...
    return app

蓝本中定义的路由
from datetime import datetime
from flask import render_template, session, redirect, url_for


from . import main
from .forms import NameForm
from .. import db
from ..models import User


@main.route('/', methods =['GET', 'POST']) //不同的蓝本装饰器不同
def  index():
    form = NameForm()
    if form.validate_on_submit():
    #...
        return redirect(url('main.index')) //每个蓝本都有一个命令空间,生成url需要加上命名空间前缀
    return render_template('index.html', form = form, name = session.get('name'), known = session.get('known', False), current_time = datetime.utcnow())



3.启动脚本


顶层的manage.py用于启动程序

#!/usr/bin/env python
import os
from app import create_app, db
from app.models import User, Role
from flask.ext.script import Manager, Shell
from flask.ext.migrate import Migrate, MigrateCommand


app = create_app(os.getenv('FLASK_CONFIG') or 'default')
manager = Manager(app)
migrate = Migrate(app, db)


def make_shell_context():
	return dict(app=app, db=db, User=User, Role=Role)
manager.add_command("shell", Shell(make_context=make_shell_context))
manager.add_command('db', MigrateCommand)


if __name__ == '__main__':
manager.run()


4.需求文件requirements.txt



程序中必须包含一个requirements.txt 文件,用于记录所有依赖包及其精确的版本号。如果要在另一台电脑上重新生成虚拟环境,这个文件的重要性就体现出来了,例如部署程序时使用的电脑。pip 可以使用如下命令自动生成这个文件:
(venv) $ pip freeze >requirements.txt


如果你要创建这个虚拟环境的完全副本,可以创建一个新的虚拟环境,并在其上运行以下命令:

(venv) $ pip install -r requirements.txt


5.单元测试


tests包包含了单元测试,也可以分功能模板,建立单独的单元测试文件


6.创建数据库

使用数据迁移命令创建数据库

(venv) $ python manage.py db upgrade


你可能感兴趣的:(python)