API World!

“By default Flask looks for templates in a templates subdirectory 
located inside the main application directory. For the next version of 
hello.py, you need to create the templates subdirectory and store the 
templates defined in the previous examples in it as index.html and 
user.html, respectively.”

Excerpt From
Flask Web Development
Miguel Grinberg
This material may be protected by copyright.

按照狼书的说明，使用templates的好处是，把业务逻辑和代码的呈现逻辑进行了隔离，这样的好处是非常清晰，不会让程序员的思路混乱，当使用git checkout 3a后，检查目录结构如下：

(venv) MDMacPro/Users/madapapa/Study/madapapa.com/flaskr/flaskproject/
flaskygit:(e020af8) [12:20]ls
LICENSE     __pycache__ templates
README.md   hello.py

debug mode

“(venv) $ export FLASK_APP=hello.py
(venv) $ export FLASK_DEBUG=1
(venv) $ flask run”

Excerpt From
Flask Web Development
Miguel Grinberg
This material may be protected by copyright.

通过export FLASK_DEBUG=1开启debug模式，有两个好处

• reloader模式可以在修改源代码的同时，自动重启服务器，代码的修改结果在运行环境下自动生效，对调试非常友好
• debugger模式，可以让你的浏览器显示错误信息，不过在生产环境下绝对不能打开这个模式。

template和placeholder

template是包含了响应内容的文件，使用placeholder作为一个变量服务动态部分，这个动态部分包含在请求的文本里。使用实际值来代替变量，并且返回最终响应字符串的过程，就是渲染（rendering），flask使用一个非常强大的模版引擎：Jinja2。

Jinja是日语神庙的意思。

render_template函数

render_template函数使用Jinja2引擎，第一个参数是文件名“index.html”,第二个参数是一个key-values的键值对，其中na是user.html中的参数名称，name1是需要带入的真实参数值。

from flask import Flask, render_template
app = Flask(__name__)

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

@app.route('/user/<name1>')
def user(name1):
    return render_template('user.html', na=name1)

user.html文件的内容

<h1>Hello, {{ na }}!</h1>

{{na}}这种结构，可以带入各种参数格式,比如字典、列表、方法等等。

“<p>A value from a dictionary: {{ mydict['key'] }}.</p>
“<p>A value from a list: {{ mylist[3] }}.</p>”
“<p>A value from a list with variable index：{{ mylist[myvar] }}.</p>”
“<p>A value from an object's method: {{ myobj.somemethod() }}.</p>”

flask虚拟环境

根据flask官网介绍，使用虚拟环境来管理项目的依赖，包括开发与生产环境。

因为随着Python项目增多，很有可能要与不同的python库、甚至不同版本的python打交道。一个项目的新版本库文件与另外一个项目可能不兼容。

虚拟环境独立于python库，一个虚拟环境匹配一个项目。为一个项目安装的包不会影响其他项目包或系统包。

Python绑定venv模块来创造虚拟环境。

创建虚拟环境

macOS/Linux

$ mkdir flaskproject
$ cd flaskproject
$ python3 -m venv venv

激活虚拟环境

macOS/Linux

$  . venv/bin/activate

这里需要注意，这个“.”和venv之间要有空格，参见stackoverflow的解释：

. venv/bin/activate

or

source venv/bin/activate

使用虚拟环境，并设置为开发环境

在venv环境下，如果直接启动flask服务：

flask run

会有如下红色警告信息，因为flask默认开发者是生产环境下工作，而开发环境不稳定，所以会提示如下告警。

因此需要进行设置

(venv) MDMacPro/Users/XXXXXXXXXXXX/flaskr/flaskproject/bmi[23:58]export FLASK_ENV=development

参考flask设置环境变量

使用git checkout 2a

使用git checkout 2a 把对应project的source code复制到visual studio里面

由于已经通过git启动了相关程序，因此会展示如下内容。

使用git reset –hard

如果对git上的源代码进行了修改，可以使用git reset –hard放弃所有修改

(venv) MDMacPro/Users/madapapa/Study/madapapa.com/flaskr/flaskproject/flaskygit:(32acca2) ✗ [12:07]git reset --hard
HEAD is now at 32acca2 Chapter 2: Dynamic routes (2b)
(venv) MDMacPro/Users/madapapa/Study/madapapa.com/flaskr/flaskproject/flaskygit:(32acca2) [12:09]git checkout 3a
Previous HEAD position was 32acca2 Chapter 2: Dynamic routes (2b)
HEAD is now at e020af8 Chapter 3: Templates (3a)