Django 'Hello World'

Antes que possamos colocar o Django para funcionar, você precisará do Python 3.8+ e do pip (o instalador de pacotes padrão do Python) instalados em seu sistema. A maioria dos sistemas operacionais modernos já vem com o Python pré-instalado, mas é sempre bom verificar.

Abra seu terminal e veja qual versão do Python está lá:

python3 --version

Se você não vir algo como Python 3.8.x ou mais recente, ou se o Python não for encontrado, uma rápida visita a python.org resolverá isso para você. Certifique-se de baixar a versão estável mais recente do 3.x — o Django gosta disso.

Veja, mexer com pacotes Python globais é como soltar uma criança em uma biblioteca imaculada — as coisas ficam confusas rapidamente. É por isso que usamos ambientes virtuais. Eles são bolhas limpas e autônomas para as dependências do seu projeto, mantendo tudo organizado e evitando conflitos.

Primeiro, decida onde você quer que seu projeto Django viva. Navegue até lá no seu terminal, depois crie um novo ambiente virtual:

python3 -m venv .venv

Agora, vamos ativá-lo. O comando difere ligeiramente dependendo do seu sistema operacional:

# No macOS/Linux
source .venv/bin/activate

# No Windows (use Prompt de Comando)
.venv\Scripts\activate

Você saberá que está funcionando quando o prompt do seu terminal ganhar um pequeno prefixo (.venv). É como um pequeno distintivo de honra, significando seu reino de desenvolvimento isolado.

Com nosso ambiente virtual funcionando, é hora do evento principal: trazer o Django para o time. Isso é surpreendentemente fácil — apenas um comando.

Em seu ambiente virtual ativo, execute:

pip install django

O Pip baixará o Django e todos os seus companheiros necessários. Assim que terminar, você será oficialmente um desenvolvedor habilitado para Django. O framework está instalado e pronto para ser colocado em uso.

Agora para um pouco de magia Django! Usaremos o comando django-admin, que vem junto com o Django, para criar um novo projeto. Pense nisso como o Django fornecendo os projetos de base para seu aplicativo web.

A partir do diretório raiz do seu projeto (onde seu .venv está), execute este comando:

django-admin startproject mysite .

O . no final é importante; ele diz ao Django para criar os arquivos do projeto em seu diretório atual, em vez de aninhá-lo em outra pasta mysite. Agora você terá uma estrutura básica de projeto Django, uma espécie de esqueleto para seus sonhos web.

Depois de executar o comando startproject, seu diretório terá florescido com alguns novos arquivos e um subdiretório. Vale a pena dar uma olhada rápida para entender o que é o quê:

.
├── .venv/                  # Seu ambiente virtual
├── manage.py               # Uma utilidade de linha de comando para Django
└── mysite/                 # O pacote Python real para seu projeto
    ├── __init__.py         # Torna mysite um pacote Python
    ├── asgi.py             # Ponto de entrada ASGI para servidores assíncronos
    ├── settings.py         # Configurações e configurações do projeto
    ├── urls.py             # Declarações de URL do seu projeto
    └── wsgi.py             # Ponto de entrada WSGI para servidores síncronos
                                

manage.py é seu fiel companheiro para tudo relacionado à linha de comando do Django. Dentro de mysite/, settings.py é onde você ajustará as configurações, e urls.py é o principal controlador de tráfego do seu projeto.

Antes mesmo de pensarmos em ver uma página da web, o Django precisa configurar suas tabelas de banco de dados padrão. Ele vem com alguns recursos integrados, como autenticação de usuário e uma interface de administração, e estes precisam de um lugar para armazenar seus dados.

É aqui que entram as migrações. Elas são essencialmente instruções para o seu banco de dados. Execute isso a partir da raiz do seu projeto (onde manage.py está):

python manage.py migrate

Você verá uma série de atividades enquanto o Django cria tabelas para autenticação, sessões e seu painel de administração no banco de dados SQLite padrão. É como preparar a fundação antes de construir quaisquer paredes.

