# -*- coding: utf-8 -*-
"""lab04_jinja2_templates · 第3章 模板（端口 5113）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - 模板三种语法：{{ 变量 }}、{% 语句 %}、{# 注释 #}
    - 变量注入：视图 render_template 传什么，模板就能用什么
    - 控制结构：{% if %} / {% for %} 在模板里写分支与循环
    - 复用：include 引入片段、extends+block 做母版继承、macro 定义可复用宏
    - 过滤器：变量 | 过滤器（default/length/upper…），以及全局对象 url_for/request/g

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5113/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

import time

from flask import Flask, render_template
from flask_bootstrap import Bootstrap5   # 教材用 Flask-Bootstrap（已停更），现代等价物是 Bootstrap-Flask

app = Flask(__name__)
app.config['BOOTSTRAP_SERVE_LOCAL'] = True   # 用本地静态资源，不联网也能显示样式
Bootstrap5(app)                              # 初始化：模板里就能用 bootstrap.load_css() / load_js()

# ---------------------------------------------------------------- 演示数据
STUDENTS = [
    {'no': '2013110101', 'name': '张晓勇', 'cls': '软件1班', 'score': 92},
    {'no': '2013110102', 'name': '李梅',   'cls': '软件1班', 'score': 85},
    {'no': '2013110103', 'name': '王强',   'cls': '软件2班', 'score': 78},
    {'no': '2013110104', 'name': '赵敏',   'cls': '软件1班', 'score': 90},
]


def make_articles(num):
    """造 num 篇文章的列表（教材用 list 模拟文章列表，不查数据库）"""
    return [{'title': '文章%d标题' % i,
             'content': ('文章%d的内容 ' % i) * i} for i in range(1, num + 1)]


# ================================================================
# 一、基本语法：{{ 表达式 }} / {% 控制 %} / {# 注释 #}
# ================================================================
# ★ 本节重点：八个知识点的导航页
@app.route('/')
def index():
    return render_template('index.html',
                           title='Jinja2 演示首页',
                           name='谢福财',
                           count=len(STUDENTS),
                           students=STUDENTS)


# ★ 本节重点：变量注入（含默认值）
@app.route('/value')
# ★ 本节重点：按 URL 参数注入变量
@app.route('/value/<string:username>')
def value(username=None):
    # 同一个视图挂两个路由：带参数走带参数的，不带参数 username 就是 None
    # 模板里用 {{ username or '游客' }} 兜底 —— 教材 3.1 的写法
    return render_template('value.html', username=username)


# ★ 本节重点：宏集中定义文件
@app.route('/macros')
def macros():
    # 单文件内定义宏、单文件内调用（对照 /macro 的跨文件写法）
    return render_template('macros.html')


# ================================================================
# 二、控制结构：{% if %} / {% for %} / {% else %}（空列表分支）
# ================================================================
# ★ 本节重点：if 判断与 for 循环
@app.route('/control')
# ★ 本节重点：按参数控制循环次数
@app.route('/control/<int:num>')
def control(num=0):
    # 路径里的 <int:num> 自动转成整数；不传则为 0，正好演示"没有内容"的分支
    return render_template('control.html', num=num, articles=make_articles(num))


# ================================================================
# 三、模板的包含与继承
# ================================================================
# ★ 本节重点：include 引入页头页脚片段
@app.route('/include')
def include_demo():
    # include：把页头页脚拆成独立文件，多个页面共用（改一处，处处生效）
    return render_template('include_demo.html', title='模板的包含')


# ★ 本节重点：extends 模板继承
@app.route('/inherit')
def inherit():
    # extends：子模板继承 base.html 的骨架，只填 block 里的内容
    return render_template('inherit_child.html', title='模板的继承', students=STUDENTS)


# ================================================================
# 四、宏 macro：定义在单独文件里，用 {% import ... as ... %} 引入
# ================================================================
# ★ 本节重点：宏：像函数一样渲染片段
@app.route('/macro')
# ★ 本节重点：宏带参数
@app.route('/macro/<int:num>')
def macro(num=0):
    return render_template('macro_page.html',
                           num=num,
                           num_prev=num - 1,      # 点"−1"传回去的数
                           num_next=num + 1,      # 点"+1"传回去的数
                           articles=make_articles(num))


# ================================================================
# 五、注册全局对象：模板里直接当函数用，不用每个视图都传
# ================================================================
def range_list(x):
    """生成 0 到 x-1 的整数列表（教材原例）"""
    return list(range(x))


# 第一个参数是要注册的函数，第二个是模板里使用的别名
# 注册后任何模板都能写 {{ global_test(10) }}，不必再 render_template(..., 函数名=...)
app.add_template_global(range_list, 'global_test')
app.add_template_global(2026, 'YEAR')          # 全局对象不限于函数，任意类型都行


# ★ 本节重点：全局对象 g / url_for / request
@app.route('/global')
def global_():
    return render_template('global_demo.html')


# ================================================================
# 六、变量过滤器：内置的 + 自己注册的
# ================================================================
def convert_time(t):
    """时间戳 → '2026-11-20 17:08:36'。教材原例，参数是秒级时间戳"""
    return time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(t))


def score_level(score):
    """自定义过滤器：分数 → 等级（演示带判断的过滤器）"""
    if score >= 90:
        return '优秀'
    if score >= 80:
        return '良好'
    return '加油'


# 不写第二个参数时，过滤器名默认取函数名：convert_time
app.add_template_filter(convert_time)
app.add_template_filter(score_level)           # 模板里写 {{ 85 | score_level }}


# ★ 本节重点：过滤器管道写法
@app.route('/filter')
def filter_demo():
    return render_template('filter_demo.html',
                           students=STUDENTS,
                           ts=1572497288.095447,   # 教材里的那个时间戳
                           now=time.time())


# ================================================================
# 七、Flask-Bootstrap：用框架自带的 base 模板，省掉手写 CSS
# ================================================================
# ★ 本节重点：模板结合 Bootstrap
@app.route('/bootstrap')
def bootstrap_demo():
    return render_template('bootstrap_demo.html', students=STUDENTS)


if __name__ == '__main__':
    app.run(debug=True, port=5113)
