Tutorial zum Python-Task-Automatisierungstool Tox

• Befehlszeilengesteuertes CI-Frontend und Tool zur Automatisierung von Entwicklungsaufgaben
  
• Befehlszeilengesteuertes CI-Frontend und Entwicklungstool Die Projektadresse des Aufgabenautomatisierungstools
  

tox lautet: https://github.com/tox-dev/tox

Seine Kernfunktion besteht darin, die Erstellung isolierter Python-Umgebungen zu unterstützen, in denen verschiedene Versionen von Python-Interpretern und verschiedene abhängige Bibliotheken installiert werden können, um Entwicklern die Durchführung automatisierter Tests, Paketierung, kontinuierlicher Integration usw. zu erleichtern.

Einfach ausgedrückt ist tox ein Befehlszeilentool zum Verwalten virtueller Testumgebungen. Es gibt es schon seit vielen Jahren und es wird häufig von Entwicklern verwendet. Beispielsweise wird es auch von der berühmten Cloud-Computing-Plattform OpenStack als eines der grundlegendsten Testtools verwendet.

1. Was kann Tox bewirken?

Die Verwendungsmöglichkeiten der Segmentierung umfassen:

• Erstellen Sie eine Entwicklungsumgebung
• Führen Sie eine statische Codeanalyse durch und Testtool
  
• Automatisiertes Build-Paket
  
• Führen Sie Tests mit tox-erstellten Paketen durch
  
• Prüfen Ob das Paket reibungslos in verschiedenen Python-Versionen/Interpretern installiert werden kann
  
• Unified Continuous Integration (CI) und befehlszeilenbasiertes Testen
  
#🎜🎜 # Erstellen und Projektdokumentation bereitstellen
• 
  
Pakete auf PyPI oder einer anderen Plattform veröffentlichen
• 
  

tox, wie in der offiziellen Dokumentation aufgeführt. Es gibt noch mehr Über 40 Beispiele für Nutzungsszenarien. Die detaillierte Liste finden Sie unter: https://tox.readthedocs.io/en/latest/examples.html

#🎜 🎜#2. Wie konfiguriere ich Tox?

Über seine Verwendung: Verwenden Sie pip install tox zum Installieren, verwenden Sie tox zum Ausführen aller Testumgebungen und tox -e envname zum Ausführen der angegebenen Umgebung. Es gibt auch viele Befehlszeilenparameter, die über tox -h angezeigt werden können.

tox's Verhalten wird durch seine Konfigurationsdatei gesteuert. Derzeit unterstützt es 3 Konfigurationsdateien:

pyproject.toml#🎜 🎜 #

tox.ini
2. setup.cfg
   
