Testando seu pacote em diferentes ambientes

Desenvolvendo pacotes Python

James Fulton

Climate informatics researcher

Testando várias versões do Python

Este setup.py permite qualquer versão do Python a partir da 2.7.

from setuptools import setup, find_packages

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

Para testar essas versões do Python, você deve:

Instalar todas essas versões do Python
Instalar seu pacote e todas as dependências em cada Python
Executar pytest

Testando várias versões do Python

Este setup.py permite qualquer versão do Python a partir da 2.7.

from setuptools import setup, find_packages

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

Para testar essas versões do Python, você deve:

Instalar todas essas versões do Python
Executar tox

O que é tox?

Feito para rodar testes com múltiplas versões do Python

Configurar o tox

Arquivo de configuração - tox.ini

mysklearn/
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini   <--- arquivo de configuração

Configurar o tox

Arquivo de configuração - tox.ini

[tox]

envlist = py27, py35, py36, py37


[testenv]

deps = pytest

commands =
    pytest

    echo "run more commands"
    ...

Títulos ficam entre colchetes [...].
Para testar a versão X.Y do Python, adicione pyXY a envlist.
As versões do Python a testar já precisam estar instaladas.
O parâmetro commands lista os comandos de terminal que o tox vai executar.
A lista commands pode ter quaisquer comandos de terminal, como ls, cd, echo etc.

Executando o tox

tox

mysklearn/    <-- navegue até aqui
|-- mysklearn
|   |-- ...
|-- tests
|   |-- ...
|-- setup.py
|-- LICENSE
|-- MANIFEST.in
|-- tox.ini

saída do 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'
...

saída do 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 =========================

saída do tox

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

saída do tox

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

Vamos praticar!

Desenvolvendo pacotes Python