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文件夾,裏面就包含了你打包生成的可執行文件,打包成功。