No Django, um "projeto" é uma coleção de configurações e "aplicativos". Um "aplicativo" é uma aplicação web que faz uma coisa específica — um blog, uma enquete, um simples "Olá Mundo". Essa modularidade é um dos superpoderes do Django, permitindo que você reutilize aplicativos em diferentes projetos.

Vamos criar nosso primeiro aplicativo. Vamos chamá-lo de hello_world_app. Execute este comando:

python manage.py startapp hello_world_app

Agora você verá um novo diretório, hello_world_app/, aninhado em seu projeto. É aqui que a mágica do nosso "Olá Mundo" realmente acontecerá.

O Django não sabe magicamente sobre novos aplicativos que você cria. Você precisa dizer explicitamente às configurações do seu projeto que este novo aplicativo existe e deve ser incluído. É como adicionar um novo membro a um clube — você precisa atualizar a lista de membros.

Abra mysite/settings.py e encontre a lista INSTALLED_APPS. Adicione seu novo hello_world_app a ela:

# mysite/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world_app',  # <-- Adicione esta linha
]
                                

Sem isso, o Django não se daria ao trabalho de procurar dentro do seu novo aplicativo por views, models ou qualquer outra coisa. É um aperto de mão crucial entre seu projeto e seu novo componente brilhante.

Uma "view" no Django é uma função ou classe Python que recebe uma solicitação web e retorna uma resposta web. Essencialmente, é a lógica central que decide qual conteúdo mostrar quando alguém visita uma URL específica.

Abra hello_world_app/views.py e substitua seu conteúdo por esta função simples:

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django World!")
                                

Esta função, index, é notavelmente simples: ela apenas exibe o texto "Olá, Mundo Django!" quando chamada. Bem legal para um primeiro passo, não é?

Para que sua nova view seja acessível por um endereço web, ela precisa de um padrão de URL. Criaremos um arquivo dedicado urls.py *dentro* do nosso hello_world_app para gerenciar suas rotas específicas. Isso mantém as coisas modulares, como o Django gosta.

Crie um novo arquivo: hello_world_app/urls.py, e dê a ele este conteúdo:

# hello_world_app/urls.py

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]
                                

Aqui, path("", views.index, name="index") significa que um caminho vazio (ou seja, a raiz do espaço de URL do nosso aplicativo) acionará nossa view index. Simples, né?

Informamos ao nosso aplicativo sobre seus próprios URLs, mas o principal despachante de URLs do projeto (mysite/urls.py) ainda precisa ser informado de que nosso hello_world_app tem caminhos que ele considera. É como ter um escritório filial, mas a sede principal precisa saber que ele existe para encaminhar o correio.

Abra mysite/urls.py e adicione um include para vincular os URLs do seu aplicativo:

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- Adicione 'include'

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- Adicione esta linha
]
                                

Agora, quando alguém visitar o URL raiz do seu projeto (/), o Django "incluirá" os padrões de URL de hello_world_app/urls.py e encontrará sua view "Olá Mundo". As peças estão se encaixando!

Colocamos toda a base, costuramos o código e definimos as rotas. Agora, o momento da verdade! O Django vem com um servidor de desenvolvimento leve que é perfeito para testar as coisas localmente.

A partir do diretório raiz do seu projeto (onde manage.py está), execute:

python manage.py runserver

Você verá uma série de saídas no terminal, terminando com algo como Starting development server at http://127.0.0.1:8000/. Isso significa que seu servidor Django está ativo e pacientemente esperando por solicitações.

O momento chegou! Abra seu navegador web e navegue até o endereço que o Django forneceu, geralmente http://127.0.0.1:8000/.

Se todos os fios estiverem conectados corretamente, você será recebido por uma página web simples exibindo orgulhosamente:

E aí está — sua primeira aplicação "Olá Mundo" do Django, ao vivo e servindo conteúdo! É um pequeno passo, mas confirma que tudo está configurado corretamente, do Python ao roteamento de URL do Django. Você oficialmente iniciou sua jornada no desenvolvimento Django.