您好,登錄后才能下訂單哦!
前言
寫 Python 的經常要寫一些命令行工具,雖然標準庫提供有命令行解析工具 Argparse,但是寫起來非常麻煩,我很少會使用它。命令行工具中用起來最爽的就是 Click,它是 Flask 的團隊 pallets 的開源項目。Click 只要很少的代碼就可以優雅地創造一個命令行工具,它致力于將創建命令行工具的過程變的快速而有趣。
百聞不如一試
安裝
pip install Click
使用
創建 click_demo.py ,寫一個最簡單的函數
import click @click.command() def hello(): click.echo('Hello World!') if __name__ == '__main__': hello()
運行:
python click_demo.py Hello World!
裝飾器 click.command() 使函數秒變命令行工具,echo 函數的作用等同于 print 函數。
參數
裝飾器 click.option()可以給命令行函數指定參數
import click @click.command() @click.option("--count", default=1, help="打印次數", type=int) def hello(count): """ 這是一個簡單示例 """ for i in range(count): click.echo('Hello World!') if __name__ == '__main__': hello()
執行腳本的時候后面加上參數 --help 就可以查看說明文檔。
$ python click_demo.py --help Usage: click_demo.py [OPTIONS] 這是一個簡單示例 Options: --count INTEGER 打印次數 --help Show this message and exit.
指定參數:
>python click_demo.py --count 3 Hello World! Hello World! Hello World!
prompt
有些命令行工具在運行的時候要求用戶輸入信息,可以給 option 裝飾器指定 prompt 參數
import click @click.command() @click.option("--count", default=1, help="打印次數", type=int) @click.option("--name", prompt="請輸入名字", help="姓名") def hello(count, name): """ 這是一個簡單示例 """ for i in range(count): click.echo(f'Hello {name}!') if __name__ == '__main__': hello()
$ python click_demo.py 請輸入名字: lzjun Hello lzjun!
Group
Click 很重要的一個特性就是它的分組功能,當一個命令行工具的邏輯已經非常復雜的時候,為了解耦,我們需要將不同的邏輯放在不同的命令中,這樣既可以避免單個命令行工具函數臃腫。來看個例子:
# db.py import click @click.group() def db(): pass @click.command() @click.option("--name", help="用戶名") def add(name): """ 添加用戶 :param name: :return: """ click.echo(f'add user {name}') @click.command() @click.option("--id", help="用戶名") def delete(id): """ 刪除用戶 :param id: :return: """ click.echo(f'delete user {id}') db.add_command(delete) db.add_command(add) if __name__ == '__main__': db()
這是一個操作數據庫DB的命令行工具,提供了添加用戶和刪除用戶的命令行等其它操作,如果所有的業務邏輯全部寫在一個函數,維護變得異常困難。
@click.group 裝飾器把函數裝飾成為一個Group對象,通過 Group 可以添加很多子命令。
python db.py --help Usage: db.py [OPTIONS] COMMAND [ARGS]... Options: --help Show this message and exit. Commands: add 添加用戶 :param name: :return: delete 刪除用戶 :param id: :return:
從幫助文檔中我們看到 add 和 delete 就是兩個子命令。 Flask 框架的 flask 命令也是一個 Group 命令。
$ flask Usage: flask [OPTIONS] COMMAND [ARGS]... A general utility script for Flask applications. Provides commands from Flask, extensions, and the application. Loads the application defined in the FLASK_APP environment variable, or from a wsgi.py file. Setting the FLASK_ENV environment variable to 'development' will enable debug mode. $ export FLASK_APP=hello.py $ export FLASK_ENV=development $ flask run Options: --version Show the flask version --help Show this message and exit. Commands: add_user 添加賬號 :param name: :param username: :param password:... init_invite_code 添加邀請碼 recommend_account 更新推薦賬號 routes Show the routes for the app. run Runs a development server. shell Runs a shell in the app context.
提供了幾個預定義的子命令和自定義的命令。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持億速云。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。