学习《Flask Web开发：基于Python的Web应用开发实战》分享

# 学习《Flask Web开发：基于Python的Web应用开发实战》分享

- 一直在说学习Python，对同事，对朋友，都说我正在学习Python，这无形给自己一定的压力，促使自己要去学习，进步。

- Python的语法看了忘，忘了再看。每天学习时长不固定，会造成这样的效果。

- 然后看到这本书《Flask Web开发：基于Python的Web应用开发实战》，时间不长不短，也学习了一段时间，前后看了两三遍，学会了一些知识，在这里做一个整理、分享。

- 坚持学习很重要，活到老学到老，让我们一起学习Python吧。

- 下面从一个小项目中，分享一下。

- 小项目：采集[`廖雪峰的官方网站`](http://www.liaoxuefeng.com/)部分教程，并在Web中展示。

- 小项目在`Mac OS X`，`python3`中运行。(`python2`调试中)

## 1. 使用虚拟环境

- 与系统的Python解释器分开，在项目中的私有副本

### 安装

- 检查virtualenv

```

$ virtualenv -- version

```

- 安装virtualenv

```

$ sudo pip install virtualenv

```

- 新建一个文件夹作为项目目录

- 按照惯例，一般虚拟环境会被命名为 venv

```

virtualenv venv

New python executable in venv/bin/python

Installing distribute......done.

Installing pip.............done.

```

- 可指定python版本

```

virtualenv venv --python=python2.7

virtualenv venv --python=python3.5

```

- 激活这个虚拟环境

```

source venv/bin/activate

```

- 为了提醒你已经激活了虚拟环境，激活虚拟环境的 命令会修改命令行提示符，加入环境名

```

(venv) $

```

- 回到全局 Python 解释器

```

deactivate

```

### 使用pip安装Python包

- pip 的 安装请参见 [https://pip.pypa.io/en/latest/installing.html](https://pip.pypa.io/en/latest/installing.html)

- 在虚拟环境中安装 Flask

```

(venv) $ pip install flask

```

- 尝试导入 Flask

```

(venv) $ python

>>> import flask

>>>

```

### 第一个程序

```

from flask import Flask

app = Flask(__name__)#Flask 类的对象

'''

修饰器是 Python 语言的标准特性，可以使用不同的方式修改函数的行为。

惯常用法是使用修饰器把函数注册为事件的处理程序

'''

#app.route 修饰器，把修饰的函数注册为路由

@app.route('/')

def hello():

return '

Hello World

#程序会显示一个使用 name 动态参数生成的欢迎消息

@app.route('/user/')

def user(name):

return '

Hello, %s!

if __name__ == '__main__':#__name__=='__main__' 是 Python 的惯常用法

app.run(debug=True)#要想启用调试模式，我们可以把 debug 参数设为 True

```

### 运行

```

#保存以上程序至上述项目根目录 hello.py

(venv) $ python hellp.py

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

* Restarting with stat

* Debugger is active!

* Debugger PIN: 277-775-896

#访问 http://127.0.0.1:5000/ 与 http://127.0.0.1:5000/user/Python 即可

```

## 2. 初始项目结构

```

|-flasky

|-app/

|-templates/

|-static/

|-main/

|-__init__.py

|-errors.py

|-forms.py

|-views.py

|-collect/

|-__init__.py

|-__init__.py

|-models.py

|-migrations/

|-venv/

|-requirements.txt

|-config.py

|-manage.py

```

- Flask 程序一般都保存在名为 app 的包中;

- migrations文件夹包含数据库迁移脚本;

- venv文件夹包含Python虚拟环境。

- pip 可以使用如下命令自动生成requirements.txt文件

- 该文件便是项目中所需要的所有Python包

```

(venv) $ pip freeze > requirements.txt

```

- 创建一个新的虚拟环境，并在其上运行以下命令

- 即可安装该项目中所需要的所有Python包

```

(venv) $ pip install -r requirements.txt

```

- 创建迁移仓库

```

(venv) $ python manage.py db init

```

- 创建迁移脚本

```

(venv) $ python manage.py db migrate -m "initial migration"

```

- 更新数据库

```

(venv) $ python manage.py db upgrade

```

- 启动脚本

```

(venv) $ python manage.py runserver

```

## 3. 定义模型

```

from datetime import datetime

from . import db

from sqlalchemy.dialects.mysql import TINYINT, LONGTEXT

from .collect import create_collect

class Index(db.Model):

__tablename__ = 'indexs'

id = db.Column(db.Integer, primary_key=True)

name = db.Column(db.String(64))

url = db.Column(db.String(255))

html = db.Column(LONGTEXT)

status = db.Column(TINYINT(3), default=0)

dateline = db.Column(db.DateTime(), default=datetime.utcnow)

lists = db.relationship('List', backref='list', lazy='dynamic')

def __repr__(self):

return '' % self.name

class List(db.Model):

__tablename__ = 'lists'

id = db.Column(db.Integer, primary_key=True)

index_id = db.Column(db.Integer, db.ForeignKey('indexs.id'))

name = db.Column(db.String(64))

url = db.Column(db.String(255))

html = db.Column(LONGTEXT)

status = db.Column(TINYINT(3), default=0)

dateline = db.Column(db.DateTime(), default=datetime.utcnow)

def __repr__(self):

return '' % self.name

```

## 4. 采集数据

```

#采集页面列表

@manager.command

def collect_index(name='liaoxuefeng'):

Index.index_add(name)

Index.index_edit(name)

#采集列表页面

@manager.command

def collect_list_add(name='liaoxuefeng'):

List.list_add(name)

#采集列表内容

@manager.command

def collect_list_edit(name='liaoxuefeng'):

List.list_edit(name)

#在终端执行

(venv) $ python manage.py collect_index

```

## 5. 定义路由

```

#首页 采集页面列表

@main.route('/')

def index():

pass

#添加采集页面

@main.route('/index_add', methods=['GET', 'POST'])

def index_add():

pass

#编辑采集页面

@main.route('/index_edit/', methods=['GET', 'POST'])

def index_edit(id):

pass

#删除添加采集页面

@main.route('/index_delete/')

def index_delete(id):

pass

#采集页面下的列表页面

@main.route('/index//list')

def index_list(id):

pass

#列表页面

@main.route('/list')

def list_list():

pass

#添加列表页面

@main.route('/list_add', methods=['GET', 'POST'])

def list_add():

pass

#编辑列表页面

@main.route('/list_edit/', methods=['GET', 'POST'])

def list_edit(id):

pass

#删除列表页面

@main.route('/list_delete/')

def list_delete(id):

pass

#详细页面

@main.route('/list_view/')

def list_view(id):

pass

```

## 6. CRUD

```

from flask_wtf import FlaskForm

from wtforms import StringField, SelectField, RadioField, TextAreaField, SubmitField

from wtforms.validators import Required, Length, URL

from wtforms import ValidationError

from ..models import Index, List

class IndexForm(FlaskForm):

name = StringField('Name', validators=[Length(0, 64)])

url = StringField('Url', validators=[Required(), Length(1, 255), URL()])

html = TextAreaField('Html')

status = RadioField('Status', coerce=int, default='0')

submit = SubmitField('Submit')

def __init__(self, index=None, *args, **kwargs):

super(IndexForm, self).__init__(*args, **kwargs)

self.status.choices = [(0, 'Initial'), (1, 'Downloaded'), (2, 'Deprecated')]

self.index = index

def validate_url(self, field):

if self.index is None:

if Index.query.filter_by(url=field.data).first():

raise ValidationError('Url already in use.')

else:

if self.index.url != field.data and \

Index.query.filter_by(url=field.data).first():

raise ValidationError('Url already in use.')

class ListForm(FlaskForm):

index_id = SelectField('Index id', coerce=int)

name = StringField('Name', validators=[Length(0, 64)])

url = StringField('Url', validators=[Required(), Length(1, 255), URL()])

html = TextAreaField('Html')

status = RadioField('Status', coerce=int, default=0)

submit = SubmitField('Submit')

def __init__(self, item=None, *args, **kwargs):

super(ListForm, self).__init__(*args, **kwargs)

self.index_id.choices = [(index.id, index.name) for index in Index.query.filter_by(status=1).all()]

self.status.choices = [(0, 'Initial'), (1, 'Downloaded'), (2, 'Deprecated')]

self.item = item

def validate_url(self, field):

if self.item is None:

if List.query.filter_by(url=field.data).first():

raise ValidationError('Url already in use.')

else:

if self.item.url != field.data and \

List.query.filter_by(url=field.data).first():

raise ValidationError('Url already in use.')

```

## 7.运行

- 本项目代码存放在github中 [https://github.com/bstdn/flask_collect](https://github.com/bstdn/flask_collect)

```

#运行项目

git clone https://github.com/bstdn/flask_collect.git

cd flask_collect

virtualenv venv

source venv/bin/activate

(venv) $ pip install -r requirements.txt

#定义环境变量 或 修改config.py中配置指定数据库

(venv) $ export SECRET_KEY=

(venv) $ export DEV_DATABASE_URL=

(venv) $ python manage.py db upgrade

(venv) $ python manage.py collect_index

(venv) $ python manage.py collect_list_add

(venv) $ python manage.py collect_list_edit

(venv) $ python manage.py runserver

#访问 http://127.0.0.1:5000/

```