只需一行代碼,將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零基礎入門的讀者學習。