日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時(shí)間：8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
用什么庫寫Python命令行程序？看這一篇就夠了

 一、前言

在近半年的 Python 命令行旅程中，我們依次學(xué)習(xí)了 argparse、docopt、click 和 fire 庫的特點(diǎn)和用法，逐步了解到 Python 命令行庫的設(shè)計(jì)哲學(xué)與演變。本文作為本次旅程的終點(diǎn)，希望從一個(gè)更高的視角對這些庫進(jìn)行橫向?qū)Ρ?，總結(jié)它們的異同點(diǎn)和使用場景，以期在應(yīng)對不同場景時(shí)能夠分析利弊，選擇合適的庫為己所用。

創(chuàng)新互聯(lián)建站主要從事成都網(wǎng)站制作、成都做網(wǎng)站、網(wǎng)頁設(shè)計(jì)、企業(yè)做網(wǎng)站、公司建網(wǎng)站等業(yè)務(wù)。立足成都服務(wù)大祥,十年網(wǎng)站建設(shè)經(jīng)驗(yàn),價(jià)格優(yōu)惠、服務(wù)專業(yè),歡迎來電咨詢建站服務(wù):18980820575

本系列文章默認(rèn)使用 Python 3 作為解釋器進(jìn)行講解。若你仍在使用 Python 2，請注意兩者之間語法和庫的使用差異哦~

二、設(shè)計(jì)理念

在討論各個(gè)庫的設(shè)計(jì)理念之前，我們先設(shè)計(jì)一個(gè)計(jì)算器程序，其實(shí)這個(gè)例子在 argparse 庫的第一篇講解中出現(xiàn)過，也就是：

  • 命令行程序接受一個(gè)位置參數(shù)，它能出現(xiàn)多次，且是數(shù)字
  • 默認(rèn)情況下，命令行程序會(huì)求出給定的一串?dāng)?shù)字的最大值
  • 如果指定了選項(xiàng)參數(shù) --sum，那么就會(huì)將求出給定的一串?dāng)?shù)字的和

希望從各個(gè)庫實(shí)現(xiàn)該例子的代碼中能進(jìn)一步體會(huì)它們的設(shè)計(jì)理念。

2.1、argparse

argparse 的設(shè)計(jì)理念就是提供給你最細(xì)粒度的控制，你需要詳細(xì)地告訴它參數(shù)是選項(xiàng)參數(shù)還是位置參數(shù)、參數(shù)值的類型是什么、該參數(shù)的處理動(dòng)作是怎樣的?？傊?，它就像是一個(gè)沒有智能分析能力的初代機(jī)器人，你需要告訴它明確的信息，它才會(huì)根據(jù)給定的信息去幫助你做事情。

以下示例為 argparse 實(shí)現(xiàn)的 計(jì)算器程序：

 
 
 
 
    
  
  
  
  
  1. import argparse
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. # 1. 設(shè)置解析器
    4. 
  
  
  
  
  4. parser = argparse.ArgumentParser(description='Calculator Program.')
    5. 
  
  
  
  
  5. 
  
  
  
  
  6. # 2. 定義參數(shù)
    7. 
  
  
  
  
  7. # 添加位置參數(shù) nums，在幫助信息中顯示為 num
    8. 
  
  
  
  
  8. # 其類型為 int，且支持輸入多個(gè)，且至少需要提供一個(gè)
    9. 
  
  
  
  
  9. parser.add_argument('nums',  metavar='num', type=int, nargs='+',
    10. 
  
  
  
  
  10.                     help='a num for the accumulator')
    11. 
  
  
  
  
  11. # 添加選項(xiàng)參數(shù) --sum，該參數(shù)被 parser 解析后所對應(yīng)的屬性名為 accumulate
    12. 
  
  
  
  
  12. # 若不提供 --sum，默認(rèn)值為 max 函數(shù)，否則為 sum 函數(shù)
    13. 
  
  
  
  
  13. parser.add_argument('--sum', dest='accumulate', action='store_const',
    14. 
  
  
  
  
  14.                     const=sum, default=max,
    15. 
  
  
  
  
  15.                     help='sum the nums (default: find the max)')
    16. 
  
  
  
  
  16. 
  
  
  
  
  17. 
  
  
  
  
  18. # 3. 解析參數(shù)
    19. 
  
  
  
  
  19. args = parser.parse_args(['--sum', '1', '2', '3'])
    20. 
  
  
  
  
  20. print(args) # 結(jié)果：Namespace(accumulate=, nums=[1, 2, 3])
    21. 
  
  
  
  
  21. 
  
  
  
  
  22. # 4. 業(yè)務(wù)邏輯
    23. 
  
  
  
  
  23. result = args.accumulate(args.nums)
    24. 
  
  
  
  
  24. print(result)  # 基于上文的 ['--sum', '1', '2', '3'] 參數(shù)，accumulate 為 sum 函數(shù)，其結(jié)果為 6
    25.

