Python任務自動化工具tox怎么配置

這篇文章主要講解了“Python任務自動化工具tox怎么配置”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“Python任務自動化工具tox怎么配置”吧！

1、tox 能做什么？

細分的用途包括：

• 創(chuàng)建開發(fā)環(huán)境

• 運行靜態(tài)代碼分析與測試工具
  

• 自動化構建包
  

• 針對 tox 構建的軟件包運行測試
  

• 檢查軟件包是否能在不同的 Python 版本/解釋器中順利安裝
  

• 統(tǒng)一持續(xù)集成（CI）和基于命令行的測試
  

• 創(chuàng)建和部署項目文檔
  

• 將軟件包發(fā)布到 PyPI 或任何其它平臺
  

2、tox 怎么配置？

關于它的用法：使用pip install tox 安裝，使用tox 運行全部測試環(huán)境，和tox -e envname 運行指定的環(huán)境。還有不少的命令行參數(shù)，通過tox -h 查看。

tox 的行為由其配置文件控制，當前它支持 3 種配置文件：

1. pyproject.toml

2. tox.ini
   

3. setup.cfg
   

以 tox 項目自己的 tox.ini 配置內容為例，可以看到它是這樣配置的：

每個[xxx]及其下方內容組成一個章節(jié)（section），每個章節(jié)間使用空行作間隔。

[tox]下面是全局性的配置項，envlist 字段定義了 tox 去操作的環(huán)境。[xxx]下面是 xxx 虛擬環(huán)境的配置項，[xxx:yyy]繼承 xxx 的配置，同時其自身配置項的優(yōu)先級更高。

對于每個虛擬環(huán)境，可用的配置項很多，例如常用的有：description（描述信息）、basepython（Python解釋器版本）、deps（環(huán)境依賴項）、commands（命令語句）等等。

tox 還支持作變量替換，它提供了一些內置的基礎變量（全局的或對于虛擬環(huán)境的）：{toxinidir}、{homedir}、{envname}、{envdir}等等。

除了基礎性的變量替換，它還支持這些高級用法：

• 取操作系統(tǒng)的環(huán)境變量：{env:KEY}，效果等同于os.environ['KEY'] ?？梢宰兓桑簕env:KEY:DEFAULTVALUE}，在取不到環(huán)境變量時則使用默認值；{env:KEY:{env:DEFAULT_OF_KEY}}，達到 if-else 的取值效果
  

傳遞命令行參數(shù)：{posargs:DEFAULTS}，當沒有命令行參數(shù)時，使用 DEFAULTS 值。使用方式：tox arg1 arg2 傳兩個參，或者tox -- --opt1 arg1 將“-- opt1 arg1”作為整體傳入。

• 章節(jié)間傳值：{[sectionname]valuename}，不同章節(jié)的內容可以傳遞使用。
  

• 交互式控制臺注入：{tty:ON_VALUE:OFF_VALUE}，當交互式 shell 控制臺開啟時，使用第一個值，否則使用第二個。pytest 在使用“--pdb”時，是這樣的例子。
  

花括號“{}”除了可以做變量替換使用，它還可以作為“或關系”判斷的取值。直接看下面的例子：

[tox]
envlist = {py27,py36}-django{15,16}

{py27,py36}-django{15,16} 的 2 組花括號內各有 2 個值，它們實際可以組合成 4 個環(huán)境：py27-django15、py27-django16、py36-django15、py36-django16。

3、tox 的插件化

除了自身強大的可配置性，tox 還具有很強的可擴展性，它是可插拔的（pluggable），圍繞它產生了一個極為豐富的插件生態(tài)。

使用pip search tox ，可以看到數(shù)量眾多的“tox-”開頭的庫，它們都是 tox 的插件包。其中不乏 setuptools、pipenv、conda、travis、pytest、docker 等被大家熟知的名字。

tox 開放了挺多的 API 接口，方便其他人定制開發(fā)插件。

4、tox 的工作流程

接下來看看 tox 是怎么運作的：

其工作流程中主要的環(huán)節(jié)有：

• 配置（從figuration）：加載配置文件（如 tox.ini），解析命令行參數(shù)，讀取系統(tǒng)環(huán)境變量等

• 打包（packaging）：可選的，對于帶有 setup.py 文件的項目，可以在這步去生成它的源發(fā)行版
  

• 創(chuàng)建虛擬環(huán)境：默認使用 virtualenv 來創(chuàng)建虛擬環(huán)境，并根據(jù)配置項中的“deps”安裝所需的依賴項，然后執(zhí)行配置好的命令（commands）
  

• 報告（report）：匯總所有虛擬環(huán)境的運行結果并羅列出來
  

5、小結

tox 本身定位是一個測試工具，它試圖令 Pytho 測試工作變得自動化、標準化與流程化。但跟 unittest 和 pytest 這些測試框架不同，它作用的是代碼層面之外的事情，是一種項目級的工具。因此，它需要跟這些測試框架相結合，或者同時處理多種自動化任務（如跑 pep8、測代碼覆蓋率、生成文檔等等），這樣才能更好地發(fā)揮它的價值。

它的一大特色在于創(chuàng)建/管理虛擬環(huán)境，但這只是為了方便測試而使用的手段，因此相比其它可管理虛擬環(huán)境的工具，如 Virtualenvwrapper、conda、pipenv、poetry，它在某些方面就存在著不足。

tox 還有強大的可配置性與豐富的插件支持，這使得它在運用上具有很大的可能性與自由度。因此，不少忠實開發(fā)者仍在持續(xù)地在使用它，比如，我剛翻譯好的系列文章的作者就是它的維護者之一。

感謝各位的閱讀，以上就是“Python任務自動化工具tox怎么配置”的內容了，經過本文的學習后，相信大家對Python任務自動化工具tox怎么配置這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！