Tutorial django 2.2 - Escrevendo sua primeira aplicação django - parte 1.

Escrevendo sua primeira aplicação django - parte 1.¶

Vamos aprender com exemplos

Ao longo deste tutorial, orientaremos você na criação de um aplicativo de pesquisa básica. Ele é composto por duas partes:

• Um site público que permite que as pessoas visualizem pesquisas e votem nelas.
• Um site de administração que permite adicionar, alterar e excluir pesquisas.

Vamos supor que você já tenha o Django instalado. Você pode voce pode ver qual a versão do Django está instalado com o seguinte comando atravez do python:

/ 

import django

print(django.__version__)

Se o Django estiver instalado, você deverá ver a versão da sua instalação. Caso contrário, você receberá um erro dizendo “No module named django”.

Este tutorial foi escrito para o Django 2.2, que suporta Python 3.5 e posterior. Se a versão do Django não corresponder você não conseguira acompanha-lo.

caso não tenha o django instalado veja a parte 0 desse tutorial: como instalar o django

Criando um projeto django¶

basta executar o seguinte comando: 

/ 

$ django-admin startproject meuSite

esse comando ira criar uma pasta meuSite com a seguinte estrutura:

meuSite/
    manage.py
    meuSite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

These files are:

• O diretório externo meuSite / root é apenas uma pasta que guarda o seu projeto. Seu nome não importa para o Django; você pode renomeá-lo para o que quiser.
• manage.py: Um utilitário de linha de comando que permite interagir com este projeto do Django de várias maneiras.
• O diretório meuSite / interno é o pacote Python real para o seu projeto. Seu nome é o nome do pacote Python que você precisará usar para importar qualquer coisa dentro dele (por exemplo, meuSite.urls).
• meuSite/ __ init__.py: Um arquivo vazio que informa ao Python que este diretório deve ser considerado um pacote Python. Se você é iniciante em Python, leia mais sobre pacotes nos documentos oficiais do Python.
• meuSite / settings.py: Definições / configuração para este projeto Django
• meuSite / urls.py: As declarações de URL para este projeto Django; um "sumário" do seu site desenvolvido pelo Django.
• meuSite / wsgi.py: um ponto de entrada para servidores Web compatíveis com WSGI para servir seu projeto. 

O servidor de testes

Vamos verificar se o seu projeto Django funciona. Mude para o diretório externo do meuSite, se você ainda não o fez, e execute os seguintes comandos:

/ 

$ python manage.py runserver

Você deve então abrir o seguinte link no navegador:

http://localhost:8000

ou

127.0.0.1:8000

Criando uma aplicação¶

Now that your environment – a “project” – is set up, you’re set to 

Note que uma aplicação é executada a partir do projeto, um projeto pode ter varias aplicações dentro delem essas aplicações são guardadas em suas proprias pastas com suas proprias estruturas.

Projects vs. apps

What’s the difference between a project and an app? An app is a Web application that does something – e.g., a Weblog system, a database of public records or a simple poll app. A project is a collection of configuration and apps for a particular website. A project can contain multiple apps. An app can be in multiple projects.

Para criar uma aplicação devemos executar o seguinte comando

/ 

python manage.py startapp appicacao

sua estrutura sera essa:

aplicacao/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

Criando sua primeira view:¶

Dentro do arquivo aplicacacao/views.py escreva o seguinte codigo:

aplicacao/views.py¶

from django.http import HttpResponse


def index(request):
    return HttpResponse("Ola mundo, essa é a view")

Esta é a view mais simples possível no Django. Para chamar a view, precisamos mapeá-la para uma URL, e para isso precisamos de um URLconf.

Para criar um URLconf na pasta aplicacao, crie um arquivo chamado urls.py. O diretório do seu aplicativo agora deve ter a seguinte aparência:

aplicacao/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

no arquivo polls/urls.py escreva o seguinte codigo:

aplicacao/urls.py¶

from django.urls import path

from . import views

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

O próximo passo é apontar o URLconf raiz para o módulo aplicacao.urls. Em meuSite/urls.py, adicione uma importação para django.urls.include e insira um include () na lista urlpatterns, da seguinte forma:

meuSite/urls.py¶

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

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

Dessa forma criamos rotas para as views, a função path recebe dois parametros no caso:

path("link ou rota", include("arquivo de view")

no caso a rota aplcacao/ executa a view que criamos.

apos fazer tudo isso execute o comando:

$ python manage.py runserver

E em seguida va par a o link http://localhost:8000/aplicacao/ Então você vera a view que foi criada.

mais informações sobre rotas e sobre a função path disponiveis em:

https://docs.djangoproject.com/en/2.0/topics/http/views/