Django 50 minutos

---

---

# Django em 50 minutos
## O framework para perfeccionistas com prazos
---

## Quem?

## O que é Django?

## Como o Django Funciona?

## Hello World

## E agora?

]

---

---

## George Silva

### Diretor técnico SIGMA

### Foco principal: Soluções em Geoprocessamento, com tecnologia livre.

### Áreas de atuação:
> Desenvolvimento de Sistemas;

> Banco de Dados Espacial;

> Cartografia Digital e Sensoriamento Remoto;

### Principais clientes:
- PRODAM-SP
- Ministério da Saúde
- Força Aérea Brasileira
]

---

### 12 colaboradores;

### Já mapeamos mais de 40 mil km2;

### 9 sistemas, atualmente em produção 24/7;

### 17 pacotes open-source publicados;

### mais de 300 contribuições em projetos open-source;

### mais de 2000 km em contribuições para o OpenStreetMap;
]

---

---

# O que é o Django?

---

name: django-unchained
template: base
background-image: url(imagens/django-unchained.jpg)

---

name: django-vereador
template: base
background-image: url(imagens/django-vereador.jpg)

---

## Framework escrito em Python

## Utiliza o padrão MVT (Model, View, Template)

## Rápido e de fácil desenvolvimento

## Seguro

## Escalável

]

---

# Mozilla

# G1

# National Geographic

# NASA

# INCRA, MDA, MS e possivelmente outros órgãos do Gov. Federal

# Nós
]

---

---

## Model (mapeia entidades)

## View (encapsula lógica)

## Template (apresenta os dados)
]

---

![Arquitetura](imagens/arquitetura.jpg)

---

## Tudo começa com uma requisição HTTP

## Django captura e compara com as urls (ou rotas)

## Django invoca a view correspondente

## View faz o trabalho pesado

## View decide o que deve ser feito e devolve resposta HTTP

]

---

![Fluxo dos dados](imagens/data-flow.png)

---

---

# Como começar?

## virtualenv

```bash
sudo apt-get update && sudo apt-get install python-virtualenv
```

## criar virtualenv
```bash
mkdir -p ~/.virtualenvs
cd ~/.virtualenvs
virtualenv django-hello-world
```

## instalar django

```bash
source ~/.virtualenvs/django-hello-world/bin/activate
pip install django
```
]

---

```bash
mkdir -p ~/projetos/hello-world
cd ~/projetos/hello-world
django-admin startproject hello_world .
```

## resultado

```text
.
├── hello_world
│  ├── __init__.py
│  ├── settings.py
│  ├── urls.py
│  └── wsgi.py
└── manage.py

1 directory, 5 files
```

Esta estrutura não é recomendada para produção. É apenas um hello-world!

]

---

## Testando nosso projeto

```bash
./manage.py runserver
```

## Acesse localhost

```bash
firefox localhost:8000
```

## Viu isso?

![Sucesso Django](imagens/ss01.png)

]

---

---

# Apps

## O django usa as apps como forma de quebrar seu projeto

## As apps são separações lógicas de código

## Devem conter funcionalidade sem repetição

## Promovem reuso de código

## São "mini-projetos"

]

---

---

# Criando sua primeira app

```bash
# assumindo que estamos na raiz do projeto: ~/projetos/hello-world
./manage.py startapp meetups
```

## Djanguinho gente boa

```bash
# ainda na raiz do projeto
ls
> db.sqlite3  hello_world  manage.py  meetups
cd meetups
ls
> admin.py  __init__.py  migrations  models.py  tests.py  views.py
```

]

---

## Instale sua app

```python
# ... settings.py
INSTALLED_APPS = (
 'django.contrib.admin',
 'django.contrib.auth',
 'django.contrib.contenttypes',
 'django.contrib.sessions',
 'django.contrib.messages',
 'django.contrib.staticfiles',
 'meetups', # <=== adicionamos nossa app aqui
)
# ...
```

# Criando sua primeira view

abra o meetups/views.py

]

---

## Era assim

```python
# meetups/views.py
from django.shortcuts import render

# Create your views here.
```

## Vamos renderizar um olá mundo

```python
# meetups/views.py 
# coding: utf-8 <=== estamos usando Python 2.7, temos que declarar o encoding
from django.http import HttpResponse # <=== novo import
from django.shortcuts import render # <=== por agora não usaremos o render

def home(request):
    # nossa string deve ser passada como unicode, por isso "uzinho"
    return HttpResponse(u'Olá Mundo')
```
]

---

Precisamos criar a URL ou rota necessária para enxergarmos isso
aí.

Abra o arquivo hello_world/urls.py

```python
# hello_world/urls.py
from django.conf.urls import include, url
from django.contrib import admin
from meetups.views import home

urlpatterns = [
    url(r'^$', home, name='home'),
    url(r'^admin/', include(admin.site.urls)),
]

```

## Recarregue localhost:8000

existem várias considerações de arquitetura a serem feitas neste slide. esta **não** é a forma ideal de organizar um projeto.

]

---

## Modelos são onde abstraimos os dados do sistema

## Modelos são (idealmente) independentes da camada de persistência

## O Django sabe criar as tabelas para você*

Mas isso não é desculpa para não aprender SQL. Aliás, SQL é fundamental.
]

---

Abra o arquivo meetups/models.py

```python
from django.db import models

# Create your models here.
```

Vamos adicionar um modelo. Modelo são representados por classes.

```python
from django.db import models

class Meetup(models.Model):
    pass
```

Este modelo não faz nada, mas é a declaração mínima para o mesmo existir.

