控制台程序 - Gooey——把 CLI 程序变成 GUI

优质
小牛编辑
127浏览
2023-12-01

Gooey 是一个 Python GUI 程序开发框架,基于 wxPython GUI 库,其使用方法类似于 Python
内置 CLI 开发库 argparse,因此很容易把一个基于 argparse 的 CLI 应用转换成 GUI 程序。

简单的示例

我们首先从一个简单的基于 argparse 库的 CLI 应用开始:

  1. from argparse import ArgumentParser
  2. def main():
  3. parser = ArgumentParser(description="My Cool GUI Program!")
  4. parser.add_argument('Filename')
  5. parser.add_argument('Date')
  6. parser.parse_args()
  7. if __name__ == '__main__':
  8. main()

这就有了一个接受 FilenameDate 的两个必填参数的 CLI 程序,为了简化程序我们并没有指定它的功能。

使用方法:python cli.py FILENAME DATE

现在我们把它改成

  1. from gooey import Gooey, GooeyParser
  2. @Gooey
  3. def main():
  4. parser = GooeyParser(description="My Cool GUI Program!")
  5. parser.add_argument('Filename')
  6. parser.add_argument('Date')
  7. parser.parse_args()
  8. if __name__ == '__main__':
  9. main()

于是我们得到了一个简单的 GUI 对话框,并且基本上没有修过多少代码:

当然,仅仅这样是不够的,我们的 Filename 参数需要对应一个文件,而 Date 参数是一个日期,如果有专用的控件就好了!
Gooey 当然也想到了:

仅仅修改了 2 行代码:

  1. parser.add_argument('Filename', widget="FileChooser")
  2. parser.add_argument('Date', widget="DateChooser")

控件

上面已经看到了两个简单的控件:FileChooserDateChooser,分别提供了一个“文件选择器”和
“日期选择器”。现在支持的 chooser 类控件有:

控件名控件类型
FileChooser文件选择器
MultiFileChooser文件多选器
DirChooser目录选择器
MultiDirChooser目录多选器
FileSaver文件保存
DateChooser日期选择
TextField文本输入框
Dropdown下拉列表
Counter计数器
CheckBox复选框
RadioGroup单选框

国际化

Gooey 的国际化是通过配置实现的,使用方法如下:

  1. @Gooey(language='russian')
  2. def main():
  3. ...

目前仅支持 russianenglishdutchfrenchportuguese 的支持已在计划中。

配置

language 参数配置一样,Gooey 还支持很多其它配置,下面是它支持的参数列表:

参数简介
advanced切换显示全部设置还是仅仅是简化版本
show_configSkips the configuration all together and runs the program immediately
language指定从 gooey/languages 目录读取哪个语言包
program_nameGUI 窗口显示的程序名。默认会显 sys.argv[0]
program_descriptionSettings 窗口顶栏显示的描述性文字。默认值从 ArgumentParser 中获取。
default_size窗口默认大小。
required_cols设置必选参数行数。
optional_cols设置可选参数行数。
dump_build_config将设置以 JSON 格式保存在硬盘中以供编辑/重用。

布局流

布局实例可以在下载这个 exmaple 库体验。

Flat LayoutColumn Layout
Gooey——把 CLI 程序变成 GUI - 图3Gooey——把 CLI 程序变成 GUI - 图4