Instalando e Configurando o Django

Antes de iniciar um projeto com Django, é essencial ter o interpretador Python instalado no sistema. Mais informações sobre como instalar o Python podem ser encontradas aqui.

Existem diferentes métodos para instalar o Django, sendo que o método recomendado envolve o uso do gerenciador de pacotes pip.

Gerenciador de Pacotes pip

Os pacotes Django são disponibilizados no repositório central de pacotes Python, conhecido como Python Package Index (PyPI). Para instalar o Django a partir desse repositório, é necessário ter o pip instalado no sistema. O pip permite baixar e gerenciar pacotes. Geralmente, o pip é instalado junto com o Python. A versão do pip pode ser verificada no terminal com o comando:

pip -V

Exemplo de saída:

pip 24.3.1 from /usr/local/lib/python3.13/site-packages/pip (python 3.13)

Caso o pip não esteja instalado, uma mensagem de erro será exibida. Para instalar o pip, o comando a seguir pode ser executado:

python -m ensurepip --upgrade

Se o pip já estiver instalado, mas for necessário atualizá-lo, pode ser usado o seguinte comando:

python -m pip install --upgrade pip

Configuração de um Ambiente Virtual

Embora não seja obrigatório, recomenda-se o uso de um ambiente virtual (ou venv) ao trabalhar com Django. Um ambiente virtual isola pacotes de diferentes projetos Python na mesma máquina, garantindo que um aplicativo possa ser executado sem interferir em outros.

Sem o uso de um ambiente virtual, os pacotes Django seriam instalados globalmente. Isso pode ser problemático, pois diferentes projetos podem requerer versões distintas do Django. Ao utilizar ambientes virtuais, cada projeto possui seu próprio conjunto de pacotes, evitando conflitos de dependências.

Para criar um ambiente virtual, o módulo integrado venv pode ser usado. Primeiro, deve-se navegar até o diretório onde os projetos Django serão armazenados. Por exemplo, o diretório C:\django. Em seguida, o comando para criar o ambiente virtual é:

python -m venv .venv

No exemplo acima, o ambiente virtual foi nomeado como .venv, mas podem ser usados outros nomes. Após criar o ambiente, um subdiretório chamado .venv será criado dentro do diretório especificado.

Ativação do Ambiente Virtual

Após criado, o ambiente virtual precisa ser ativado. O método de ativação varia conforme o sistema operacional e a ferramenta de linha de comando utilizada:

Windows (Prompt de Comando)
```
.venv\Scripts\activate.bat
```
Windows (PowerShell)
É necessário configurar permissões antes de ativar o ambiente:
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
Em seguida, o ambiente pode ser ativado com o comando:
```
.venv\Scripts\Activate.ps1
```
Linux/MacOS
A ativação é feita com o comando:
```
source .venv/bin/activate
```

Após a ativação bem-sucedida, o nome do ambiente virtual aparecerá entre parênteses antes do prompt do terminal, indicando que o ambiente está ativo, por exemplo:

(.venv) C:\django>

Com o ambiente virtual ativado, o Django pode ser instalado executando o comando:

python -m pip install Django

Esse comando instala a versão mais recente do Django. Caso uma versão específica seja necessária, ela pode ser especificada com o comando:

python -m pip install django~=4.0.0

Verificação da Instalação

Para verificar se o Django foi instalado corretamente, o interpretador Python pode ser aberto e os comandos abaixo podem ser executados:

python
import django
django.get_version()

O comando python abre o interpretador Python, enquanto import django importa o pacote Django. Por fim, django.get_version() exibe a versão do Django instalada.

Se a instalação foi bem-sucedida, a versão do Django será exibida no terminal. Caso contrário, uma mensagem de erro será exibida.

Desativação do Ambiente Virtual

Quando não for mais necessário usar o ambiente virtual, ele pode ser desativado. Isso pode ser feito executando o comando:

deactivate

Após a desativação, o terminal retornará ao estado original, sem o ambiente virtual ativo.

Caso você esteja no interpretador Python, o comando deactivate não será reconhecido, pois ele é uma instrução exclusiva do terminal. Para desativar o ambiente virtual corretamente, saia do interpretador Python digitando exit() ou pressionando Ctrl + Z seguido de Enter no Windows, ou Ctrl + D no Linux/MacOS. Isso retornará você ao terminal.