Gooey项目支持用一行代码将（几乎）任何Python 2或3控制台程序转换为GUI应用程序。

一、快速开始

开始之前，你要确保Python和pip已经成功安装在电脑上，如果没有，可以访问这篇文章：超详细Python安装指南 进行安装。

如果你用Python的目的是数据分析，可以直接安装Anaconda：Python数据分析与挖掘好帮手—Anaconda，它内置了Python和pip.

此外，推荐大家用VSCode编辑器，它有许多的优点：Python 编程的最好搭档—VSCode 详细指南。

请选择以下任一种方式输入命令安装依赖：

1. Windows 环境 打开 Cmd (开始-运行-CMD)。
2. MacOS 环境 打开 Terminal (command+空格输入Terminal)。
3. 如果你用的是 VSCode编辑器 或 Pycharm，可以直接使用界面下方的Terminal.

（方式一）安装Gooey的最简单方法是通过 PIP:

pip  Gooey

（方式二）或者，可以通过将项目克隆到本地目录来安装Gooey

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

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

python setup.py install

二、使用方法

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

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

gooey  Gooey, GooeyParser


 :
    parser = GooeyParser(description=)
    parser.add_argument(, help=, widget=)
    parser.add_argument(, help=)
    parser.add_argument(, help=)
    args = parser.parse_args()
    search(args.keywords, int(args.limit), args.path)

GooeyParser 和 ArgumentParser 一样，使用 add_argument 就可以增加输入参数，不同的是 GooeyParser 提供了可视化的选项：

parser.add_argument(, help=, widget=)

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

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

parser.add_argument(, help=)
parser.add_argument(, 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

 :
    """
    搜索相关论文并下载

    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
 :
    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()

这份代码想要完美地运行起来请结合 你不得不知道的python超级文献批量搜索下载工具 的 scihub.py.

你也完全可以使用自己的程序进行图形界面化，这无关紧要。

效果如下：

三、支持的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"

四、打包

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

1.编写 PyInstaller buildspec

PyInstaller使用 buildspec 来确定如何捆绑项目。你可以在Python实用宝典后台回复 buildspec下载 build.spec.txt.

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

如下所示：

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

2.执行打包命令

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

pip install pyinstaller

然后进入 build.spec.text 所在文件夹，执行以下命令打包程序：

pyinstaller build.spec.txt

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