005 Django 5 - Basic App (Import View)

O que é um App Django?

Um app no Django é uma aplicação web que faz algo — um grupo de modelos, views, templates, e outras partes lógicas que tratam de um problema específico ou funcionalidade. Apps são projetados para serem reutilizáveis, plugáveis e independentes, facilitando a manutenção e a extensão de funcionalidades.

COMO RODAR ESSE PROJETO EM SEU COMPUTADOR:

Requisitos

• Python 3.12 com PIP e venv

• o Django 5 requer Python 3.10 ou superior.

• No repositório 001 há explicações sobre PIP e venv

  Baixar Python 3.12

  Confira o vídeo para saber como trabalhar com múltiplas versões do Python e com venv (ambiente virtual):
  

7 passos simples para executar

1. Clone o repositório:

   git clone https://github.com/Django-Dev-Br/005-Django5-Basic-App.git

2. Crie um ambiente virtual:

   Windows

   python -m venv myvenv  

   Linux

   python3 -m venv myvenv  

3. Ative o ambiente virtual criado:

   Windows

   myvenv\Scripts\activate  

   Linux

   source myvenv/bin/activate  

4. Acesse a pasta do repositório:

   cd 005-Django5-Basic-App

5. Instale o Django:

   Fazer a instalação após a ativação da virtual env fará com que a instalação seja feita nessa pasta ao invés do computador. Isso significa que o pacote Django não estará disponivel para todos os usuários do computador, mas apenas para o contexto no qual essa venv esteja ativada. Veremos sua ativação logo abaixo.

   Instalação manualmente via gerenciador de dependências PIP

   pip install django

   • use, preferencialmente, a versão 5.1. Para tanto, execute o comando:

   pip install  "django>=5.1,<=5.2"

   ----- OU -----

   Instalação via arquivo requirements

   pip install -r requirements.txt

   O arquivo requirements.txt é um arquivo de texto que contém uma lista de pacotes a ser instalado em uma venv. É uma boa prática de programação do ecossistema Python.

6. Execute o servidor de desenvolvimento:

   python manage.py runserver

7. Acesse a View no Navegador:

   Abra o navegador e vá para o endereço http://127.0.0.1:8000/ para ver a mensagem:

   app up and running properly
   

Estrutura de Diretórios do Projeto = 1 arquivo (manage.py) e 1 pasta (o projeto Django) contendo 5 outros arquivos.

005-Django5-Basic-App/
├── db.sqlite3          # Banco de dados SQLite gerado pelo Django
├── manage.py           # CLI do Django - script que recebe e executa os comandos do Django via terminal
├── myapp/              # Diretório do aplicativo Django criado para essa funcionalidade
│   ├── __init__.py     # Marca o diretório como um pacote Python, permitindo importações
│   ├── apps.py         # Configurações da aplicação Django (metadados da aplicação)
│   ├── views.py        # arquivo que carrega os templates ou páginas html
│   ├── migrations/     # Diretório onde ficam os arquivos com as estruturas das tabelas do seu banco de dados
├── myproject/          # Diretório principal do projeto Django
│   ├── __init__.py     # Marca o diretório como um pacote Python
│   ├── asgi.py         # Configurações para o servidor ASGI (usado para aplicações assíncronas)
│   ├── settings.py     # Configurações do projeto (banco de dados, apps instalados, etc.)
│   ├── urls.py         # Mapeamento de requisições HTTP e redirecionamento para os templates HTML
│   ├── wsgi.py         # Configurações para o servidor WSGI (usado para servir a aplicação)
│   └── __pycache__/    # Diretório com arquivos de cache do projeto (não deve ser versionado)
├── README.md           # Documento explicativo sobre o projeto e como configurá-lo (essa que vc está lendo agora)
└── requirements.txt    # Lista de pacotes Python necessários para o projeto

Código deste projeto

arquivo: myprojecto/urls.py

from django.contrib import admin
from django.urls import path
from myapp import views  # Importa o módulo de views do app 'myapp'

urlpatterns = [
    path('admin/', admin.site.urls), 
    path('', views.example_view),     # URL para a página inicial que chama a função `example_view`, a mesma que vc vê quando executa o comando runserver acima
]

arquivo: myapp/views.py

from django.http import HttpResponse  # Importa a classe HttpResponse, responsável por retornar respostas HTTP

def example_view(request):
    return HttpResponse("app up and running properly")  # Retorna uma mensagem indicando que o app está funcionando corretamente

Comentários: example_view(request): Define uma função que recebe uma requisição HTTP e retorna uma resposta indicando que a aplicação está funcionando bem.

Neste projeto, criar uma resposta simples em uma view do Django foi extremamente fácil e direto. Foi necessário modificar apenas dois arquivos:

1. myproject/urls.py: Adicionamos a rota principal ('/') para direcionar à função example_view da nossa aplicação (myapp).
2. myapp/views.py: Criamos a função example_view que retorna uma resposta HTTP simples indicando que a aplicação está funcionando corretamente.

Com apenas essas duas alterações, conseguimos configurar o Django para retornar uma mensagem no navegador ao acessar a URL principal ('/'). Isso mostra o quão ágil e eficiente é trabalhar com o Django, permitindo criar e testar respostas de forma muito prática.

Como Criar um Novo App Django

Para criar um novo app em um projeto Django, use o seguinte comando:

python manage.py startapp nome_do_app

Antes, veja como criar um projeto Django no repositório nº 01

Sobre Nosso Treinamento Prático-Profissional com projeto real para iniciantes e avançados em web DevOps Full-stack com Python, Django, Bootstrap e Linux.

Django Developers Brasil - Aprenda programando enquanto programa aprendendo!

Nosso treinamento oferece uma experiência prática de aprendizado de programação, adequada tanto para iniciantes quanto para desenvolvedores avançados. Você participará de um projeto real de desenvolvimento de software em um ambiente corporativo autêntico, onde pessoas com diferentes níveis de conhecimento irão colaborar, aprendendo umas com as outras.

Junte-se a nós! E desenvolva as habilidades necessárias para o mercado de trabalho, aprimorando tanto seus conhecimentos técnicos quanto suas soft skills em um ambiente colaborativo e realista.