Python的框架-Flask

Flask 是一个十分小巧的Python Web 框架，本文是一篇最简单的 Flask 入门教程，本文所基于的前提是你的电脑已经安装了Python.

如果你是将Flask完整的下载了下来
(http://pypi.python.org/packages/source/F/Flask/Flask-0.8.tar.gz)，你可以使用其自己提供的安装工具安装：
# wget http://pypi.python.org/packages/source/F/Flask/Flask-0.8.tar.gz
# tar zxvf Flask-0.8.tar.gz
# cd Flask-0.8
#python setup.py install

创建最简单的 Flask 程序
一个标准的 Flask 程序具有如下的目录结构:

/yourapplication
    /app.py
    /static
        /style.css
        /...
    /templates
        /layout.html
        /index.html
        /...

其中 app.py 不是必须的，我们可以取任何一个合理的文件名，当然，我本示例中，我们将把所有的代码都写在这个文件里面，static 文件夹可以保存一些静态文件，如CSS或者JS文件，而templates刚保存模板文件。
app.py

我们现在创建一个小程序，当用户访问：http://127.0.0.1:5000/ 时，页面上面简单的返回：Hello Flask文字，访问：http://127.0.0.1:5000/flask 时返回 “This page’s path is /flask 文字”，代码如下：

#!/usr/bin/env python
# encoding: utf-8
from flask import Flask
app = Flask(__name__)
@app.route('/')
def helloflask():
    return "Hello Flask"
@app.route('/flask')
def flask_page():
    return "This page's path is /flask"
if __name__ == "__main__":
    app.run()

将上面代码复制到 app.py 文件中，直接运行之：@python app.py@ 即可，这个时候我们去浏览器里面访问上面提到的两个地址，就可以得到想要的结果。
示例程序详解

在上面的示例中，我们做了下面这些事情：

    from flask import Flask是从flask中导入Flask，然后我们再使用其提供的方法创建了一个实例@app = Flask(name)@
    接着我们设置两个路径@/@和@/flask@，让这两个路径分别对应相应的处理方法@helloflask()@和@flask_page()@，这两个方法分别返回我们需要的文字。
    接着最后我们一个 if 语句，表示，如果是直接运行该文档，刚创建服务并运行这个程序。

更大的程序
如果你想创建更大的程序，刚可以使用Session，Render_Template等等更高级的模块，你可以访问Flask官方网站以获得更多的帮助： http://flask.pocoo.org/
----------------------------------------------------------------------------

在linux vps上安装Flask

Flask是基于python、Werkzeug、 Jinja 2的一个轻量级WEB框架。python的web框架很多，个性差别很大，找到很久找到了flask，主要是几个原因：轻量级、久仰jinja、pocoo的名声不错。
主流的linux发行版本上，安装nginx和python都是非常轻松的，比如在archlinux上：
#pacman -S nginx python2
利用easy_install安装flask:
#easy_install flup
#easy_install flask
新建WEB目录：$mkdir www
新建主PY文件:$vim www/app.py

#!/usr/bin/env python
# encoding: utf-8
from flask import Flask
app = Flask(__name__)
@app.route("/")
def helloworld():
        return "Hello World!"

创建fcgi文件：$vim www/fcgi.py

#!/usr/bin/env python
# encoding: utf-8
from app import app
from flup.server.fcgi import WSGIServer
WSGIServer(app,bindAddress='/tmp/flask_le5le.sock').run()

配置nginx站点：
# vim /etc/nginx/conf/vhosts/flask.le5le

server{
         listen 80;
         server_name flask.le5le.com;
         location / {
             include fastcgi_params;
             fastcgi_param SCRIPT_FILENAME "";
             fastcgi_param PATH_INFO $fastcgi_script_name;
             fastcgi_pass unix:/tmp/flask_le5le.sock;
                 }
         }

#vim /etc/nginx/conf/nginx.conf
在http{}中加入vhosts目录：

include vhosts/*;

运行fcgi.py:
$ python www/fcgi.py
用ROOT帐户修改sock文件权限：
# chmod 777 /tmp/flask_le5le.sock
重启nginx:
# /etc/rc.d/nginx restart
现在用浏览器访问站点就能看到”hello world”了。
---------------------------------------------------------------
flask的安装

准备工作：先安装easy_install，如果不是windows系统，请直接到1）。

安装easy_install：将链接http://peak.telecommunity.com/dist/ez_setup.py 直接保存到本地某个目录下，本文将之保存到python安装目录下，然后双击运行，它将自动安装到python安装目录/Scripts 下面；然后再在系统环境变量的PATH中添加easy_install所在的目录，即
....;python安装目录/Scripts;
1）安装 virtualenv，这个主要是用来做解释器环境隔离的，避免同一机器上的多个python或者多个python的库依赖
linux and mac os x：
sudo easy_install virtualenv
或者 sudo pip install virtualenv
或者如果是ubuntu，可以
sudo apt-get install python-virtualenv
或者windows在任意命令行下：
easy_install virtualenv
2 ) 工程目录创建，这里是每一个新工程的起点

$ mkdir myproject
   $ cd myproject
   $ virtualenv env
   New python executable in env/bin/python
   Installing setuptools............done.

3）激活，如果是在linux或者mac os下，则：

   $ . env/bin/activate

如果是windows下，则

   $ env/scripts/activate

4）安装flask
easy_install Flask到本目录下
或者用管理员权限安装，windows下不用sudo，只需要用administrator
sudo easy_install Flask
5）如果是想要最新的Flask版本进行开发，有两种方式，一种用git，另一种让easy_install自己拽
5.1）git方式：

$ git clone http://github.com/mitsuhiko/flask.git
Initialized empty Git repository in ~/dev/flask/.git/
$ cd flask
$ virtualenv env
$ . env/bin/activate
New python executable in env/bin/python
Installing setuptools............done.
$ python setup.py develop
...
Finished processing dependencies for Flask

5.2）easy_install安装方式：

$ mkdir flask
$ cd flask
$ virtualenv env
$ . env/bin/activate
New python executable in env/bin/python
Installing setuptools............done.
$ easy_install Flask==dev
...
Finished processing dependencies for Flask==dev

笔者使用后面这种，这样不仅flask下来了，随之而来的还有jinjia2，werkzeug，很方便就可以搭建一个开发环境了
6) 与SQLAlchemy集成
$easy_install Flask-SQLAlchemy


OK，已经完成了安装过程，可以进行开发了.
-------------------------------------------------------------

Flask-Babel 简介

最近用 Flask 给公司做了个小 web 应用，做的时候用英文了，现在要求翻译成中文。查看官方文档，发现有些内容讲得不甚详细，尤其缺乏一个完整的 walkthrough。于是我把自己的翻译流程大致总结一下，贴在这里供大家分享。由于我的 app 比较简单，本文也不会涉及到获取 locale 以及显示时间格式等话题，详细信息还是请多读官方文档和实际案例，使用 google code 搜索 flaskext.babel 可以看到很多案例应用。

安装 Flask-Babel

Flask-Babel 是 Flask 的翻译扩展工具。安装命令如下：

pip install flask-babel

安装它的时候会顺便安装 Babel、pytz、speaklater 这三个包，其中 Babel 是 Python 的一个国际化工具包。pytz 是处理时区的工具包，speaklater 相当于是 Babel 的一个辅助工具，我们这里集中在翻译流程上，这几个工具就供以后进一步了解吧。

Hello, World

接下来我们做一个简单的 Hello World 程序，新建一个叫 hello 的文件夹，在其中创建一个叫 hello.py 的文件，内容如下：

from flask import Flask, render_template</code>

app = Flask(__name__)

@app.route('/')
def hello():
    day = "Saturday"
    return render_template('index.html', day=day)

if __name__ == '__main__':
    app.debug = True
    app.run()

然后在 hello.py 的同一级目录下创建一个叫 templates 的文件夹，在其中写一个 index.html，内容如下：

<p>Hello, world!</p>
<p>It's {{ day }} today.</p>

很简单的 Hello World 程序，接下来我们要做的是让这个站变成中文站。

更新程序和模板

再接下来就是翻译了。翻译需要用到 flask-babel 这个 flask 扩展。首先我们将这个 app “国际化”，为模板和 .py 文件中的每一个字符串添加一个 gettext 函数，由于 gettext 函数被引用的次数太多了，为了方便手写，就将其 import 为 “_”：

from flask import Flask, render_template</code>

from flaskext.babel import Babel, gettext as _

app = Flask(__name__)
app.config['BABEL_DEFAULT_LOCALE'] = 'zh_CN'
babel = Babel(app)

@app.route('/')
def hello():
    s = _("Saturday")
    return render_template('index.html', day=day)

if __name__ == '__main__':
    app.debug = True
    app.run()

然后修改模板：

<p>{{ _("Hello, world!") }}</p>
<p>{{ _("It's %(day)s today", day=day) }}</p>

你可以注意到我们对 app 的 locale 做了配置，然后用 babel 扩展将 app 再次初始化，并且将 .py 和 .html 中的字符串做了配置，让它们都使用 gettext 这个函数。其中值得注意的是 gettext 的格式化字符串的参数。如果直接用类似 "It's %s today" % day 是不行的。
这么一来，app 的语言其实是被写死成中文了。其实你可以在 flask 程序中让用户选择自己喜好的语言，或者依据浏览器设置用户优先显示的语言，详细做法可以参考官方文档中提到 localeselector 的部分。

设置 Babel

接下来我们要做的是 babel 的配置。在 hello.py 的同级目录创建一个叫 babel.cfg 的文件，内容如下：

[python: **.py]
[jinja2: **/templates/**.html]
extensions=jinja2.ext.autoescape,jinja2.ext.with_

生成翻译模板

这样 babel 就知道要从哪些位置搜索要翻译的字符串了。然后我们用 pybabel 生成要翻译的 PO 模板文件，这个命令是 babel 这个工具包带来的，生成翻译模板命令如下：

$ pybabel extract -F babel.cfg -o messages.pot .

注意结尾的点“.”，这个点表示当前目录，目录是 pybabel 必须的参数，官方文档中缺少这个点，所以命令是无法执行成功的。messages.pot 就是我们生成的翻译模板文件，内容大致如下：

# Translations template for PROJECT.
# Copyright (C) 2011 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR , 2011.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
"POT-Creation-Date: 2011-07-26 15:39+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 0.9.6\n"</code>

#: hello.py:11
msgid "Saturday"
msgstr ""

#: templates/index.html:1
msgid "Hello, world!"
msgstr ""

#: templates/index.html:2
#, python-format
msgid "It's %(day)s today"
msgstr ""

你可以修改里边头文件的信息，把个人和项目相关的资料加进去。

翻译

接下来我们创建中文翻译：

$ pybabel init -i messages.pot -d translations -l zh_CN

这句命令会在 hello 文件夹中生成一个 translations 文件夹，要确保 flask 能找到翻译内容，translations文件夹要和 templates 文件夹在同一个目录中。接下来我们就可以进行翻译了，修改 translations/zh_CN/LC_MESSAGES/messages.po 文件，将其中的内容翻译过来：

# Chinese (China) translations for PROJECT.
# Copyright (C) 2011 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR , 2011.
#
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
"POT-Creation-Date: 2011-07-26 15:39+0800\n"
"PO-Revision-Date: 2011-07-26 09:07+0800\n"
"Last-Translator: FULL NAME \n"
"Language-Team: zh_CN \n"
"Plural-Forms: nplurals=1; plural=0\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 0.9.6\n"</code>

#: hello.py:11
msgid "Saturday"
msgstr "星期六"

#: templates/index.html:1
msgid "Hello, world!"
msgstr "哈罗，世界！"

#: templates/index.html:2
#, fuzzy, python-format
msgid "It's %(day)s today"
msgstr "今天是%(tag)s"

PO文件的翻译其实可以用专门的工具来编辑，比如 Poedit，不过小文件直接手译就可以了。

编译翻译结果

翻译完后执行下面的命令，为其编译出 message.mo 文件：

$ pybabel compile -d translations

如果上述命令无法生成 messages.mo 文件，那你需要将 message.po 中的 #, fuzzy 删除。
然后就算基本完成了。这时执行 python hello.py 就会看到翻译的中文页面了。

更新翻译

有时我们需要对程序和模板做修改，翻译也要随之更新。更新后需要用前面的命令重新生成 messages.pot 文件，然后使用下面的命令将更新的内容 merge 到原来的翻译中：

$ pybabel update -i messages.pot -d translations

最后再到对应 locale 的文件夹下更新翻译并 compile 即可。

from http://readthedocs.org/docs/translations/en/latest/flask-babel.html 

--------------------------------------

 

Hello, Flask!

docs.helloflask.com  

 

HelloFlask

HelloFlask 的 Meta 仓库，包含 HelloFlask 相关文档和示例程序。

Links

• 文档：https://docs.helloflask.com
• 主站：https://helloflask.com
• 论坛：https://discuss.helloflask.com

Books

• Flask Web 开发实战：https://helloflask.com/book/1
• Python Web API 设计与开发：https://helloflask.com/book/2
• Flask 入门教程：https://helloflask.com/book/3
• Flask Web 开发实战（第 2 版）：https://helloflask.com/book/4

Docs

一些快速链接：

• 《Flask Web 开发实战》示例程序索引
• 《Flask Web 开发实战》勘误
• 《Flask Web 开发实战（第 2 版）》代码片段

from https://github.com/greyli/helloflask