# flask_collect
**Repository Path**: bstdn/flask_collect
## Basic Information
- **Project Name**: flask_collect
- **Description**: 学习《Flask Web开发：基于Python的Web应用开发实战》分享
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 1
- **Created**: 2019-07-29
- **Last Updated**: 2024-01-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 学习《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!
' % name
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/
```
## 效果展示
