Testování balíčku v různých prostředích

Developing Python Packages

James Fulton

Climate informatics researcher

Testování více verzí Pythonu

Tento setup.py povoluje libovolnou verzi Pythonu od verze 2.7 výše.

from setuptools import setup, find_packages

setup(
    ...
    python_requires='>=2.7',
)

Abyste tyto verze Pythonu otestovali, je nutné:

Nainstalovat všechny tyto verze Pythonu
Nainstalovat balíček a závislosti do každé z nich
Spustit pytest

Testování více verzí Pythonu

Tento setup.py povoluje libovolnou verzi Pythonu od verze 2.7 výše.

from setuptools import setup, find_packages

setup(
    ...
    python_requires='>=2.7',
)

Abyste tyto verze Pythonu otestovali, je nutné:

Nainstalovat všechny tyto verze Pythonu
Spustit tox

Co je tox?

Navržen pro spouštění testů s více verzemi Pythonu

Konfigurace tox

Konfigurační soubor - tox.ini

mysklearn/
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini   <--- configuration file

Konfigurace tox

Konfigurační soubor - tox.ini

[tox]

envlist = py27, py35, py36, py37


[testenv]

deps = pytest

commands =
    pytest

    echo "run more commands"
    ...

Nadpisy jsou ohraničeny hranatými závorkami [...].
Pro testování verze Pythonu X.Y přidejte pyXY do envlist.
Testované verze Pythonu musí být předem nainstalovány.
Parametr commands obsahuje příkazy terminálu, které tox spustí.
Seznam commands může obsahovat libovolné příkazy terminálu, jako ls, cd, echo atd.

Spuštění tox

tox

mysklearn/    <-- navigate to here
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini

Výstup tox

py27 create: /mypackages/mysklearn/.tox/py27
py27 installdeps: pytest
py27 inst: /mypackages/mysklearn/.tox/.tmp/package/1/mysklearn-0.1.0.zip
py27 installed: mysklearn==0.1.0,numpy==1.16.6,pandas==0.24.2,pytest==4.6.11,...
py27 run-test-pre: PYTHONHASHSEED='2837498672'
...

Výstup tox

py27 run-test: commands[0] | pytest
======================== test session starts ========================
platform linux2 -- Python 2.7.17, ...
rootdir: /home/workspace/mypackages/mysklearn
collected 6 items                         

tests/preprocessing/test_normalize.py ...                     [ 50%]
tests/preprocessing/test_standardize.py ...                   [100%]

========================= 6 passed in 0.23s =========================

Výstup tox

...
__________________________ summary __________________________
  py27: commands succeeded
  py35: commands succeeded
  py36: commands succeeded
  py37: commands succeeded

Výstup tox

...
__________________________ summary __________________________
  py27: commands succeeded
  py35: commands succeeded
  py36: commands succeeded
ERROR:   py37: commands failed

Pojďme procvičovat!

Developing Python Packages