Importante

Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!

2
respostas

[Sugestão] Bibliotecas e versões

Boa tarde, pessoal.
Gostaria de fazer uma sugestão: apresentar um requirements.txt no módulo "Preparando o ambiente" ou no "Configurando as ferramentas disponíveis". Dessa forma, ficam declaradas quais bibliotecas foram usadas, bem como suas versões, para rodar o código da aula.
Motivo: alteração de versões e mudanças de bibliotecas ao longo do tempo. Fazendo o pip do requirements.txt antes da aula, já poderemos verificar se todas foram instaladas corretamente e assim continuar com o curso.

Agradeço pela alta qualidade das aulas e pela disposição dos professores.

2 respostas

Oi, Rodrigo! Tudo bem? Espero que sim!

Sua sugestão faz bastante sentido para tornar a preparação do ambiente mais previsível, obrigada por compartilhar.

O uso de um requirements.txt é uma boa prática em projetos Python porque permite declarar as dependências e suas respectivas versões. Isso ajuda a reduzir problemas causados por atualizações de bibliotecas, principalmente em cursos que utilizam ferramentas como LangChain, que passam por mudanças frequentes em APIs e integrações.

Um arquivo poderia ser estruturado assim:


langchain==1.0.0
langchain-community==1.0.0
python-dotenv==1.0.1

Esse arquivo registra as versões das bibliotecas utilizadas no projeto. Depois, o ambiente pode ser preparado com:


pip install -r requirements.txt

Esse comando instala as dependências declaradas no arquivo, permitindo reproduzir um ambiente mais próximo daquele utilizado durante a elaboração das aulas.

Também é possível utilizar versões com limites, como >= e <, quando existe interesse em receber atualizações sem permitir mudanças incompatíveis.

E não podemos esquecer de documentar as versões utilizadas ajuda a identificar rapidamente quando uma mudança na biblioteca exige algum ajuste no código apresentado nas aulas.

Obs: como as versões reais das bibliotecas do curso precisam corresponder ao ambiente utilizado na gravação ou à versão atualmente suportada, os números acima são apenas ilustrativos.

Quais outras informações você considera importantes para deixar a preparação do ambiente mais previsível para quem está acompanhando o curso? Conte sempre conosco por aqui, prezamos sempre pelas melhorias no curso para que vocês tenham a melhor experiência possível!

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!

Oi, Rodrigo! Tudo bem? Espero que sim!

Sua sugestão faz bastante sentido para tornar a preparação do ambiente mais previsível, obrigada por compartilhar.

O uso de um requirements.txt é uma boa prática em projetos Python porque permite declarar as dependências e suas respectivas versões. Isso ajuda a reduzir problemas causados por atualizações de bibliotecas, principalmente em cursos que utilizam ferramentas como LangChain, que passam por mudanças frequentes em APIs e integrações.

Um arquivo poderia ser estruturado assim:


langchain==1.0.0
langchain-community==1.0.0
python-dotenv==1.0.1

Esse arquivo registra as versões das bibliotecas utilizadas no projeto. Depois, o ambiente pode ser preparado com:


pip install -r requirements.txt

Esse comando instala as dependências declaradas no arquivo, permitindo reproduzir um ambiente mais próximo daquele utilizado durante a elaboração das aulas.

Também é possível utilizar versões com limites, como >= e <, quando existe interesse em receber atualizações sem permitir mudanças incompatíveis.

E não podemos esquecer de documentar as versões utilizadas ajuda a identificar rapidamente quando uma mudança na biblioteca exige algum ajuste no código apresentado nas aulas.

Obs: como as versões reais das bibliotecas do curso precisam corresponder ao ambiente utilizado na gravação ou à versão atualmente suportada, os números acima são apenas ilustrativos.

Quais outras informações você considera importantes para deixar a preparação do ambiente mais previsível para quem está acompanhando o curso? Conte sempre conosco por aqui, prezamos sempre pelas melhorias no curso para que vocês tenham a melhor experiência possível!

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!