從上述示例可以看到，我們需要通過 add_argument 很明確地告訴 argparse 參數(shù)長什么樣：

  • 它是位置參數(shù) nums，還是選項(xiàng)參數(shù) --sum
  • 它的類型是什么，比如 type=int 表示類型是 int
  • 這個(gè)參數(shù)能重復(fù)出現(xiàn)幾次，比如 nargs='+' 表示至少提供 1 個(gè)
  • 參數(shù)的是存什么的，比如 action='store_const' 表示存常量

然后它才根據(jù)給定的這些元信息來解析命令行參數(shù)(也就是示例中的 ['--sum', '1', '2', '3'])。

這是很計(jì)算機(jī)的思維，雖然冗長，但也帶來了靈活性。

2.2、docopt

從 argparse 的理念可以看出，它是命令式的。這時(shí)候 docopt 另辟蹊徑，聲明式是不是也可以?一個(gè)命令行程序的幫助信息其實(shí)已然包含了這個(gè)命令行的完整元信息，那不就可以通過定義幫助信息來定義命令行?docopt 就是基于這樣的想法去設(shè)計(jì)的。

聲明式的好處在于只要你掌握了聲明式的語法，那么定義命令行的元信息就會(huì)很簡單。

以下示例為 docopt 實(shí)現(xiàn)的 計(jì)算器程序：

 
 
 
 
    
  
  
  
  
  1. # 1. 定義接口描述/幫助信息
    2. 
  
  
  
  
  2. """Calculator Program.
    3. 
  
  
  
  
  3. 
  
  
  
  
  4. Usage:
    5. 
  
  
  
  
  5.   calculator.py [--sum] ...
    6. 
  
  
  
  
  6.   calculator.py (-h | --help)
    7. 
  
  
  
  
  7. 
  
  
  
  
  8. Options:
    9. 
  
  
  
  
  9.   -h --help     Show help.
    10. 
  
  
  
  
  10.   --sum         Sum the nums (default: find the max).
    11. 
  
  
  
  
  11. """
    12. 
  
  
  
  
  12. 
  
  
  
  
  13. from docopt import docopt
    14. 
  
  
  
  
  14. 
  
  
  
  
  15. # 2. 解析命令行
    16. 
  
  
  
  
  16. arguments = docopt(__doc__, options_first=True, argv=['--sum', '1', '2', '3'])
    17. 
  
  
  
  
  17. print(arguments) # 結(jié)果：{'--help': False, '--sum': True, '': ['1', '2', '3']}
    18. 
  
  
  
  
  18. 
  
  
  
  
  19. # 3. 業(yè)務(wù)邏輯
    20. 
  
  
  
  
  20. nums = (int(num) for num in arguments[''])
    21. 
  
  
  
  
  21. 
  
  
  
  
  22. if arguments['--sum']:
    23. 
  
  
  
  
  23.     result = sum(nums)
    24. 
  
  
  
  
  24. else:
    25. 
  
  
  
  
  25.     result = max(nums)
    26. 
  
  
  
  
  26. 
  
  
  
  
  27. print(result) # 基于上文的 ['--sum', '1', '2', '3'] 參數(shù)，處理函數(shù)為 sum 函數(shù)，其結(jié)果為 6
    28.

從上述示例可以看到，我們通過 __doc__ 定義了接口描述，這和 argparse 中 add_argument是等價(jià)的，然后 docopt 便會(huì)根據(jù)這個(gè)元信息把命令行參數(shù)轉(zhuǎn)換為一個(gè)字典。業(yè)務(wù)邏輯中就需要對這個(gè)字典進(jìn)行處理。

對比與 argparse：

  • 對于更為復(fù)雜的命令程序，元信息的定義上 docopt 會(huì)更加簡單
  • 然而在業(yè)務(wù)邏輯的處理上，由于 argparse 在一些簡單參數(shù)的處理上會(huì)更加便捷(比如示例中的情形)，相對來說 docopt 轉(zhuǎn)換為字典后就把所有處理交給業(yè)務(wù)邏輯的方式會(huì)更加復(fù)雜

2.3、click

命令行程序本質(zhì)上是定義參數(shù)和處理參數(shù)，而處理參數(shù)的邏輯一定是與所定義的參數(shù)有關(guān)聯(lián)的。那可不可以用函數(shù)和裝飾器來實(shí)現(xiàn)處理參數(shù)邏輯與定義參數(shù)的關(guān)聯(lián)呢?而 click 正好就是以這種使用方式來設(shè)計(jì)的。

click 使用裝飾器的好處就在于用裝飾器優(yōu)雅的語法將參數(shù)定義和處理邏輯整合在一起，從而暗示了路由關(guān)系。相比于 argparse 和 docopt 需要自行對解析后的參數(shù)來做路由關(guān)系，簡單了不少。

