Pular para conteúdo

Introdução ao Django

Roteiro para Desenvolvimento de Aplicação Web Django com SQLite no VS Code

Pré-requisitos

  • Visual Studio Code instalado
  • Python instalado (versão 3.8 ou superior)
  • Extensão Python para VS Code (recomendado)

Passo 1: Configurar Ambiente Virtual

  1. Abra o terminal no VS Code (Ctrl+ ou Terminal > Novo Terminal)
  2. Navegue até a pasta onde deseja criar o projeto
  3. Crie o ambiente virtual:
ctrl +shift + P
Python Create Enviroment

ou

bash python -m venv venv

4./ Ative o ambiente virtual:

  • Windows:
   .\venv\Scripts\activate
  • Linux/MacOS:
   source venv/bin/activate

5./ Verifique que o ambiente está ativo (deve aparecer (venv) no início da linha do terminal)

Passo 2: Instalar Django e Dependências

  1. Com o ambiente virtual ativo, instale o Django:
   pip install django

Passo 3: Criar Projeto Django

  1. Crie o projeto Django:
   django-admin startproject myproject .

(O ponto no final cria o projeto no diretório atual)

2./ Verifique a estrutura criada:

bash myproject/ __init__.py settings.py urls.py wsgi.py manage.py

Passo 4: Configurar o Banco de Dados SQLite

  1. O Django já vem configurado para usar SQLite por padrão (verifique em myproject/settings.py):

python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3', } }

  1. Execute as migrações iniciais:

bash python manage.py migrate

Passo 5: Criar uma Aplicação Django

  1. Crie uma nova aplicação:

bash python manage.py startapp myapp

  1. Adicione a aplicação ao INSTALLED_APPS em myproject/settings.py:

python INSTALLED_APPS = [ ... 'myapp', ]

Passo 6: Configurar URLs e Views Básicas

  1. Crie um arquivo urls.py na pasta myapp:

```python from django.urls import path from . import views

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

  1. Inclua as URLs da aplicação no projeto principal (myproject/urls.py):

```python from django.contrib import admin from django.urls import path, include

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

  1. Crie uma view básica em myapp/views.py:

```python from django.shortcuts import render from django.http import HttpResponse

def home(request): return HttpResponse("Bem-vindo ao meu site!") ```

Passo 7: Criar Modelos e Migrações

  1. Defina um modelo em myapp/models.py:

```python from django.db import models

class Produto(models.Model): nome = models.CharField(max_length=100) preco = models.DecimalField(max_digits=6, decimal_places=2) descricao = models.TextField() disponivel = models.BooleanField(default=True)

   def __str__(self):
       return self.nome

```

  1. Crie e aplique as migrações:

bash python manage.py makemigrations python manage.py migrate

Passo 8: Configurar o Painel de Administração

  1. Crie um superusuário:

bash python manage.py createsuperuser

  1. Registre o modelo no admin (myapp/admin.py):

```python from django.contrib import admin from .models import Produto

admin.site.register(Produto) ```

Passo 9: Executar o Servidor de Desenvolvimento

  1. Inicie o servidor:

bash python manage.py runserver

  1. Acesse no navegador:

  2. http://localhost:8000/ (página inicial)

  3. http://localhost:8000/admin/ (painel admin)

Passo 10: Adicionar Templates

  1. Crie uma pasta templates dentro da pasta myapp e, dentro dela, outra pasta chamada myapp (ou seja, myapp/templates/myapp):
   mkdir templates
  1. Crie um arquivo base.html na pasta templates:
   <html>
      <head>
         <title>{% block title %}{% endblock %}</title>
      </head>
      <  body>
         {% block content %}{% endblock %}      
      </body></html>
  1. Crie um arquivo home.html na pasta myapp/templates: 
   <h1>Bem-vindo ao meu site!</h1>
  1. Crie um arquivo index.html na pasta templates:
   {% extends "base.html" %}
   {% block title %}Home{% endblock %}
   {% block content %}{% include "home.html" %}{% endblock %}
  1. Adicionar urls para o template acima
   from django.urls import path  

   urlpatterns = [
       path('', views.home, name='home'), 
   ]
  1. Adicionar Views para template acima
   from django.shortcuts import render 
   from django.http import HttpResponse   

   def home(request):   
       return render(request, 'index.html')

Criar o template e os arquivos necessários para CRUD de Produto

1. Criar o formulário para Produto

No arquivo forms.py da pasta myapp:

from django import forms
from .models import Produto

class ProdutoForm(forms.ModelForm):
   class Meta:
      model = Produto
      fields = ['nome', 'preco', 'descricao', 'disponivel']

2. Criar as views para CRUD

No arquivo views.py da pasta myapp:

