寫 Python 的經(jīng)常要寫一些命令行工具，雖然標(biāo)準(zhǔn)庫(kù)提供有命令行解析工具 Argparse，但是寫起來非常麻煩，我很少會(huì)使用它。命令行工具中用起來最爽的就是 Click，它是 Flask 的團(tuán)隊(duì) pallets 的開源項(xiàng)目。Click 只要很少的代碼就可以優(yōu)雅地創(chuàng)造一個(gè)命令行工具，它致力于將創(chuàng)建命令行工具的過程變的快速而有趣。

安裝

pip install click

使用

創(chuàng)建 click_demo.py ，寫一個(gè)最簡(jiǎn)單的函數(shù)

import click

@click.command()
def hello():
   click.echo('Hello World!')

if __name__ == '__main__':
   hello()

運(yùn)行：

python click_demo.py
Hello World!

裝飾器 click.command() 使函數(shù)秒變命令行工具，echo 函數(shù)的作用等同于 print 函數(shù)。

參數(shù)

裝飾器 click.option()可以給命令行函數(shù)指定參數(shù)

import click

@click.command()
@click.option("--count", default=1, help="打印次數(shù)", type=int)
def hello(count):
    """
    這是一個(gè)簡(jiǎn)單示例
    """
    for i in range(count):
        click.echo('Hello World!')

if __name__ == '__main__':
    hello()
--count：count是參數(shù)的名字
default ： 參數(shù)的默認(rèn)值
type：給參數(shù)指定類型
help： 說明文檔

執(zhí)行腳本的時(shí)候后面加上參數(shù) --help 就可以查看說明文檔。

$ python click_demo.py --help

Usage: click_demo.py [OPTIONS]

  這是一個(gè)簡(jiǎn)單示例

Options:
  --count INTEGER  打印次數(shù)
  --help        Show this message and exit.

指定參數(shù)：

python click_demo.py --count 3

Hello World!
Hello World!
Hello World!

prompt

有些命令行工具在運(yùn)行的時(shí)候要求用戶輸入信息，可以給 option 裝飾器指定 prompt 參數(shù)

import click

@click.command()
@click.option("--count", default=1, help="打印次數(shù)", type=int)
@click.option("--name", prompt="請(qǐng)輸入名字", help="姓名")
def hello(count, name):
    """
    這是一個(gè)簡(jiǎn)單示例
    """
    for i in range(count):
        click.echo(f'Hello {name}!')

if __name__ == '__main__':
    hello()
$ python click_demo.py

請(qǐng)輸入名字: lzjun
Hello lzjun!

Group

Click 很重要的一個(gè)特性就是它的分組功能，當(dāng)一個(gè)命令行工具的邏輯已經(jīng)非常復(fù)雜的時(shí)候，為了解耦，我們需要將不同的邏輯放在不同的命令中，這樣既可以避免單個(gè)命令行工具函數(shù)臃腫。
來看個(gè)例子：

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

這是一個(gè)操作數(shù)據(jù)庫(kù)DB的命令行工具，提供了添加用戶和刪除用戶的命令行等其它操作，如果所有的業(yè)務(wù)邏輯全部寫在一個(gè)函數(shù)，維護(hù)變得異常困難。

@click.group 裝飾器把函數(shù)裝飾成為一個(gè)Group對(duì)象，通過 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 就是兩個(gè)子命令。