Comportamento do pip em Ambientes Virtuais Conda

Ao utilizar o gerenciador de pacotes pip dentro de um ambiente virtual criado pelo Conda, a instalação será direcionada para o ambiente ativo, desde que algumas premissas sejam rigorosamente atendidas.

Ativação do Ambiente Virtual

Antes de executar qualquer comando de instalação, é fundamental garantir que o ambiente virtual desejado esteja ativo no terminal:

conda activate ambiente_projeto  # Ativa o ambiente virtual específico
pip install biblioteca_exemplo   # A instalação ocorre no ambiente ativo

Verificação do Executável pip

É crucial confirmar se o binário do pip sendo invocado pertence ao ambiente virtual e não ao sistema operacional ou ao ambiente base do Conda. Utilize os comandos abaixo para inspecionar o caminho:

# Sistemas baseados em Unix (Linux/macOS)
which pip

# Sistema Windows
where pip

O caminho de saída deve incluir o diretório do ambiente virtual (por exemplo, .../envs/ambiente_projeto/bin/pip). Caso aponte para um diretório do sistema, a instalação ocorrerá no local errado, comprometendo o isolamento.

Boas Práticas e Prevenção de Conflitos

• Prioridade do Conda: Sempre que possível, utilize conda install para gerenciar dependências, pois ele resolve conflitos de forma mais robusta. Recorra ao pip apenas para pacotes indisponíveis nos canais do Conda.
• Validação de Isolamento: Após a instalação, confirme a presença do pacote no ambiente atual:

conda list  # Exibe todos os pacotes (instalados via conda ou pip)
pip list    # Exibe estritamente os pacotes gerenciados pelo pip

Resolução de Problemas Comuns

Se um pacotee for acidentalmente instalado no ambiente global, remova-o com pip uninstall biblioteca_exemplo e repita o processo após ativar o ambiente correto. Caso o pip não esteja disponível no ambiente Conda, instale-o previamente executando conda install pip.

Automação de Instalações com o Parâmetro -r

O argumento -r (abreviação de --requirement) permite que o pip leia um arquivo de texto contendo uma lista de dependências e as instale em lote.

Estrutura do Arquivo de Dependências

Embora o nome requirements.txt seja o padrão da comunidade, você pode nomear o arquivo como preferir (ex: deps_projeto.txt). O formato aceita especificações de versão:

httpx==0.24.1
scipy>=1.9.0
matplotlib<3.7.0
fastapi

A omissão do operador de versão resulta na instalação da release mais recente disponível no índice de pacotes.

Cenários de Aplicação

Configuração Inicial de Projetos: Ao clonar um repositório, a recriação do ambiente é simplificada:

pip install -r deps_projeto.txt

Geração de Manifestos: Para exportar o estado atual do ambiente para um arquivo:

pip freeze > deps_congelados.txt

Segmentação de Ambientes: É comum manter arquivos separados para diferentes estágios, como deps_testes.txt para bibliotecas de teste e deps_producao.txt para a aplicação em si.

Considerações Importantes

1. Caminhos de Arquivo: Se o arquivo não estiver no diretório de trabalho atual, forneça o caminho absoluto ou relativo correto: pip install -r ../config/deps.txt.
2. Integração com Conda: As mesmas regras de ativação de ambiente se aplicam aqui. Execute o comando apenas com o ambiente Conda ativo para evitar poluir a instalação global do Python.
3. Ferramentas Avançadas: Para gerenciar dependências diretas e indiretas de forma mais limpa, considere o uso do pip-tools:

pip install pip-tools
pip-compile deps_base.in  # Compila um arquivo com versões exatas e subdependências