WEB项目-FLASK开发手记-flask-mega-tutorial 实战小结

flask环境搭建完成以后，就要开始flask开发了。为了学以致用，参考网上推荐的STEP BY STEP教程：，进行，整个过程，大约持续了2周，基本上每天1-2的速度，敲代码，测试效果。虽然作者很用心的进行了翻译，但是还是推荐英文原版：http://blog.miguelgrinberg.com/post/the-flask-mega-tutorial-part-i-hello-world。这篇教程的特点是大而全，随之带来的问题，博而不专，杂而不精，对所有模块缺乏深度。对于初学者，可能很有成就感，但是一旦遇到问题，调试起来比较痛苦。当然粘贴代码的风险可能较小，但是那样自己动手动能力短时间很难得到迅速的提升。

这里根据自己手动敲代码遇到的一些问题，同时【编写高质量代码：改善Python程序的91个建议】进行了部分整理。如有不当之处，欢迎指正。

 1 理解CGI,FASTCGI,WSGI的大体概念。大体了解

CGI标准，它提供了WEB通信的标准，由于其实现方式为one request one process方式，导致其高并发发现存在严重的瓶颈

FASTCGI通过事件驱动或是多线程、多进程的方式实现了池的概念，实现了server与应用程序的解耦

而WSGI 通过定义接口规范，进一步实现了WEB SERVER与应用程序之间的解耦和。

1 强烈推荐使用virtualenv进行环境搭建，pip 包管理工具的使用

pip list
pip show
pip install
pip freeze
pip download
pip search
pip wheel

2 字符串的处理。

字符串的格式化还是推荐使用FORMAT函数

占位符的格式化

>>> a=1.034
>>> "value of {0}  after value format is:{1:<8.4f}".format(a,a)
'value of 1.034  after value format is:1.0340  '
>>> "value of {0}  after value format is:{1:^8.4f}".format(a,a)
'value of 1.034  after value format is: 1.0340 '
>>> "value of {0}  after value format is:{1:>8.4f}".format(a,a)
'value of 1.034  after value format is:  1.0340'

多行字符串的编写，通常我们熟悉使用docstring,,但是还有更巧妙的trick

>>> s1=('select '
... ' abc '
... ' from '
... ' dual ')
>>> s2='''
... select
... abc
... from
... dual
... '''
>>> s2
'\nselect \nabc\nfrom \ndual\n'
>>> s1
'select  abc  from  dual '

相比较而言，S1更符合我们的理解，S2便于书写。这里利用技巧就是python遇到未闭合的小括号时，会自动将多行代码拼接为一行和把相邻的两个字符串自动拼接在一起的特性。别问我出处，我也不知道。

3 包的引入，管理，与使用

本质上每一个python文件都是一个模块，同时还含有__init__.py文件，这样就构成了一个python。init在包被导入的使用执行。

H:\webabc\testpkg 的目录
2016/06/25  15:36                91 mod1.py
2016/06/25  15:31                90 mod2.py
2016/06/25  15:59                90 __init__.py
code:
testpkg/__init__.py
print "file  is {0},__name__ is:{1} ".format(__file__,__name__)
 H:\webabc\test.py
import testpkg
print "file  is {0},__name__ is:{1} ".format(__file__,__name__)
(venv) H:\webabc>python test.py
file is H:\webabc\testpkg\__init__.pyc,__name__ is:testpkg
file is test.py,__name__ is:__main__
说明__INIT__在被导入地时候被执行
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'testpkg']
说明包中的模块并没有被导入
>>> testpkg.mod1
Traceback (most recent call last):
  File "", line 1, in <module>
AttributeError: 'module' object has no attribute 'mod1'
手动导入mod1,包中的资源可以访问,即早执行导入动作的时候，module注册到了包中
>>> from testpkg import mod1
file is testpkg\mod1.pyc,__name__ is:testpkg.mod1
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'mod1', 'testpkg']
>>> testpkg.mod1.module_name
'module1 one'
效果和下面一样
>>> from testpkg import mod1
file is testpkg\__init__.pyc,__name__ is:testpkg
file is testpkg\mod1.pyc,__name__ is:testpkg.mod1
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'mod1']

