濒危 Flask 扩展拯救计划

The Endangered Flask Extension Rescue Plan

PyCon China 2023 上海 💊 2023/12/02

## 李辉 / Grey Li - https://greyli.com - Flask 维护者 - APIFlask 维护者 - 代码厨房社区管理员 <br> <img src="./images/apiflask.png" width="200px"> <img src="./images/ck-logo.png" width="200px">

# Flask ``` $ pip install Flask ``` ``` from flask import Flask app = Flask(__name__) @app.route('/') def hello(): return 'Hello, World!' ``` ``` $ flask run --debug ```

# Flask Extension ``` $ pip install flask-sqlalchemy ``` ``` from flask import Flask from flask_sqlalchemy import SQLAlchemy app = Flask(__name__) db = SQLAlchemy(app) ```

## 目录 - The Question - The Story - The Plan

<h1 style="color: white;">The Question</h1>

## 如何拯救濒危 Flask 扩展？

## 如何拯救濒危 Flask 扩展？ <img src="./images/hello-ai.jpg" height="350px">

## 如何拯救濒危 Flask 扩展？ <img src="./images/hello-ai2.jpg">

## Hello AI <img src="./images/gpt-3-example1.png" width="80%">

<img src="./images/flask-mailplus.png">

## Hello AI <img src="./images/gpt-3-example2.png" width="80%">

## Hello AI <img src="./images/gpt-4-example.png">

<img src="./images/goodbye-ai.jpg">

~~如何拯救濒危 Flask 扩展？~~ 1. 如何拯救一个被遗弃的开源项目？ 2. 如何更新一个古老 Python 项目？

### 1. 如何拯救一个被遗弃的开源项目？

## 获得权限 - GitHub - PyPI

## <span style="color: grey;">~~获得权限~~</span> ## 赢得信任

### GitHub Actions for PyPI publish✨ <small>https://docs.pypi.org/trusted-publishers/adding-a-publisher/</small> ``` jobs: pypi-publish: name: upload release to PyPI runs-on: ubuntu-latest # Specifying a GitHub environment is optional, but strongly encouraged environment: release permissions: # IMPORTANT: this permission is mandatory for trusted publishing id-token: write steps: # retrieve your distributions here - name: Publish package distributions to PyPI uses: pypa/gh-action-pypi-publish@release/v1 ```

## Bus Factor <img src="./images/bus-factor.png" height="500px"> <small>original image: https://medium.com/tech-tajawal/the-bus-factor-6ea1a3ede6bd</small>

## 给维护者的建议 - 至少两个 GitHub 维护者 - 至少两个 PyPI 维护者 - 设置 GitHub Actions for PyPI publish - 设置 GitHub 账户继任者 - 捐赠项目给社区组织（比如 pallets-eco）

## 最后一招：Make a new one

### 2. 如何更新一个古老 Python 项目？

## nose ➡️ pytest <small>Example: https://github.com/miracle2k/flask-assets/pull/161</small>

## Travis CI ➡️ GitHub Actions <small>Example: https://github.com/miracle2k/flask-assets/pull/162</small>

## setup.py ➡️ pyproject.toml <small>https://packaging.python.org/en/latest/guides/writing-pyproject-toml/</small> ``` pip install build python -m build ```

## pyupgrade <small>https://github.com/asottile/pyupgrade</small> ``` pip install pyupgrade pyupgrade --py36-plus app.py ```

<h1 style="color: white;">The Story</h1>

# 2018

<img src="images/book.jpg" height="400px">

### Flask-Bootstrap 💊 Flask-Bootstrap ➡️ Bootstrap-Flask

<img src="images/bf.png" height="600px">

# 2020

<img src="images/flask-book2.jpg" height="400px">

# 2023

### Flask-Mail 💊 Flask-Mail ➡️ Flask-Mailman

### Flask-Mailman💊

<img src="images/flask-mailman-chat.png" height="400px">

<img src="images/flask-mailman.png" height="600px">

### Flask-Assets 💊

<img src="images/flask-assets-chat.png" height="600px">

<img src="images/flask-assets.png" height="600px">

### Flask-DebugToolbar 💊

<img src="images/flask-debug-chat.png" height="600px">

<img src="images/flask-debug.png" height="600px">

## 最终成果 - Flask-Bootstrap ➡️ Bootstrap-Flask🔅 - Flask-Mail ➡️ Flask-Mailman🔅 - Flask-DebugToolbar🔆 - Flask-Assets🔅

<h1 style="color: white;">The Plan</h1>

### ✅ 在 PyCon China 2023 做一个演讲《濒危 Flask 扩展拯救计划》

### ✅ Flask Extension Status <small>https://github.com/greyli/flask-extension-status</small> <img src="./images/status.png">

<img src="./images/flask-status.png" height="350px">

### ✅ 代码厨房开源松 <small>https://codekitchen.community/c/song</small> <img src="./images/kitchen-song.png">

<img src="./images/four-badges.png" height="400px">

### ✅ 号召大家加入进来

### ⬜ 推广「GitHub Actions for PyPI publish」

### ⬜ 发布 Flask 扩展开发教程

<img src="./images/mona-the-rivetertocat.png">

### PyCon China 2024 见！ <img src="./images/wechat.png" height="200px"> Email: withlihui@gmail.com 代码厨房: https://codekitchen.community