只需一行代码,将Python程序转换为图形界面

gooey项目支持用一行代码将(几乎)任何python控制台程序转换为gui应用程序。

1.快速开始

开始之前,你要确保python和pip已经成功安装在电脑上。

(方式一)安装gooey的最简单方法是通过 pip:

pip install gooey


(方式二)或者,可以通过将项目克隆到本地目录来安装gooey

git clone https://github.com/chriskiehl/gooey.git

解压后进入该文件夹,运行 setup.py:

python setup.py install

2.使用方法

gooey 通过将一个简单的装饰器附加到主函数上,然后使用gooeyparser可将你所有需要用到的参数可视化为文本框、选择框甚至是文件选择框。

比如在scihub文献下载的文章中,我们需要输入两个参数:1.关键词,2.下载篇数,使用gooey可以这么改:

from gooey import gooey, gooeyparser

@gooey
def main():
    parser = gooeyparser(description="中文环境可用的scihub下载器 - @python实用宝典")
    parser.add_argument('path', help="下载路径", widget="dirchooser")
    parser.add_argument('keywords', help="关键词")
    parser.add_argument('limit', help="下载篇数")
    args = parser.parse_args()
    search(args.keywords, int(args.limit), args.path)


gooeyparser 和 argumentparser 一样,使用 add_argument 就可以增加输入参数,不同的是 gooeyparser 提供了可视化的选项:

parser.add_argument('path', help="下载路径", widget="dirchooser")


这一行代码,widget 参数给 args.path 变量提供了一个目录选择器(widget="dirchooser"),help参数用于提醒用户该选择器的作用,效果如下:

当你不提供widget参数时,程序默认使用文本输入框。

parser.add_argument('keywords', help="关键词")
parser.add_argument('limit', help="下载篇数")

gooey会自动编排你的参数,因此你不需要担心各个文本框或选择框的显示问题。代码中的:

args = parser.parse_args()
search(args.keywords, int(args.limit), args.path)


args = parser.parse_args() 可以将用户输入的所有文本转化为对应对象的变量值,通过 args.var 可以直接提取对应的变量值。

这个简单的可视化程序完整代码及效果如下:

上滑查看更多代码

import asyncio
from scihub import scihub
from gooey import gooey, gooeyparser

def search(keywords: str, limit: int, path: str):
    """
    搜索相关论文并下载

    args:
        keywords (str): 关键词
        limit (int): 篇数
        path (str): 下载路径
    """

    sh = scihub()
    result = sh.search(keywords, limit=limit)
    print(result)

    loop = asyncio.get_event_loop()
    # 获取所有需要下载的scihub直链
    tasks = [sh.async_get_direct_url(paper["url"]) for paper in result.get("papers", [])]
    all_direct_urls = loop.run_until_complete(asyncio.gather(*tasks))
    print(all_direct_urls)

    # 下载所有论文
    loop.run_until_complete(sh.async_download(loop, all_direct_urls, path=path))
    loop.close()

@gooey
def main():
    parser = gooeyparser(description="中文环境可用的scihub下载器 - @python实用宝典")
    parser.add_argument('path', help="下载路径", widget="dirchooser")
    parser.add_argument('keywords', help="关键词")
    parser.add_argument('limit', help="下载篇数")
    args = parser.parse_args()
    search(args.keywords, int(args.limit), args.path)

main()

当然你也完全可以使用自己的程序进行图形界面化。

3.支持的widget组件

所有支持的widget组件如下:

1.勾选框 widget="checkbox" 

2.下拉框 widget="dropdown"

3.互斥选择框 widget="radiogroup"

4.各种目标类型的选择框

文件选择框 widget="filechooser"
目录选择框 widget="dirchooser"
多文件选择框 widget="multifilechooser"
文件保存目录 widget="filesaver"

5.日期/时间选择器 widget="datechooser/timechooser"

6.密码输入框 wiget="passwordfield"

7.多选列表框 widget="listbox"

8.颜色选择器 widget="colourchooser"

9.可过滤的下拉框 widget="filterabledropdown"

10.滑片 widget="slider"

4.打包

在一切都测试完毕后使用正常后,你可以通过 pyinstaller 将这个可视化程序打包成exe可执行文件。

1.编写 pyinstaller buildspec

下载后你只需要改两行代码:

如下所示:

在路径前面带r,可以不用输入两个斜杆 '\' 哦。

2.执行打包命令

为了能够使用 pyinstaller, 我们需要使用pip安装这个模块:

pip install pyinstaller


打包完成后会在当前文件夹下生成一个dist文件夹,里面就包含了你打包生成的可执行文件,打包成功。


crossin的新书《码上行动:用chatgpt学会python编程》已经上市了。本书以chatgpt为辅助,系统全面地讲解了如何掌握python编程,适合python零基础入门的读者学习。