3. 
   Konfigurieren Sie den Inhalt mit der tox.ini des Tox-Projekts Sie können beispielsweise sehen, dass es wie folgt konfiguriert ist (https://github.com/tox-dev/tox/blob/master/tox.ini):

#🎜 🎜 #

Jedes [xxx] und der Inhalt darunter bilden einen Abschnitt, und jeder Abschnitt wird durch eine Leerzeile getrennt.

[tox]Die folgenden globalen Konfigurationselemente definieren die Umgebung, in der tox betrieben wird. [xxx] Im Folgenden sind die Konfigurationselemente der virtuellen Umgebung xxx aufgeführt. [xxx:yyy] erbt die Konfiguration von xxx, und die eigenen Konfigurationselemente haben eine höhere Priorität.

Für jede virtuelle Umgebung stehen viele Konfigurationselemente zur Verfügung, z. B. häufig verwendete: Beschreibung (Beschreibungsinformationen), Basepython (Python-Interpreterversion), Deps (Umgebungsabhängigkeiten), Befehle (Befehlsanweisungen) und so weiter.

tox unterstützt auch die Variablenersetzung, die einige integrierte Basisvariablen (global oder für virtuelle Umgebungen) bereitstellt: {toxinidir}, {homedir}, {envname}, { envdir} und bald.

Zusätzlich zur grundlegenden Variablenersetzung werden auch diese erweiterten Verwendungen unterstützt:

Rufen Sie die Umgebungsvariablen des Betriebssystems ab : { env:KEY}, der Effekt entspricht os.environ['KEY']. Kann geändert werden in: {env:KEY:DEFAULTVALUE}, der Standardwert wird verwendet, wenn die Umgebungsvariable nicht abgerufen werden kann {env:KEY:{env:DEFAULT_OF_KEY}}, um den Werteffekt von if-else#🎜🎜 zu erreichen ##🎜 🎜#

Übergeben Sie Befehlszeilenparameter: {posargs:DEFAULTS} Wenn keine Befehlszeilenparameter vorhanden sind, wird der DEFAULTS-Wert verwendet. Verwendung: tox arg1 arg2, um zwei Parameter zu übergeben, oder tox -- --opt1 arg1, um „--opt1 arg1“ als Ganzes zu übergeben.

• 
  
Werte zwischen Kapiteln übergeben: {[sectionname]valuename}, der Inhalt verschiedener Kapitel kann übergeben und verwendet werden.

Interaktive Konsoleninjektion: {tty:ON_VALUE:OFF_VALUE}, wenn die interaktive Shell-Konsole eingeschaltet ist, verwenden Sie den ersten Wert, andernfalls den zweiten. Dies ist ein Beispiel, wenn Pytest „--pdb“ verwendet.

• 
  Die geschweiften Klammern „{}“ können nicht nur zur Variablenersetzung, sondern auch als Wert der „ODER-Beziehung“-Beurteilung verwendet werden. Schauen Sie sich das folgende Beispiel direkt an:

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

• {py27,py36}-django{15,16} hat 2 Werte in jedem der 2 Sätze geschweifter Klammern. Sie können tatsächlich kombiniert werden in 4 Umgebungen: py27-django15, py27-django16, py36-django15, py36-django16.
  

Informationen zu den Konfigurationselementen, Nutzungsbedingungen, Bedeutung, erweiterter Nutzung usw. von tox finden Sie in der offiziellen Dokumentation: https://tox.readthedocs.io/en/ Latest /config.html

3. Plug-in von tox

Zusätzlich zu seiner starken Konfigurierbarkeit verfügt tox auch über eine starke Konfigurierbarkeit ist steckbar und um ihn herum wurde ein äußerst umfangreiches Plug-in-Ökosystem geschaffen.

Mit pip search tox können Sie eine große Anzahl von Bibliotheken sehen, die mit „tox-“ beginnen, bei denen es sich allesamt um Plug-in-Pakete von tox handelt. Darunter sind bekannte Namen wie Setuptools, Pipenv, Conda, Travis, Pytest und Docker.

tox hat viele API-Schnittstellen geöffnet, um anderen die Anpassung und Entwicklung von Plug-Ins zu erleichtern.

4. Der Arbeitsablauf von Tox

Schauen wir uns an, wie Tox funktioniert:

Die Hauptlinks in seinem Workflow sind:

#🎜🎜 # Konfiguration ( aus der Konfiguration): Laden Sie Konfigurationsdateien (z. B. tox.ini), analysieren Sie Befehlszeilenparameter, lesen Sie Systemumgebungsvariablen usw.
• Verpackung: Optional, für das Setup eines Py-Dateiprojekts können Sie dessen generieren Quellverteilungsversion in diesem Schritt
• 
  
Erstellen Sie eine virtuelle Umgebung: Verwenden Sie standardmäßig virtualenv, um eine virtuelle Umgebung zu erstellen und diese gemäß „deps“ im Konfigurationselement „Erforderliche Abhängigkeiten“ zu installieren und dann auszuführen die konfigurierten Befehle (Befehle)
• 
  
Bericht: Fassen Sie die laufenden Ergebnisse aller virtuellen Umgebungen zusammen und listen Sie sie auf
• 
  

5

tox selbst ist als Testtool positioniert, das versucht, Python-Tests zu automatisieren, zu standardisieren und zu verarbeiten. Aber im Gegensatz zu Test-Frameworks wie Unittest und Pytest funktioniert es über die Codeebene hinaus und ist ein Tool auf Projektebene. Daher muss es mit diesen Test-Frameworks kombiniert werden oder mehrere automatisierte Aufgaben gleichzeitig ausführen (z. B. Pep8 ausführen, Codeabdeckung testen, Dokumentation erstellen usw.), damit es seinen Wert besser entfalten kann.

Eine seiner Hauptfunktionen ist die Erstellung/Verwaltung virtueller Umgebungen, aber dies ist nur ein Mittel zur Erleichterung des Testens, verglichen mit anderen Tools, die virtuelle Umgebungen verwalten können, wie z. B. Virtualenvwrapper , Conda, Pipenv, Poesie, es weist in einigen Aspekten Mängel auf.

tox verfügt außerdem über eine starke Konfigurierbarkeit und umfangreiche Plug-in-Unterstützung, was ihm große Möglichkeiten und Freiheit in der Anwendung bietet. Daher verwenden es immer noch viele treue Entwickler. Der Autor der Artikelserie, die ich gerade übersetzt habe, ist beispielsweise einer seiner Betreuer.

Schließlich muss ich hinzufügen, dass tox Konfigurationsdateien als Treiber verwendet, aber die Konfigurationsdateien sind immer noch ziemlich umständlich, also hat jemand etwas entwickelt Ein Nox verwendet, ähnlich wie tox, Python-Dateien zur Konfiguration. Dieses Projekt erfreut sich ebenfalls großer Beliebtheit und zieht viele Projekte an, die unter seinem Dach investieren, wie z. B. pipx, urllib3, Salt usw. Wenn Sie an diesem Projekt interessiert sind, schauen Sie sich bitte an: https://nox.thea.codes/en/stable.

Das obige ist der detaillierte Inhalt vonTutorial zum Python-Task-Automatisierungstool Tox. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!