touch-callable：自动为 Python Function 生成 WebUI

给大家介绍一下我的业余项目： https://github.com/pengwk/touch-callable （求 Star 😝、求建议）

使用 Python 3 的 type annotation 特性，自动提取 Function 参数类型信息，生成 Web UI，只需要正常编写 Python function 就可以立刻开始一个简易的 Web 服务。

目前支持的类型有：

str
int
float
bool
datetime.datetime
datetime.date
datetime.time
enum.Enum
io.BytesIO
typing.BinaryIO

做这个项目的目的有两个：

希望集成项目里的各种零散脚本，将他们管理起来，方便大家（会 Python 的，不会 Python 的）使用，降低重复劳动。
希望在界面不是很重要的 Web 服务场景里，快速提供一个简易的 Web UI 开始服务。

后端使用的是 Flask，前端使用的是 Ant Design。

看一个例子：

# example.py
from datetime import datetime, date, time
from enum import Enum
import io
import typing


class Languages(Enum):
  Python = 'Python'
  PHP = 'PHP'
  Java = 'Java'


def demo(int_: int, str_: str, float_: float, bool_: bool,
         enum_: Languages,
         datetime_: datetime = datetime.now(),
         date_: date = date.today(),
         time_: time = time(1, 2, 3),
         bytes_io: io.BytesIO = None,
         binary_io: typing.BinaryIO = None):
  pass

会生成下面的界面：

pengwkgood

2019-12-01 16:16:09 +08:00

@ipwx 我想解决的不是 fastapi 想要解决的问题。fastapi 结合 type annotation 出 API 方便、专业，加上 swagger 调试起来很舒服，但是不是准备给不懂开发的人用的。

touch-callable 希望做到的是能生成一个简易但是非技术人员也能使用的 Web 界面，不需要使用这在界面上费心。只需要写好 function 加上 annotation 就好了。

pengwkgood

2019-12-01 17:01:36 +08:00

@rubycedar 严肃的编程本身确实不需要考虑非技术人员。但是有多场景不需要那么严肃的编程，比如，想通过编程解决一些重复劳动、或者想做些小工具，做这些事情的人很多没有足够的专业知识或者没有足够的时间来做，提供这样一个工具给他们，就能降低难度，方便他们做出他们想要工具。

ClericPy

2019-12-01 21:02:35 +08:00

之前发现函数可以自省以及类型注解以后, 确实想过函数可以自动转 UI (web ui, gui, terminal ui), 前段时间用 inspect 和 pydantic 弄了个类似的 https://github.com/ClericPy/ask4args , 主要是为了体验下 inspect 的一些用法, 后来发现 Gooey 和 Wooey, 感觉白折腾 UI 方面的了, 只要做好函数自省和类型转换的框架就够了...
等真做完了发现, 并不太需要这玩意, 就当写着练手了...... 难怪 PM 总是因为一句"你不是真的需要"把需求砍了

pengwkgood

2019-12-01 23:36:16 +08:00

@shidenggui 😊，Google 的 https://github.com/google/python-fire

CLI 有两个问题：

- 表达能力不够：CLI 的输入基本只能以字符串为主（文件什么的也是字符串的形式），不够直观。输出的展示也是字符串为主，或者字符画，对输出做可视化支持成本很高。Web 在这方面优势很大，基本就是选择框架，对接数据结构即可。
- 不够易用：命令行需要在每个使用者的机器上都安装，懂命令行怎么使用，这要求使用者懂点技术。Web 只需网络和浏览器，这一点只要是网民都可以。