Testowanie pakietu w różnych środowiskach

Tworzenie pakietów w Pythonie

James Fulton

Climate informatics researcher

Testowanie wielu wersji Pythona

Ten setup.py dopuszcza dowolną wersję Pythona od 2.7 wzwyż.

from setuptools import setup, find_packages

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

Aby przetestować te wersje Pythona, należy:

Zainstalować wszystkie te wersje Pythona
Zainstalować pakiet i zależności dla każdej wersji
Uruchomić pytest

Testowanie wielu wersji Pythona

Ten setup.py dopuszcza dowolną wersję Pythona od 2.7 wzwyż.

from setuptools import setup, find_packages

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

Aby przetestować te wersje Pythona, należy:

Zainstalować wszystkie te wersje Pythona
Uruchomić tox

Czym jest tox?

Przeznaczony do uruchamiania testów w wielu wersjach Pythona

Konfiguracja tox

Plik konfiguracyjny - tox.ini

mysklearn/
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini   <--- plik konfiguracyjny

Konfiguracja tox

Plik konfiguracyjny - tox.ini

[tox]

envlist = py27, py35, py36, py37


[testenv]

deps = pytest

commands =
    pytest

    echo "run more commands"
    ...

Nagłówki otoczone są nawiasami kwadratowymi [...].
Aby testować Pythona w wersji X.Y, dodaj pyXY do envlist.
Testowane wersje Pythona muszą być już zainstalowane.
Parametr commands zawiera polecenia terminala uruchamiane przez tox.
Lista commands może zawierać dowolne polecenia terminala, np. ls, cd, echo.

Uruchamianie tox

tox

mysklearn/    <-- przejdź tutaj
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini

Wynik działania 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'
...

Wynik działania 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 =========================

Wynik działania tox

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

Wynik działania tox

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

Czas na ćwiczenia!

Tworzenie pakietów w Pythonie