O Alura Space é uma galeria de imagens com temática espacial, um ambiente colaborativo para que várias pessoas possam adicionar fotografias de corpos celestiais.
Atualmente, apenas quem tem acesso ao admin consegue inserir novas imagens, ou seja, pessoas desenvolvedoras e administradoras desse sistema. Precisamos adicionar uma nova funcionalidade para realizar o cadastro e o login de novas pessoas usuárias, para que elas possam inserir imagens também. Portanto, vamos criar outra app no Django.
Nova aplicação no Django
Vamos abrir o VS Code. No painel à esquerda, na estrutura de arquivos do projeto, já temos uma app chamada "galeria". A seguir, vamos criar uma app chamada "usuarios".
Não podemos utilizar o prompt de comando atual, porque ele está sendo usado para manter o servidor no ar, então vamos criar outro. Basta clicar no símbolo de "+" no canto superior direito do terminal ou pressionar "Ctrl + Shift + '".
Para consultar a lista de comandos disponíveis no Django, podemos executar a seguinte linha:
Vamos usar o comando startapp, seguido do nome da nova app:
python manage.py startapp usuarios
Agora, na estrutura de arquivos, além da aplicação "galeria", também temos a aplicação "usuarios".
Nosso próximo passo é adicionar a nova aplicação ao projeto. Vamos expandir a pasta "setup" (onde se encontra nosso projeto Python) e abrir o arquivo settings.py.
Na pasta "usuarios", há um arquivo chamado apps.py, em que constam as configurações dessa nova aplicação. Logo, é deste arquivo que faremos a importação da referência em settings.py para indicar a nova aplicação.
Em settings.py, vamos adicionar a referência usuarios.apps.UsuariosConfig dentro de INSTALLED_APPS:
Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'galeria.apps.GaleriaConfig',
'usuarios.apps.UsuariosConfig',
]
código posterior omitido
É uma boa prática fazer a importação, em vez de simplesmente colocar "usuarios", porque em apps.py temos todas as configurações da aplicação. Assim, futuramente podemos mudar as configurações sem causar conflitos no projeto.
Portanto, fizemos a importação e nosso projeto Django já reconhece a nova aplicação.
Boas práticas
A seguir, vamos aplicar algumas boas práticas na aplicação "usuarios". Trata-se de boas práticas que aplicamos em "galeria" anteriormente.
Idealmente, em cada uma de nossas aplicações, teremos um arquivo chamado urls.py. Já criamos esse arquivo na aplicação "galeria", então vamos repetir o processo em "usuarios".
Na pasta "usuarios", vamos criar um arquivo chamado urls.py. Vamos copiar o conteúdo de "galeria > urls.py" e colá-lo em "usuarios > urls.py" para ter uma base:
from django.urls import path
from galeria.views import index, imagem, buscar
urlpatterns = [
path('', index, name='index'),
path('imagem/<int:foto_id>', imagem, name='imagem'),
path('buscar', buscar, name='buscar'),
]
Vamos remover os paths, já que ainda não temos nenhum. Mais adiante, pensaremos em que tipos de paths colocaremos nessa aplicação. Também removeremos a importação da segunda linha. Por enquanto, o arquivo "usuarios > urls.py" ficará da seguinte forma:
from django.urls import path
urlpatterns = [
]
Em seguida, vamos abrir o arquivo "setup > urls.py", pois precisamos indicar que temos um novo direcionamento. Vamos incluir o path para urls.py da aplicação "usuarios":
from django.contrib import admin
from django.urls import path, include
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('galeria.urls')),
path('', include('usuarios.urls')),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
Sendo assim, geramos a aplicação "usuarios" e criamos seu respectivo arquivo urls.py, adotando boas práticas de desenvolvimento.
Para finalizar, vamos entender por que optamos por criar uma aplicação "usuarios", em vez de gerar uma nova página.
A divisão em apps fica a critério da pessoa desenvolvedora. Como implementaremos muitas funcionalidades acerca de usuários (como cadastro, login e autenticação), julgamos ser coerente ter duas aplicações distintas. A aplicação "galeria" para focar na inserção de novas fotografias e a aplicação "usuarios" para cuidar de processos relativos às pessoas usuárias.
No próximo vídeo
Na aplicação "usuarios", há um arquivo chamado views.py, no qual constarão todas as views para as páginas da nossa app. A partir do próximo vídeo, começaremos a desenvolver esse arquivo, gerando views que farão referência a cadastro, login e quaisquer outros recursos necessários para manejar relativos a usuários.