Recriar ambientes a partir de requirements.txt

O inventário de um ambiente inclui os pacotes instalados nele, mesmo que o programa não os utilize. Por isso, usaremos uma .venv exclusiva para este projeto. Um ambiente compartilhado com outros projetos poderia adicionar pacotes desnecessários à reprodução.

A prática será feita no seu computador, com editor, terminal, Python e acesso ao índice de pacotes para instalar o Rich.

Crie uma pasta nova para evitar o reaproveitamento de uma .venv antiga. Use a opção correspondente ao seu sistema e instale o Rich a partir da fonte que você já conferiu.

Execute somente o bloco correspondente ao seu sistema.

Na pasta recriar-ambiente, crie o arquivo app.py com este conteúdo:

Execute o programa com o interpretador da .venv. O Rich apenas formata a mensagem; o programa não acessa a rede durante essa execução. Guarde o resultado observado como referência para a comparação com o ambiente que será recriado depois.

Use somente o comando correspondente ao seu sistema.

O requirements.txt é um arquivo de texto com requisitos que o pip pode consumir. Ele não contém o código do projeto, não copia o ambiente virtual e não guarda os próprios pacotes.

Cada linha descreve algo que deve estar disponível. Por isso, o arquivo pode citar tanto a distribuição escolhida para o projeto quanto distribuições usadas por ela.

Em rich==13.9.4, rich identifica a distribuição e 13.9.4 é a versão específica exigida. O operador == faz essa fixação.

As outras linhas podem representar dependências transitivas. Mesmo sem serem importadas em app.py, elas podem ser necessárias para que Rich funcione.

A linha, isoladamente, não informa se a dependência é direta ou transitiva. Nem a posição no arquivo resolve isso: a classificação depende do contexto do projeto e dos metadados das distribuições.

O comando python -m pip freeze lista os pacotes instalados no ambiente associado àquele interpretador. O resultado inclui tanto o pacote escolhido para o projeto quanto suas dependências transitivas.

Ele não analisa os imports de app.py: apenas inventaria o que está instalado. Por isso, a origem deve continuar sendo o ambiente dedicado preparado anteriormente. Algumas ferramentas de empacotamento podem ser omitidas por padrão; não interprete essa ausência como uma análise do código.

No terminal, entre na pasta do projeto e execute o comando correspondente ao seu sistema. Os caminhos abaixo selecionam diretamente o Python de .venv, sem depender de qual ambiente está ativado.

O símbolo > é um redirecionamento do terminal: ele salva a saída de pip freeze em requirements.txt. Não é o programa Python que escreve esse arquivo.

Execute na pasta que contém app.py e .venv:

Execute na pasta que contém app.py e .venv:

Abra requirements.txt no editor e confirme que ele está na pasta do projeto, ao lado de app.py, e não dentro de .venv.

Procure linhas no formato nome==versão. É esperado encontrar mais pacotes do que o programa importa diretamente, pois o inventário também registra dependências transitivas. As versões do seu arquivo podem ser diferentes das versões ilustrativas abaixo.

Não substitua o seu arquivo por este exemplo; revise os valores realmente capturados no seu ambiente.

Mantenha o código do projeto e o requirements.txt na pasta do projeto. Em seguida, crie um ambiente separado chamado .venv-recriado.

Não copie nem modifique a pasta .venv original. Ela continua sendo a origem para comparação. O novo ambiente será preenchido pelo pip a partir dos requisitos registrados.

O arquivo requirements.txt orienta a instalação no ambiente novo. Ele não transforma a pasta .venv original em um modelo copiável.

Os comandos abaixo usam o interpretador da .venv para criar o destino com a mesma instalação do Python usada na origem. Depois, chamam diretamente o interpretador de .venv-recriado, sem depender de qual ambiente está ativado.

Se suas pastas tiverem outros nomes, ajuste somente os caminhos correspondentes.

Em python -m pip install -r requirements.txt, a opção -r manda o pip ler os requisitos desse arquivo e instalar os pacotes no ambiente associado ao python chamado.

Use um destino novo. Esse comando instala ou ajusta requisitos, mas não remove automaticamente todos os pacotes extras que já existam em um ambiente antigo.

A conferência do ambiente recriado reúne três evidências:

1. Versões instaladas: os pacotes do destino correspondem às versões fixadas em requirements.txt.
2. Consistência declarada: os pacotes instalados encontram as dependências e versões exigidas por seus metadados.
3. Funcionamento observado: app.py produz no destino o mesmo resultado de referência observado na origem.

Essas evidências se complementam. Uma instalação concluída não garante, sozinha, que os metadados estejam consistentes nem que o programa funcione.

Na pasta do projeto, use diretamente o interpretador de .venv-recriado. Compare a coluna de versões com as linhas nome==versão de requirements.txt. As versões do seu arquivo podem ser diferentes das mostradas em exemplos.

Execute o comando correspondente ao seu sistema operacional.

pip check consulta os metadados dos pacotes instalados no destino. Ele informa dependências ausentes ou versões incompatíveis com as exigências declaradas por esses pacotes.

Ele não compara automaticamente o ambiente com requirements.txt e não executa app.py.

Use novamente o interpretador inequívoco do ambiente recriado.

Execute o programa com o interpretador do destino e compare a mensagem formatada com a referência obtida no ambiente de origem. As cores ainda podem variar entre terminais.

O requirements.txt registra requisitos de pacotes, mas não informa a versão do interpretador Python, o sistema operacional nem a arquitetura da máquina. Esses fatores podem explicar por que a mesma lista instala ou funciona de maneira diferente em outro computador.

Na pasta do projeto, execute somente os comandos correspondentes ao seu sistema. -VV mostra informações completas da versão e da construção do Python. O módulo platform, da biblioteca padrão, informa o sistema, sua versão ou release e a arquitetura reconhecida pela plataforma.

Comandos para consultar o ambiente de origem .venv:

Comandos para consultar o ambiente de origem .venv:

No editor, crie manualmente um arquivo textual como contexto-origem.txt, na pasta do projeto e fora de .venv. Preencha o modelo com as saídas obtidas. Essa nota ajuda a investigar diferenças futuras, mas não garante que outro ambiente será equivalente.

O pip freeze registra o estado observado no ambiente: distribuições instaladas e suas versões. Isso ajuda a solicitar novamente versões específicas, mas sua saída não é um lockfile completo.

Uma linha como rich==13.9.4 não registra a versão do Python, a plataforma, o artefato exato usado na instalação, dependências externas ao Python nem uma verificação de integridade. Por isso, repetir todas as linhas não garante ambientes equivalentes em qualquer máquina.

A recriação é sustentada por um conjunto de evidências: o inventário revisado da origem, a instalação em um ambiente novo, a consistência indicada pelo pip check, a execução manual do programa e o contexto da máquina. Nenhuma dessas evidências, isoladamente, garante equivalência universal.

Use o mesmo projeto e os dois ambientes já preparados. Não instale novos pacotes nem crie um terceiro ambiente.

O fluxo parte de uma origem dedicada, registra os requisitos, instala-os em um destino novo e reúne verificações diferentes antes da conclusão. O código, o requirements.txt e a nota de contexto permanecem fora das pastas descartáveis dos ambientes virtuais.