from django.shortcuts import render, get_object_or_404, redirect
from .models import Produto
from .forms import ProdutoForm

def produto_list(request):
   produtos = Produto.objects.all()
   return render(request, 'myapp/produto_list.html', {'produtos': produtos})

def produto_create(request):
   if request.method == 'POST':
      form = ProdutoForm(request.POST)
      if form.is_valid():
         form.save()
         return redirect('produto_list')
   else:
      form = ProdutoForm()
   return render(request, 'myapp/produto_form.html', {'form': form})

def produto_update(request, pk):
   produto = get_object_or_404(Produto, pk=pk)
   if request.method == 'POST':
      form = ProdutoForm(request.POST, instance=produto)
      if form.is_valid():
         form.save()
         return redirect('produto_list')
   else:
      form = ProdutoForm(instance=produto)
   return render(request, 'myapp/produto_form.html', {'form': form})

def produto_delete(request, pk):
   produto = get_object_or_404(Produto, pk=pk)
   if request.method == 'POST':
      produto.delete()
      return redirect('produto_list')
   return render(request, 'myapp/produto_confirm_delete.html', {'produto': produto})

3. Criar os templates

Crie os seguintes arquivos na pasta myapp/templates/myapp/:

produto_list.html

{% extends "base.html" %}
{% block title %}Produtos{% endblock %}
{% block content %}
<h1>Lista de Produtos</h1>
<a href="{% url 'produto_create' %}">Adicionar Produto</a>
<ul>
  {% for produto in produtos %}
   <li>
     {{ produto.nome }} - R$ {{ produto.preco }}
     <a href="{% url 'produto_update' produto.pk %}">Editar</a>
     <a href="{% url 'produto_delete' produto.pk %}">Excluir</a>
   </li>
  {% empty %}
   <li>Nenhum produto cadastrado.</li>
  {% endfor %}
</ul>
{% endblock %}

produto_form.html

{% extends "base.html" %}
{% block title %}Produto{% endblock %}
{% block content %}
<h1>{{ form.instance.pk|yesno:"Editar Produto,Adicionar Produto" }}</h1>
<form method="post">
  {% csrf_token %}
  {{ form.as_p }}
  <button type="submit">Salvar</button>
  <a href="{% url 'produto_list' %}">Cancelar</a>
</form>
{% endblock %}

produto_confirm_delete.html

{% extends "base.html" %}
{% block title %}Excluir Produto{% endblock %}
{% block content %}
<h1>Excluir Produto</h1>
<p>Tem certeza que deseja excluir "{{ produto.nome }}"?</p>
<form method="post">
  {% csrf_token %}
  <button type="submit">Confirmar</button>
  <a href="{% url 'produto_list' %}">Cancelar</a>
</form>
{% endblock %}

4. Configurar as URLs

No arquivo myapp/urls.py:

from django.urls import path
from . import views

urlpatterns = [
   path('produtos/', views.produto_list, name='produto_list'),
   path('produtos/novo/', views.produto_create, name='produto_create'),
   path('produtos/<int:pk>/editar/', views.produto_update, name='produto_update'),
   path('produtos/<int:pk>/excluir/', views.produto_delete, name='produto_delete'),
]

E inclua essas URLs no arquivo myproject/urls.py:

from django.urls import path, include

urlpatterns = [
   # ... outras rotas ...
   path('', include('myapp.urls')),
]

Pronto! Agora você tem um CRUD completo para o modelo Produto.

Crie um arquivo tests.py na pasta myapp:

   from django.test import TestCase
from .models import Produto

class ProdutoModelTest(TestCase):
    def setUp(self):
        Produto.objects.create(
            nome="Camiseta",
            preco=49.90,
            descricao="Camiseta 100% algodão",
            disponivel=True
        )

    def test_criacao_produto(self):
        produto = Produto.objects.get(nome="Camiseta")
        self.assertEqual(produto.preco, 49.90)
        self.assertTrue(produto.disponivel)
        self.assertEqual(str(produto), "Camiseta")
  1. Execute as migrações iniciais:
   python manage.py migrate
  1. Execute os testes:
   python manage.py test
  1. Crie um arquivo wsgi.py na pasta myproject:
   from django.core.wsgi import get_wsgi_application   
   os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')   
   application = get_wsgi_application()
  1. Crie um arquivo settings.py na pasta myproject:
  2. Crie um arquivo urls.py na pasta myproject:
  3. Crie um arquivo asgi.py na pasta myproject:
   from django.core.asgi import get_asgi_application

   os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')

   application = get_asgi_application()
  1. Execute as migrações iniciais:
   python manage.py migrate
  1. Execute os testes:
   python manage.py test