Lidando com dependências

Desenvolvendo pacotes Python

James Fulton

Climate informatics researcher

O que são dependências?

Outros pacotes que você importa dentro do seu pacote
Dentro de mymodule.py:

# Esses pacotes importados são dependências
import numpy as np
import pandas as pd
...

Adicionando dependências ao setup.py

from setuptools import setup, find_packages

setup(
    ...
    install_requires=['pandas', 'scipy', 'matplotlib'],
)

Controlando a versão das dependências

from setuptools import setup, find_packages

setup(
    ...
    install_requires=[

        'pandas>=1.0',

        'scipy==1.1',

        'matplotlib>=2.2.1,<3'

    ],
)

Controlando a versão das dependências

from setuptools import setup, find_packages

setup(
    ...
    install_requires=[

        'pandas>=1.0',         # bom
        'scipy==1.1',          # ruim
        'matplotlib>=2.2.1,<3' # bom
    ],
)

Permita o máximo de versões possível
Remova dependências não usadas

Versões do Python

from setuptools import setup, find_packages

setup(
    ...
    python_requires='>=2.7, !=3.0.*, !=3.1.*',
)

Escolhendo versões de dependências e do pacote

Verifique o histórico ou as notas de versão do pacote
- ex.: as notas de versão do NumPy
Teste versões diferentes

Uma amostra das notas de versão do NumPy.

Criando um ambiente para desenvolvedores

pip freeze

alabaster==0.7.12
appdirs==1.4.4
argh==0.26.2
...
wrapt==1.11.2
yapf==0.29.0
zipp==3.1.0

Criando um ambiente para desenvolvedores

Salvar os requisitos do pacote em um arquivo

pip freeze > requirements.txt

Instalar requisitos a partir do arquivo

pip install -r requirements.txt

mysklearn/
|-- mysklearn
|   |-- __init__.py
|   |-- preprocessing
|   |   |-- __init__.py
|   |   |-- normalize.py
|   |   |-- standardize.py
|   |-- regression
|   |   |-- __init__.py
|   |   |-- regression.py
|   |-- utils.py
|-- setup.py
|-- requirements.txt   <-- ambiente de desenvolvimento

Vamos praticar!

Desenvolvendo pacotes Python