# -*- coding: utf-8 -*-
"""lab08_app_factory_blueprints · 第6章 可维护性（端口 5116）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - 应用工厂：create_app() 把“造应用”变成函数，便于测试与多环境
    - 扩展单例：db / migrate / bootstrap 在 extensions.py 里创建，工厂里 init_app
    - 配置类：config.py 里 Development/Testing/Production 三套参数
    - 蓝图：main 管内容、auth 管登录，各自独立注册
    - 自定义 CLI：flask --app app init-db / shell / routes

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5116/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

import os

from flask import Flask

from config import configs
from extensions import bootstrap, db, migrate   # 扩展对象从这里来，不在这里 new


def create_app(env=None):
    """应用工厂：谁调用它，谁就得到一个配置好的应用实例。

    env 不传时读环境变量 FLASK_ENV，再没有就走 development。
    """
    env = env or os.environ.get('FLASK_ENV', 'default')
    if env not in configs:
        raise ValueError(f'未知环境 {env!r}，可选：{list(configs)}')

    app = Flask(__name__)
    app.config.from_object(configs[env])     # ① 一次性把配置类里的属性全灌进 app.config

    # ② 扩展初始化：对象在 extensions.py 里创建，在这里绑定 app
    #    必须放在工厂里 —— 否则第二次调用 create_app() 会重复注册报错
    db.init_app(app)                          # 模型/会话/引擎 → 这个 app
    migrate.init_app(app, db)                 # 迁移需要知道 db 是谁
    bootstrap.init_app(app)                   # Bootstrap 的 load_css()/load_js()
    # 模型必须在 db.init_app 之后被 import 一次，否则迁移扫不到表
    from models import Article, User          # noqa: F401  （只为了注册元数据）

    # ③ 注册蓝图：每个蓝图管自己的一组路由（脚本方式运行用绝对导入）
    from blueprints.main import bp as main_bp             # 主站蓝图
    from blueprints.auth import bp as auth_bp             # 认证蓝图
    app.register_blueprint(main_bp)                       # 挂在根路径 /
    app.register_blueprint(auth_bp, url_prefix='/auth')   # 挂在 /auth 前缀下

    # ④ 把环境名暴露给所有模板，页面上就能看到“我现在跑的是哪套配置”
    @app.context_processor
    def inject_env():
        return {
            'env_name': app.config.get('ENV_NAME', 'unknown'),
            'debug_on': app.config.get('DEBUG', False),
        }

    # ⑤ Shell 上下文：flask shell 进去后，db / User / Article 直接可用
    #    教材第五章的 make_shell_context() 就是这件事，新版写成装饰器
    @app.shell_context_processor
    def make_shell_context():
        return {'db': db, 'User': User, 'Article': Article}

    # ⑥ 注册命令行指令
    register_cli(app)

    return app


def register_cli(app):
    """把所有自定义 flask 子命令集中注册。

    教材里用 flask_script 的 @manager.command 做这件事；
    flask_script 已停止维护，现在的标准做法是 app.cli.command()（底层是 click）。
    """
    import click

    @app.cli.command('config-show')
    def config_show():
        """打印当前环境的关键配置"""
        click.echo(f'当前环境   : {app.config["ENV_NAME"]}')
        click.echo(f'DEBUG      : {app.config["DEBUG"]}   '
                   f'（注意：flask 命令默认把 debug 关掉，想开要加 --debug）')
        click.echo(f'TESTING    : {app.config.get("TESTING", False)}')
        click.echo(f'数据库     : {app.config.get("SQLALCHEMY_DATABASE_URI", "（本章未真正使用）")}')
        click.echo(f'SECRET_KEY : {app.config["SECRET_KEY"][:8]}...（已截断）')

    @app.cli.command('hello')
    @click.option('--name', default='同学', help='要打招呼的人')
    def hello(name):
        """带参数的自定义命令：flask --app app hello --name 张三"""
        click.echo(f'你好，{name}！这条命令由 flask CLI 执行，不是 Web 路由。')

    @app.cli.command('stats')
    def stats():
        """统计路由数量，顺便验证蓝图是不是真的注册上了"""
        rules = list(app.url_map.iter_rules())
        click.echo(f'路由总数：{len(rules)}')
        by_bp = {}
        for r in rules:
            bp = r.endpoint.split('.')[0] if '.' in r.endpoint else '（无蓝图）'
            by_bp.setdefault(bp, []).append(r.rule)
        for bp, urls in sorted(by_bp.items()):
            click.echo(f'  [{bp}] {len(urls)} 条: {", ".join(sorted(urls))}')

    @app.cli.command('init-db')
    def init_db():
        """建表 + 灌一个演示用户：flask --app app init-db"""
        from models import Article, User
        db.create_all()
        if not User.query.filter_by(username='admin').first():
            u = User(username='admin')
            u.set_password('123456')          # 存的是哈希，不是明文
            db.session.add(u)
            db.session.add(Article(title='第一篇', content='来自 init-db 命令', author=u))
            db.session.commit()
            click.echo('已建表并创建用户 admin / 123456')
        else:
            click.echo('表已存在，用户 admin 也已在库中')


if __name__ == '__main__':
    # 脚本方式运行：环境由 FLASK_ENV 决定，debug 由配置类决定（开发环境为 True）
    application = create_app()
    application.run(port=5116)
