Tutorial Django

Neste tutorial voc aprender a instalar e configurar o Django, alm de praticar atravs de um
exemplo.

Instalando no Windows
Baixe e instale primeiramente o Python (http://www.python.org/download/).
A instalao simples execute o arquivo baixado clique em Next e escolha o diretrio em que
o python ser instalado. Ex.: C:\Python27\.
Voc deve apenas se preocupar em configurar o python na varivel de ambiente para que o
sistema possa reconhec-lo automaticamente. Para ter acesso a varivel de de ambiente
aperte as teclas Windows + Pause (a tecla Windows a tecla com o logotipo do windows).
Janela Propriedades do sistema, clique na aba Avanado e em seguida no botoVariveis de
ambiente.

Na caixa Variveis do sistema clique sobre a varivel com nome path e clique emeditar.

Na janela editar varivel de sistema edite a linha valor da varivel adicionando o caminho do
diretrio de instalao do python. Supondo que voc instalou em C:\Python27\adicione
;C:\Python27\ no final da linha.

Aps esta etapa o python j estar instalado e configurado.

Agora vamos a instalao do Django que voc pode baixar
emhttp://www.djangoproject.com/download/.
Ao baixar o arquivo ele vem com a extenso tar.gz, a maioria dos descompactadores mais
novos j suportam esta extenso, mas se o seu no suporta voc pode baixar o 7-zip
(http://www.7-zip.org/) que tambm um software livre.
Descompacte o arquivo onde quiser.
Dentro da pasta onde voc descompactou crie um arquivo e chame de instalar.bat, edite
usando o bloco de notas e digite:

python setup.py install

pause
Salve, feche o arquivo e execute.
Feito isso, o Django estar instalado.

Ateno: talvez no seja necessrio o passo a seguir. Verifique se sua verso do python j
possui a biblioteca pySQLite.
Agora vamos seguir para o ltimo passo: instalar a biblioteca do banco de dados SQLite. O
SQLite um banco de dados simples, sem muitos recursos. ideal para o ambiente de criao
e desenvolvimento. No d pra fazer muitas coisas com ele, mas voc dificilmente vai precisar
de fazer muitas coisas enquanto cria seu site.
Para o Django trabalhar em conjunto com o SQLite, preciso apenas instalar uma biblioteca,
chamada pySQLite, e nada mais. Ento, v at a pgina seguinte e faa o download do tarball
(cdigo-fonte, com extenso .tar.gz).http://oss.itsystementwicklung.de/trac/pysqlite/#Downloads.
Se a instalao do pySQLite apresentar erros de compilao no Windows, tente instalar com
um dos instaladores executveis disponveis na pgina de download acima. Isso s vezes
ocorre por consequncia de algum tipo de incompatibilidade entre compiladores.
Aps o download, faa o mesmo que fez com o Django:
1. descompacte usando o 7-zip
2. crie o arquivo instalar.bat com aquele mesmo cdigo dentro
3. execute
4. pronto.
Agora voc tem um ambiente de desenvolvimento instalado para comear a usar.

Instalando no Linux
Geralmente no linux j vem o Python e o PySQL instalados.
Desta maneira apenas necessrio instalar o Django executando o seguinte comando no
diretrio onde est o arquivo Django-1.2.3.tar.gz:

tar xzvf Django-1.2.3.tar.gz

cd Django-1.2.3
sudo python setup.py install
Pronto!
Neste tutorial desenvolvemos com Django na IDE Eclipse (http://www.eclipse.org/downloads/).
Para utilizar o Django na IDE Eclipse necessrio baixar o plug-in Pydev, voc pode fazer isso
utilizando o prprio eclipse.
Abra o eclipse utilize o menu Help>Install New Software...
Na janela install clique no boto Add...
Na janela Add Site digite o nome: PyDev e Location: http://pydev.org/updates

Dever aparecer duas opes:

Marque a caixa de seleo PyDev e espere o download e configurao do plugin.

Aps isto voc ter um ambiente de desenvolvimento Django e poder utilizar a IDE Eclipse
para programar.
Agora vamos prtica...

Criando uma Agenda

Criando um projeto com Administrador
Aps configurado o eclipse, vamos criar um projeto Django, clique em novo e escolha a opo
PROJECT, depois escolha a opo Django Project e NEXT.

Depois iremos dar um nome ao projeto, que iremos chamar de Agenda, iremos escolher a
verso do Python, ou a verso 2.6 ou 2.7, a 3.0 no compatvel com o Django 1.2, agora
NEXT.

Por ltimo iremos escolher a verso do Django o banco de dados que iremos usar. Vamos
usar a verso 1.2 do Django e vamos usar o Sqlite3 para modelar o banco, pois mais simples
de usar para esse exemplo.

Agora basta da um clique em FINISH e o eclipse vai criar uma estrutura iqual a essa.

Vamos em Run, ento o eclipse ir executar o servidor do Django, par ver se esta tudo correto
abra um Browser (Firefox, Chrome. Etc) e vamos digitar o endereo http://localhost:8000/ e
iremos ver a seguinte pgina.

Agora vamos habilitar a pgina do administrador do Django, vamos em settings.py, primeiro

procure por LANGUAGE_CODE = 'en-us' e mude para LANGUAGE_CODE = 'pt-br',
assim nossa pgina adminstrador do Django ser em portugus.
Procure por 'django.contrib.admin', dentro de INSTALLED_APPS e descomete essa
linha apagando o #, preste ateno para que essa linha siga a identao das demais. Feito
isso vamos em urls.py e descometamos essas duas
linhas, from django.contrib importadmin e admin.autodiscover(), e
depois descometamos (r'^admin/',include(admin.site.urls)),.

Agora hora de usarmos o comando syncdb para sincronizar os dados da

aplicao com o bando e gerar as tabelas do mesmo, vamos da um clique com
o boto direito do mouse em Agenda e escolher Django -- > Sync DB. Com isso
vamos criar as tabelar referente a pagina administrador do Django e vamos
criar um superusurio com nome, e-mail e senha, lembre-se desses dados
para os prximos passos. Depois de executado podemos notar que um arquivo
foi adicionado na pasta src, esse arquivo o nosso banco.

Vamos rodar nosso projeto outra vem em RUN e recarregar nossa pagina, se
tudo foi feito certinho at agora vamos ver esse erro:

Esse erro ocorreu porque agora temos uma pgina e s usamos a url do
servidor, vamos agora tentar entrar nessa url: http://localhost:8000/admin/ e
voc ver essa pgina:

Aps o login entraremos nessa pgina:

Adicionando uma aplicao com Template

Para adicionar uma aplicao vamos da um clique com o boto direito do
mouse em Agenda-->Django-->create application, vamos dar o nome de
contato a nossa aplicao, depois de aperta OK, vai ser criado uma pasta com
o nome contato e quatro arquivos dentro. Vamos agora criar a classe que vai
definir nosso contato, abra o arquivo models.py, nesse arquivo vamos definir
todas as entidades que sero usadas na aplicao contato, edite o arquivo
models.py at ficar assim:

Acabamos de criar uma classe Contato que herda da classe Models e tem os
atributos nome, fixo, cel e endereco como campos de caracteres(CharField)
com o tamanho especificado no parmetro e um atributo email com um campo
de e-mail(EmailField).
Vamos fazer com que nossa aplicao se torne parte do nosso sistema, para
que isso ocorra vamos abrir novamente o settings.py e adicionar contato no
INSTALLED_APPS:

Agora s rodar o camando SYNC DB que j usamos antes e vamos ver mais
uma tabela sendo criada, vamos ento fazer com que nossa pagina de
administrador possa interagir com a entidade que criamos, para isso dentro da
pasta contado crie um arquivo com o nome admin.py e edite esse arquivo at
ficar assim:

Vamos rodar o servidor e ir ver a pagina do administrador, la veremos que

Contato j faz parte da nossa pgina, e temos a opo de adicionar um contato
e modificar um contato existente.

Clique em adicionar e vamos criar um contato, preencha os dados e clique em

salvar, note que o Django j faz tratamento de erro caso voc coloque um email no valido. Aps criar um contado vamos ver que ele vai aparecer em uma
lista.

Note que o objeto esta com o nome Contato object, e isso no interessante.
Para mudar isso vamos em models.py para criar uma funo que vai retorna o
nome do contato.

Recarregando a pagina aps a modificao veremos que agora aparece o

nome do contato.

J hora de usarmos templetes para a nossa aplicao, dentro da pasta

Agenda vamos criar uma outra pasta com o nome templates, depois de
fazermos isso dizer ou Django onde esta esta pasta, para isso abra o
settings.py e acrescente esse import em destaque como mostra na figura, ele
importa o os para facilitar na hora de pegar o endereo da pasta onde esta o
projeto.

Com o import feito, vamos adicionar mais uma mudana no settings.py, s que
dessa vez em TEMPLATE_DIRS adicionando o caminho da pasta templates como
na figura.

Criando um Template
Crie um arquivo com o nome base.html, ele nosso HTML esttico que ser usado
pelos outros HTMLs. Edite-o para que fique assim.

Com essas tags {% block content %}{% endblock %} podemos enviar dados do
Django que ser transformado em HTML.
Agora dentro da pasta templates criaremos outra pasta com o nome contato, nesta
pasta ficar todas os HTMLs de contato, dentro dela vamos criar um arquivo com o
nome list.html, vamos us-lo para listar os nossos contatos. Antes de editar esse
arquivo precisamos criar a funo que vai passa a lista dos contatos para o HTML, abra
o views.py e edite-o assim:

Estamos importando a classe Contato que criamos no models.py e importando funes

do Django para redirecionar os dados para um HTML. No comeo da funo criamos a
varivelcontatos e atribumos a ela todos os contatos, e estamos retornando uma reposta
com o endereo do arquivo list.html que criamos antes e a varivel contatos.
Precisamos agora criar a url que ir chamar essa funo, ento vamos em urls.py e
adicionamos a seguinte linha como mostra a figura.

Assim criamos um url contato/listar com o endereo da funo que criamos antes, j
hora de editarmos o list.html, vamos deixar o arquivo desse jeito:

A gora temos um HTML que vai receber a varivel contatos e vai exibir a lista de
contatos, podemos perceber que na primeira linha estamos estendendo a base.html e
juntando com o list.html, o block content de list.html vai substituir o block
content da base.html.
Depois de salvar tudo vamos rodar o projeto para ativar o servidor e vamos acessar a
pgina http://localhost:8000/contato/listar, e se tudo der certo vamos ver a lista de
contatos que voc cadastrou na pgina do administrador.
Usando Genricos
Vamos usar agora as funes genricas do Django para criar e editar um contato. J
podemos fazer isso atravs da pgina do administrador, mais vamos fazer isso usando
template. Vamos abrir o urls.py e vamos acrescentar mais duas urls, uma para editar e
outra para criar, vamos deixar o urls.py assim.

Primeiro importe Contato como mostra na segunda linha, ento vamos fazer a url criar
que tem como parmetro a funo genrica create_object , e depois passamos o
modelo de Contato, o template que vai ser usado e o endereo que vai ser redirecionado
depois de salvo. A url editar bem parecida com a url criar, mais com algumas
diferenas, a primeira esse parte do endereo (?P<object_id>\d+) que tem a
funo de pegar o id do objeto que ser editado, e a segunda a funo genrica que
dessa vez a update_object.
J temos as urls, falta agora criar o arquivo generic_form.html que usamos como
parmetro. Os genrico devem ser usador por todas as aplicaes, ento vamos criar
esse arquivo dentro da pasta templates, depois de criado vamos edit-lo da seguinte
forma.

Agora podemos rodar o projeto e criar novos contatos e editar os j existentes.