注意二者之间的差别：
>>> from testpkg import *
file is testpkg\__init__.pyc,__name__ is:testpkg
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__']
>>> import testpkg
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'testpkg']
import * 啥也没有干，
import xx导入了对应的package
__all__=[] 控制了可以导入module的清单
testpkg/__init__.py
__all__=['mod1','mod2']
>>> import testpkg
file is testpkg\__init__.py,__name__ is:testpkg
>>> dir(testpkg)
['__all__', '__builtins__', '__doc__', '__file__', '__name__', '__package__
_path__']
>>> testpkg.__all__
['mod1', 'mod2']
上面说到__INIT__在导入包的过程中执行，__all__可以对导入的模块进行控制。当我们偷懒import *
发现包中的模块并没有被导入，由此我们想到可以在__init__中执行包的导入
testpkg/__init__.py
import mod1
>>> import testpkg
file is testpkg\__init__.py,__name__ is:testpkg
file is testpkg\mod1.pyc,__name__ is:testpkg.mod1
>>> dir(testpkg)
['__builtins__', '__doc__', '__file__', '__name__', '__package__', '__path__', '
mod1']
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'testpkg']
>>> dir(testpkg.mod1)
['__builtins__', '__doc__', '__file__', '__name__', '__package__', 'module_name'
]

需要了解python为了合理的组织包资源，设计了__INIT__,__ALL__，以及通过控制__INIT__来达到导入module的目的。

同时不推荐使用IMPORT *

4  flask的大体框架：

H:\WEBABC\FLASK
|   app.db
|   babel.cfg
|   config.py
|   config.pyc
|   db_create.py
|   db_downgrade.py
|   db_migrate.py
|   delete.py
|   insert.py
|   myapp.py
|   run.py
|   test.db
|   tests.py
|  
+---app
|   |   forms.py
|   |   forms.pyc
|   |   models.py
|   |   models.pyc
|   |   momentjs.py
|   |   momentjs.pyc
|   |   views-chaper4.py
|   |   views-T1.py
|   |   views.py
|   |   views.pyc
|   |   __init__.py
|   |   __init__.pyc
|   |  
|   +---static
|   |   +---css
|   |   |       bootstrap-responsive.css
|   |   |       bootstrap-responsive.min.css
|   |   |       bootstrap.css
|   |   |       bootstrap.min.css
|   |   |      
|   |   +---img
|   |   |       glyphicons-halflings-white.png
|   |   |       glyphicons-halflings.png
|   |   |      
|   |   \---js
|   |           bootstrap.js
|   |           bootstrap.min.js
|   |           moment.min.js
|   |          
|   +---templates
|   |       404.html
|   |       505.html
|   |       base-chapter4.html
|   |       base.html
|   |       edit.html
|   |       index.html
|   |       login.html
|   |       post.html
|   |       search_results.html
|   |       user.html
|   |      
|   \---views
+---db_repository
|   |   manage.py
|   |   migrate.cfg
|   |   README
|   |   __init__.py
|   |   __init__.pyc
|   |  
|   \---versions
|           001_migration.py
|           001_migration.pyc
|           002_migration.py
|           002_migration.pyc
|           003_migration.py
|           003_migration.pyc
|           __init__.py
|           __init__.pyc
|          
+---search.db
|   \---Post
|           MAIN_6srgjvvmhe4gvw3z.seg
|           MAIN_ebdgmzwjvvyhzel7.seg
|           MAIN_qgap332avjvc5um7.seg

5 debug工具的使用

S/N/C/bt/l/w/u/的使用

6 FLASK的模块，这里重点看一下SQLALCHEMY模块

>>> from flask.ext.sqlalchemy import SQLAlchemy
>>> from flask import Flask
>>> flaskmidware=Flask('test.py')
>>> db=SQLAlchemy(flaskmidware)
>>> db.get_app()
<Flask 'test.py'>

>>> print flaskmidware.__doc__
The flask object implements a WSGI application and acts as the central
    object.  It is passed the name of the module or package of the
    application.  Once it is created it will act as a central registry for
    the view functions, the URL rules, template configuration and much more.

    The name of the package is used to resolve resources from inside the
    package or the folder the module is contained in depending on if the
    package parameter resolves to an actual python package (a folder with
    an `__init__.py` file inside) or a standard module (just a `.py` file).