Introdução

Django é um dos frameworks mais populares para desenvolvimento web em Python, conhecido por sua robustez, facilidade de uso e rapidez para construir aplicações web. Com o lema “The Web framework for perfectionists with deadlines” (O framework web para perfeccionistas com prazos), Django oferece uma estrutura que permite desenvolver aplicativos seguros e escaláveis com rapidez. Neste artigo, vamos explorar como iniciar um projeto Django, passando pelo ambiente virtual, instalação do Django e criação de uma aplicação básica. Ao final, você terá uma base sólida para expandir e construir aplicações mais complexas.

Passo a Passo para Iniciar um Projeto Django

É uma boa prática utilizar um ambiente virtual ao desenvolver em Python, pois ele ajuda a isolar as dependências do projeto. Para configurar, siga as instruções abaixo:

# Python

# Navegue até a pasta onde deseja criar seu projeto
cd ~/meus-projetos

# Crie o ambiente virtual (substitua "venv" pelo nome que preferir)
python3 -m venv venv

# Ative o ambiente virtual
source venv/bin/activate  # Para Linux ou MacOS
venv\Scripts\activate  # Para Windows

Com o ambiente virtual ativado, todas as bibliotecas que instalarmos estarão contidas nesse ambiente, sem interferir com outras instalações Python no sistema.

Passo 2: Instalando o Django

Com o ambiente virtual ativo, o próximo passo é instalar o Django usando o comando abaixo:

# Python
pip install django

Para verificar se a instalação foi bem-sucedida e ver a versão do Django instalada, execute:

# Python
django-admin --version

Passo 3: Criando um Novo Projeto Django

Agora, vamos criar um novo projeto Django. Esse projeto servirá como a estrutura principal para nossa aplicação web.

# Python
# Substitua "meuprojeto" pelo nome do seu projeto
django-admin startproject meuprojeto
cd meuprojeto

Esse comando criará uma estrutura de pastas com a seguinte configuração:

# Python
meuprojeto/
├── manage.py
├── meuprojeto/
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    ├── asgi.py
    └── wsgi.py

Passo 4: Rodando o Servidor de Desenvolvimento

Com o projeto configurado, vamos iniciar o servidor de desenvolvimento para garantir que tudo está funcionando corretamente. Execute o seguinte comando:

# Python
python manage.py runserver

Se tudo estiver funcionando, você verá uma mensagem indicando que o servidor está rodando. Abra seu navegador e acesse http://127.0.0.1:8000/ para ver a página inicial padrão do Django.

Passo 5: Criando um Aplicativo Django

No Django, um “aplicativo” representa uma parte da funcionalidade de um site. Vamos criar um aplicativo chamado blog como exemplo:

# Python
python manage.py startapp blog

Esse comando criará uma nova pasta chamada blog dentro do diretório do projeto, contendo os arquivos necessários para o funcionamento do aplicativo.

Passo 6: Configurando o Aplicativo no Projeto

Para que o Django reconheça o novo aplicativo, precisamos adicioná-lo na configuração do projeto. Abra o arquivo settings.py e, na seção INSTALLED_APPS, adicione o nome do aplicativo:

# Python
# em meuprojeto/settings.py
INSTALLED_APPS = [
    ...
    'blog',
]

Passo 7: Criando a Primeira View

Vamos criar uma view simples no aplicativo blog. No arquivo views.py dentro da pasta blog, adicione o seguinte código:

# Python
# blog/views.py
from django.http import HttpResponse

def homepage(request):
    return HttpResponse("Bem-vindo ao meu Blog!")

Passo 8: Configurando a URL

Para que a view esteja acessível, precisamos definir uma URL para ela. Crie um novo arquivo chamado urls.py na pasta blog e adicione o seguinte conteúdo:

# Python
# blog/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('', views.homepage, name='homepage'),
]

Agora, abra o arquivo urls.py do projeto e inclua as URLs do aplicativo blog:

# Python
# meuprojeto/urls.py
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('blog.urls')),
]

Passo 9: Testando a Aplicação

Com tudo configurado, inicie novamente o servidor e acesse http://127.0.0.1:8000/. Se tudo foi feito corretamente, você verá a mensagem “Bem-vindo ao meu Blog!” na página inicial.

# Python
python manage.py runserver

Conclusão:

Com esse guia, você aprendeu o básico para iniciar um projeto Django: desde a configuração do ambiente virtual até a criação de um aplicativo com uma view simples. Django é uma ferramenta poderosa que oferece inúmeras funcionalidades para desenvolver aplicações robustas e escaláveis rapidamente. Com essa base, você está pronto para explorar mais sobre o framework e criar aplicações cada vez mais complexas!