From ecf0adfb19e6402b0ff0dc6b030cfd259906e4bc Mon Sep 17 00:00:00 2001 From: Rafael de Oliveira Marques Date: Fri, 24 Oct 2025 11:17:17 -0300 Subject: [PATCH] validated llm translation --- docs/pt/docs/virtual-environments.md | 56 ++++++++++++++-------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/pt/docs/virtual-environments.md b/docs/pt/docs/virtual-environments.md index 5fc1a8866..2c9ed487c 100644 --- a/docs/pt/docs/virtual-environments.md +++ b/docs/pt/docs/virtual-environments.md @@ -1,4 +1,4 @@ -# Ambientes Virtuais +# Ambientes Virtuais { #virtual-environments } Ao trabalhar em projetos Python, você provavelmente deve usar um **ambiente virtual** (ou um mecanismo similar) para isolar os pacotes que você instala para cada projeto. @@ -26,7 +26,7 @@ Se você estiver pronto para adotar uma **ferramenta que gerencia tudo** para vo /// -## Criar um Projeto +## Criar um Projeto { #create-a-project } Primeiro, crie um diretório para seu projeto. @@ -51,7 +51,7 @@ $ cd awesome-project -## Crie um ambiente virtual +## Crie um ambiente virtual { #create-a-virtual-environment } Ao começar a trabalhar em um projeto Python **pela primeira vez**, crie um ambiente virtual **dentro do seu projeto**. @@ -114,7 +114,7 @@ Você pode criar o ambiente virtual em um diretório diferente, mas há uma conv /// -## Ative o ambiente virtual +## Ative o ambiente virtual { #activate-the-virtual-environment } Ative o novo ambiente virtual para que qualquer comando Python que você executar ou pacote que você instalar o utilize. @@ -166,17 +166,17 @@ $ source .venv/Scripts/activate Toda vez que você instalar um **novo pacote** naquele ambiente, **ative** o ambiente novamente. -Isso garante que, se você usar um **programa de terminal (CLI)** instalado por esse pacote, você usará aquele do seu ambiente virtual e não qualquer outro que possa ser instalado globalmente, provavelmente com uma versão diferente do que você precisa. +Isso garante que, se você usar um **programa de terminal (CLI)** instalado por esse pacote, você usará aquele do seu ambiente virtual e não qualquer outro que possa ser instalado globalmente, provavelmente com uma versão diferente do que você precisa. /// -## Verifique se o ambiente virtual está ativo +## Verifique se o ambiente virtual está ativo { #check-the-virtual-environment-is-active } Verifique se o ambiente virtual está ativo (o comando anterior funcionou). /// tip | Dica -Isso é **opcional**, mas é uma boa maneira de **verificar** se tudo está funcionando conforme o esperado e se você está usando o ambiente virtual pretendido. +Isso é **opcional**, mas é uma boa maneira de **verificar** se tudo está funcionando conforme o esperado e se você está usando o ambiente virtual intendido. /// @@ -212,7 +212,7 @@ Se ele mostrar o binário `python` em `.venv\Scripts\python`, dentro do seu proj //// -## Atualizar `pip` +## Atualizar `pip` { #upgrade-pip } /// tip | Dica @@ -242,9 +242,9 @@ $ python -m pip install --upgrade pip -## Adicionar `.gitignore` +## Adicionar `.gitignore` { #add-gitignore } -Se você estiver usando **Git** (você deveria), adicione um arquivo `.gitignore` para excluir tudo em seu `.venv` do Git. +Se você estiver usando **Git** (you should), adicione um arquivo `.gitignore` para excluir tudo em seu `.venv` do Git. /// tip | Dica @@ -282,7 +282,7 @@ Esse comando criará um arquivo `.gitignore` com o conteúdo: /// -## Instalar Pacotes +## Instalar Pacotes { #install-packages } Após ativar o ambiente, você pode instalar pacotes nele. @@ -294,7 +294,7 @@ Se precisar atualizar uma versão ou adicionar um novo pacote, você **fará iss /// -### Instalar pacotes diretamente +### Instalar pacotes diretamente { #install-packages-directly } Se estiver com pressa e não quiser usar um arquivo para declarar os requisitos de pacote do seu projeto, você pode instalá-los diretamente. @@ -333,7 +333,7 @@ $ uv pip install "fastapi[standard]" //// -### Instalar a partir de `requirements.txt` +### Instalar a partir de `requirements.txt` { #install-from-requirements-txt } Se você tiver um `requirements.txt`, agora poderá usá-lo para instalar seus pacotes. @@ -376,7 +376,7 @@ pydantic==2.8.0 /// -## Execute seu programa +## Execute seu programa { #run-your-program } Depois de ativar o ambiente virtual, você pode executar seu programa, e ele usará o Python dentro do seu ambiente virtual com os pacotes que você instalou lá. @@ -390,9 +390,9 @@ Hello World -## Configure seu editor +## Configure seu editor { #configure-your-editor } -Você provavelmente usaria um editor. Certifique-se de configurá-lo para usar o mesmo ambiente virtual que você criou (ele provavelmente o detectará automaticamente) para que você possa obter erros de preenchimento automático e em linha. +Você provavelmente usaria um editor. Certifique-se de configurá-lo para usar o mesmo ambiente virtual que você criou (ele provavelmente o detectará automaticamente) para que você possa obter preenchimento automático e erros em linha. Por exemplo: @@ -405,7 +405,7 @@ Normalmente, você só precisa fazer isso **uma vez**, ao criar o ambiente virtu /// -## Desativar o ambiente virtual +## Desativar o ambiente virtual { #deactivate-the-virtual-environment } Quando terminar de trabalhar no seu projeto, você pode **desativar** o ambiente virtual. @@ -419,7 +419,7 @@ $ deactivate Dessa forma, quando você executar `python`, ele não tentará executá-lo naquele ambiente virtual com os pacotes instalados nele. -## Pronto para trabalhar +## Pronto para trabalhar { #ready-to-work } Agora você está pronto para começar a trabalhar no seu projeto. @@ -433,7 +433,7 @@ Continue lendo. 👇🤓 /// -## Por que ambientes virtuais +## Por que ambientes virtuais { #why-virtual-environments } Para trabalhar com o FastAPI, você precisa instalar o Python. @@ -443,7 +443,7 @@ Para instalar pacotes, você normalmente usaria o comando `pip` que vem com o Py No entanto, se você usar `pip` diretamente, os pacotes serão instalados no seu **ambiente Python global** (a instalação global do Python). -### O Problema +### O Problema { #the-problem } Então, qual é o problema em instalar pacotes no ambiente global do Python? @@ -526,7 +526,7 @@ Agora, imagine isso com **muitos** outros **pacotes** dos quais todos os seus ** Além disso, dependendo do seu sistema operacional (por exemplo, Linux, Windows, macOS), ele pode ter vindo com o Python já instalado. E, nesse caso, provavelmente tinha alguns pacotes pré-instalados com algumas versões específicas **necessárias para o seu sistema**. Se você instalar pacotes no ambiente global do Python, poderá acabar **quebrando** alguns dos programas que vieram com seu sistema operacional. -## Onde os pacotes são instalados +## Onde os pacotes são instalados { #where-are-packages-installed } Quando você instala o Python, ele cria alguns diretórios com alguns arquivos no seu computador. @@ -552,7 +552,7 @@ Em seguida, ele **extrairá** todos esses arquivos e os colocará em um diretór Por padrão, ele colocará os arquivos baixados e extraídos no diretório que vem com a instalação do Python, que é o **ambiente global**. -## O que são ambientes virtuais +## O que são ambientes virtuais { #what-are-virtual-environments } A solução para os problemas de ter todos os pacotes no ambiente global é usar um **ambiente virtual para cada projeto** em que você trabalha. @@ -577,7 +577,7 @@ flowchart TB stone-project ~~~ azkaban-project ``` -## O que significa ativar um ambiente virtual +## O que significa ativar um ambiente virtual { #what-does-activating-a-virtual-environment-mean } Quando você ativa um ambiente virtual, por exemplo com: @@ -714,7 +714,7 @@ Um detalhe importante é que ele colocará o caminho do ambiente virtual no **in Ativar um ambiente virtual também muda algumas outras coisas, mas esta é uma das mais importantes. -## Verificando um ambiente virtual +## Verificando um ambiente virtual { #checking-a-virtual-environment } Ao verificar se um ambiente virtual está ativo, por exemplo com: @@ -766,7 +766,7 @@ E o segundo projeto **não funcionaria** porque você está usando o **Python in /// -## Por que desativar um ambiente virtual +## Por que desativar um ambiente virtual { #why-deactivate-a-virtual-environment } Por exemplo, você pode estar trabalhando em um projeto `philosophers-stone`, **ativar esse ambiente virtual**, instalar pacotes e trabalhar com esse ambiente. @@ -820,7 +820,7 @@ Eu juro solenemente 🐺 -## Alternativas +## Alternativas { #alternatives } Este é um guia simples para você começar e lhe ensinar como tudo funciona **por baixo**. @@ -834,10 +834,10 @@ Quando estiver pronto e quiser usar uma ferramenta para **gerenciar todo o proje * Gerenciar o **ambiente virtual** para seus projetos * Instalar **pacotes** * Gerenciar **dependências e versões** de pacotes para seu projeto -* Certifique-se de ter um conjunto **exato** de pacotes e versões para instalar, incluindo suas dependências, para que você possa ter certeza de que pode executar seu projeto em produção exatamente da mesma forma que em seu computador durante o desenvolvimento, isso é chamado de **bloqueio** +* Certificar-se de que você tenha um conjunto **exato** de pacotes e versões para instalar, incluindo suas dependências, para que você possa ter certeza de que pode executar seu projeto em produção exatamente da mesma forma que em seu computador durante o desenvolvimento, isso é chamado de **bloqueio** * E muitas outras coisas -## Conclusão +## Conclusão { #conclusion } Se você leu e entendeu tudo isso, agora **você sabe muito mais** sobre ambientes virtuais do que muitos desenvolvedores por aí. 🤓