以下示例為 click 實(shí)現(xiàn)的 計(jì)算器程序：

 
 
 
 
    
  
  
  
  
  1. import sys
    2. 
  
  
  
  
  2. import click
    3. 
  
  
  
  
  3. 
  
  
  
  
  4. sys.argv = ['calculator.py', '--sum', '1', '2', '3']
    5. 
  
  
  
  
  5. 
  
  
  
  
  6. # 2. 定義參數(shù)
    7. 
  
  
  
  
  7. @click.command()
    8. 
  
  
  
  
  8. @click.argument('nums', nargs=-1, type=int)
    9. 
  
  
  
  
  9. @click.option('--sum', 'use_sum', is_flag=True, help='sum the nums (default: find the max)')
    10. 
  
  
  
  
  10. # 1. 業(yè)務(wù)邏輯
    11. 
  
  
  
  
  11. def calculator(nums, use_sum):
    12. 
  
  
  
  
  12.     """Calculator Program."""
    13. 
  
  
  
  
  13.     print(nums, use_sum) # 輸出：(1, 2, 3) True
    14. 
  
  
  
  
  14.     if use_sum:
    15. 
  
  
  
  
  15.         result = sum(nums)
    16. 
  
  
  
  
  16.     else:
    17. 
  
  
  
  
  17.         result = max(nums)
    18. 
  
  
  
  
  18. 
  
  
  
  
  19.     print(result) # 基于上文的 ['--sum', '1', '2', '3'] 參數(shù)，處理函數(shù)為 sum 函數(shù)，其結(jié)果為 6
    20. 
  
  
  
  
  20. 
  
  
  
  
  21. calculator()
    22.

從上述示例可以看出，參數(shù)和對應(yīng)的處理邏輯非常好地綁定在了一起，看上去就很直觀，使得我們可以明確了解參數(shù)會(huì)怎么處理，這在有大量參數(shù)時(shí)顯得尤為重要，這邊是 click 相比于 argparse 和 docopt 最明顯的優(yōu)勢。

此外，click 還內(nèi)置了很多實(shí)用工具和額外能力，比如說 Bash 補(bǔ)全、顏色、分頁支持、進(jìn)度條等諸多實(shí)用功能，可謂是如虎添翼。

2.4、firefire

則是用一種面向廣義對象的方式來玩轉(zhuǎn)命令行，這種對象可以是類、函數(shù)、字典、列表等，它更加靈活，也更加簡單。你都不需要定義參數(shù)類型，fire 會(huì)根據(jù)輸入和參數(shù)默認(rèn)值來自動(dòng)判斷，這無疑進(jìn)一步簡化了實(shí)現(xiàn)過程。

以下示例為 fire 實(shí)現(xiàn)的 計(jì)算器程序：

 
 
 
 
    
  
  
  
  
  1. import sys
    2. 
  
  
  
  
  2. import fire
    3. 
  
  
  
  
  3. 
  
  
  
  
  4. sys.argv = ['calculator.py', '1', '2', '3', '--sum']
    5. 
  
  
  
  
  5. 
  
  
  
  
  6. builtin_sum = sum
    7. 
  
  
  
  
  7. 
  
  
  
  
  8. # 1. 業(yè)務(wù)邏輯
    9. 
  
  
  
  
  9. # sum=False，暗示它是一個(gè)選項(xiàng)參數(shù) --sum，不提供的時(shí)候?yàn)?nbsp;False
    10. 
  
  
  
  
  10. # *nums 暗示它是一個(gè)能提供任意數(shù)量的位置參數(shù)
    11. 
  
  
  
  
  11. def calculator(sum=False, *nums):
    12. 
  
  
  
  
  12.     """Calculator Program."""
    13. 
  
  
  
  
  13.     print(sum, nums) # 輸出：True (1, 2, 3)
    14. 
  
  
  
  
  14.     if sum:
    15. 
  
  
  
  
  15.         result = builtin_sum(nums)
    16. 
  
  
  
  
  16.     else:
    17. 
  
  
  
  
  17.         result = max(nums)
    18. 
  
  
  
  
  18. 
  
  
  
  
  19.     print(result) # 基于上文的 ['1', '2', '3', '--sum'] 參數(shù)，處理函數(shù)為 sum 函數(shù)，其結(jié)果為 6
    20. 
  
  
  
  
  20. 
  
  
  
  
  21. 
  
  
  
  
  22. fire.Fire(calculator)
    23.

從上述示例可以看出，fire 提供的方式無疑是最簡單、并且最 Pythonic 的了。我們只需關(guān)注業(yè)務(wù)邏輯，而命令行參數(shù)的定義則和函數(shù)參數(shù)的定義融為了一體。

不過，有利自然也有弊，比如 nums 并沒有說是什么類型，也就意味著輸入字符串'abc'也是合法的，這就意味著一個(gè)嚴(yán)格的命令行程序必須在自己的業(yè)務(wù)邏輯中來對期望的類型進(jìn)行約束。

三、橫向?qū)Ρ?/h3>

最后，我們橫向?qū)Ρ认耡rgparse、docopt、click 和 fire 庫的各項(xiàng)功能和特點(diǎn)：

Python 的命令行庫種類繁多、各具特色。結(jié)合上面的總結(jié)，可以選擇出符合使用場景的庫，如果幾個(gè)庫都符合，那么就根據(jù)你更偏愛的風(fēng)格來選擇。這些庫都很優(yōu)秀，其背后的思想很是值得我們學(xué)習(xí)和擴(kuò)展。


文章名稱：用什么庫寫Python命令行程序？看這一篇就夠了
當(dāng)前路徑：http://m.5511xx.com/article/coheegg.html