Vamos adicionar alguns atributos neste modelo.
]

---

```python
from django.db import models

class Meetup(models.Model):
    nome = models.CharField(max_length=128,
                            verbose_name='Nome')

data = models.DateTimeField(verbose_name='Data/Hora')
```

Agora que nosso modelo já existe, vamos validar ele com o Django.

```bash
# raiz do projeto
./manage.py check
> System check identified no issues (0 silenced).
```

Ok, sem tretas. Vamos aplicar as mudanças no banco de dados.

Você pode usar validate ou check. Validate nas versões anteriores e check em Django > 1.9

]

---

# Migrações

## Migrações são a forma utilizada para controlar o modelo de dados

## O fluxo é:

1. Alterar/criar modelo;
1. Registras as mudanças;
1. Aplicar as mudanças;

Já fizemos a parte 1, que foi criar o modelo meetup e adicionar os campos relevantes. Vamos
registrar as mudanças:

```bash
# raiz do projeto
./manage.py makemigrations meetups
> Migrations for 'meetups':
>  0001_initial.py:
>    - Create model Meetup
```

]

---

Saca só o meetups/migrations/0001_initial.py

```python
# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.db import migrations, models

class Migration(migrations.Migration):

dependencies = [
    ]

operations = [
        migrations.CreateModel(
            name='Meetup',
            fields=[
                ('id', models.AutoField(verbose_name='ID', serialize=False, auto_created=True, primary_key=True)),
                ('nome', models.CharField(max_length=128, verbose_name=b'Nome')),
                ('data', models.DateTimeField(verbose_name=b'Data/Hora')),
            ],
        ),
    ]
```

]

---

Dentro da migração tem tudo que o Django precisa para sincronizar nosso modelo
com o banco de dados.

Digita-ai:

```bash
# raiz do projeto
./manage.py migrate

> Operations to perform:
>  Apply all migrations: admin, auth, contenttypes, meetups, sessions
> Running migrations:
>  Applying auth.0001_initial... OK
>  Applying admin.0001_initial... OK
>  Applying admin.0002_logentry_remove_auto_add... OK
>  Applying contenttypes.0002_remove_content_type_name... OK
>  Applying auth.0002_alter_permission_name_max_length... OK
>  Applying auth.0003_alter_user_email_max_length... OK
>  Applying auth.0004_alter_user_username_opts... OK
>  Applying auth.0005_alter_user_last_login_null... OK
>  Applying auth.0006_require_contenttypes_0002... OK
>  Applying auth.0007_alter_validators_add_error_messages... OK
>  Applying auth.0008_alter_user_username_max_length... OK
>  Applying sessions.0001_initial... OK

```

Pronto, nosso banco agora tem um monte de tabelas, incluindo a tabela dos meetups.

]

---

# Criando meetups

Para não ficar muito longo, vamos criar alguns meetups via shell e depois mostrá-los
na nossa tela campeã.

```bash
# raiz do projeto
./manage.py shell
Python 2.7.12 (default, Jul  1 2016, 15:12:24) 
[GCC 5.4.0 20160609] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> 
```

Um shell python foi aberto. ooooh!

Agora, vamos importar o modelo dos Meetups. Digitai:

```python
from meetups.models import Meetup
meetup1 = Meetup()
```
]

---

Temos um objeto do tipo meetup no nosso shell.

Podemos fazer algumas coisas com ele, como assinalar valores para nome e data.

PS: temos que importar o pacote de data/hora para fazer tudo certim.

```python
from datetime import datetime
data_hora_do_meetup = datetime(2016, 9, 24)  # ano, mes e dia
meetup1.nome = u'Meetup da Python Triângulo'
meetup1.data = data_hora_do_meetup
meetup1.save()
```

Vocês podem construir quantos meetups quiserem.

É bem provavel que algo feio apareceu na sua tela, um RuntimeWarning. 
Não se preocupe, isso foi porquê passamos pro data um valor de data/hora sem informação de fuso-horário.

]

---

# Mostrando dados

Agora precisamos alterar nossa view para fazer o seguinte:

1. Consultar o banco de dados;
1. Apresentar os dados de forma "bonita" usando um template;

Vamos lá:

```python
# meetups/views.py
# coding: utf-8
from django.shortcuts import render
from django.http import HttpResponse
from .models import Meetup

def home(request):
    meetups = Meetup.objects.all()
    return render(request, 
                  'meetups/index.html',
                  {'meetups': meetups})

```

]

---

Se você tentar dar um reload na página agora, vai ocorrer um erro!

O template meetups/index.html non ecziste!

Vamos criá-lo

```bash
# diretorio raiz do projeto
mkdir -p meetups/templates/meetups
touch meetups/templates/meetups/index.html
```

Recarregue a página! Você verá uma bela página em branco.

Tudo bem, o Django agora encontrou o template em questão e conseguiu renderizá-lo.
Só está em branco pois o template está em branco. Vamos editá-lo.

]

---

```xml
<html>
 <head>
 <title>Meetups</title>
 </head>
 <body>
 <h1>Meetups</h1>
 {% for m in meetups %}

<h2>
 {{ m.nome }}
 {{ m.data }}
 </h2>
 <hr>
 {% endfor %}
 </body>
</html>
```

]

---

# E agora, José?
]

# http://djangoproject.com

]

---

# Dúvidas?
## Questionamentos?
### Esclarecimentos?

---

name: contatos
template: base
class: center
background-image: url(imagens/logo-sigma.png)

# George Rodrigues da Cunha Silva
#### george@sigmageosistemas.com.br
#### @georgersilva