Muitas pessoas vêm para o Django de diversos outros frameworks. Outras não passaram por outros frameworks, mas já possuem alguma (ou muita) experiência com o universo do Linux, Python e Software Livre.

Entretanto, há um grupo cada vez maior de pessoas que estão conhecendo o Django a partir do nada, ou partindo de linguagens de paradigma muito diferente, como Delphi, Visual Basic, Java ou PHP.

Essas pessoas são muito bem-vindas ao framework, mas muitas vezes começam sem uma definição clara de como a coisa funciona no geral, e normalmente o que elas mais enfrentam é uma quantidade muito grande de quebra de paradigmas e novidades, o que acaba deixando qualquer um sem um chão firme onde pisar.

É por isso que resolvi fazer esse tutorial sobre iniciar no Django, usando DjangoStack.

Bitnami DjangoStack

O Bitnami é projeto que viabiliza instaladores passo-a-passo completos para algumas ferramentas.

Lembra-se do conceito de “LAMP” (Linux + Apache + MySQL + PHP)? Pois é, em cima dessa idéia, surgiram diversas variantes: o WAMP, por exemplo, é um dos mais populares.

O DjangoStack é a mesma idéia do LAMP; você pega um só instalador, executa, ele abre uma janela e passo por passo você instala e configura seu primeiro projeto em Django, incluindo todo o ambiente que precisa para aprender e desenvolver: Python, Apache, MySQL e SQLite.

Download e versões disponíveis

Primeiro de tudo, é preciso baixar o instalador. Ele está disponível para Linux, Windows e MacOSX (plataformas Intel e PowerPC). Portanto, vá até a página de download e escolha a versão desejada:

http://bitnami.org/stack/djangostack

Obs: Devido à procura ser maior em torno do Windows, este tutorial será feito usando o Windows como base.

Instalação

Após fazer o download (em torno de 38MB), execute o arquivo de instalação.

Na janela exibida, clique em “Next” para continuar (mantendo os valores padrão) ate que a seguinte pergunta seja feita:

“Please configure your Django project“

Informe “meu_projeto“. Deixe o SQLite marcado como banco de dados do projeto e siga adiante.

Na janela a seguir, apenas clique no botão “Next” para iniciar a cópia de arquivos.

Obs: numa próxima vez você poderá informar com mais calma os valores da configuração, modificando de acordo com sua preferência. Entretanto, este tutorial é feito com base nos valores padrão.

Ao final da instalação, o Apache e o MySQL serão iniciados e a página inicial será exibida no seu navegador padrão.

A janela exibida pelo navegador mostrará uma introdução e um link no meio, em letras garrafais: “Access Your Project“.

Clique no link para visualizar seu projeto em Django rodando pela primeira vez.

Primeiro projeto

Se achou tudo fácil demais até aqui, não fique em dúvida, o Django é fácil mesmo, mas agora começa a parte divertida.

Abra agora no Explorer o caminho de instalação do DjangoStack (“C:\Arquivos de programas\BitNami DjangoStack“).

Com a janela aberta, abra a pasta “projects” e em seguida “meu_projeto“. Os arquivos contidos nessa pasta são os arquivos criados para o seu projeto.

A primeira aplicação

Agora vamos criar uma pequena aplicação de Anotações.

Crie uma pasta chamada “anotacoes” e dentro dela os arquivos vazios: “__init__.py” e “models.py“.

Agora abra o arquivo “models.py” para edição (pode ser no Bloco de Notas ou em algum outro editor de texto de sua preferência) e dentro, digite as seguintes linhas:

from datetime import datetime
from django.db import models

class Anotacao(models.Model):
    titulo = models.CharField(max_length=50)
    texto = models.TextField()
    data_hora = models.DateTimeField(default=datetime.now, blank=True)

    def __unicode__(self):
        return self.titulo 

Configurando as settings do projeto

Agora na pasta superior – a do projeto – edite o arquivo “settings.py” e acrescente as seguintes linhas no início do arquivo:

import os
PROJECT_ROOT_PATH = os.path.dirname(__file__)

Localize a setting “DATABASE_NAME” e modifique para ficar desta forma:

DATABASE_NAME=os.path.join(PROJECT_ROOT_PATH,'meu_projeto.db')

Localize a setting “ADMIN_MEDIA_PREFIX” e modifique para ficar desta forma:

ADMIN_MEDIA_PREFIX = '/admin_media/'

Agora por fim, localize a setting “INSTALLED_APPS” e modifique para ficar desta forma:

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.admin',
    'anotacoes',
)

Configurando as URLs do projeto

Após fechar e salvar, edite na mesma pasta o arquivo “urls.py” e modifique para ficar desta forma:

from django.conf.urls.defaults import *

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^admin/(.*)', admin.site.root),
)

Modificações feitas, agora precisamos criar o banco de dados, mas, pra isso, será preciso fazer algumas coisas antes.

Ajustando o ambiente de desenvolvimento

Quando se instala o Python no Windows, este deve ser adicionado à variável de ambiente PATH para que o comando “python” seja encontrado de qualquer caminho. Portanto, pressione as teclas “bandeira+Pause” para acessar a janela de “Propriedades do Sistema“, e vá até a aba “Avançado“, clicando no botão “Variáveis de Ambiente“.

Na caixa “Variáveis do sistema“, localize o item “Path” e clique duas vezes. Será exibida outra janela, e no campo “Valor da variável“, adicione ao final “C:\Arquivos de programas\BitNami DjangoStack\python“. Feche todas as janelas clicando em “Ok“.

Gerando o banco de dados

Pronto, agora voltemos à janela do Explorer, posicionado na pasta do projeto. Vamos criar ali um batch para a geração do banco de dados.

Crie um arquivo chamado “criar_banco_de_dados.bat” e digite dentro as seguintes linhas:

python manage.py syncdb
pause

Feche o arquivo salvando e clique duas vezes sobre ele.

Uma janela do DOS será exibida gerando as tabelas no banco de dados. Responda as perguntas assim:

• Would you like to create one now? (yes/no): yes
• Username: admin
• E-mail address: seu_email@dominio.com
• Password: 1
• Password (again): 1

Configurando o Apache

Agora é necessário ajustar as configurações do Apache para que seu ambiente de desenvolvimento possa executar o que precisa.

Na janela do Explorer, vá até a pasta “C:\Arquivos de programas\BitNami DjangoStack\apps\django\conf” e edite o arquivo “django.conf” modificando para ficar desta forma:

<location '/'>
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    PythonPath "['C:\Arquivos de programas\BitNami DjangoStack/projects/', 'C:\Arquivos de programas\BitNami DjangoStack/projects/meu_projeto'] + sys.path"
    SetEnv DJANGO_SETTINGS_MODULE meu_projeto.settings
    PythonDebug On
</location>

Alias /admin_media "C:\Arquivos de programas\BitNami DjangoStack\apps\django\django\contrib\admin\media"

<Location "/admin_media">
    SetHandler None
</Location>

Por motivos de performance, um projeto feito em Django não aplica as modificações recebidas automaticamente. É preciso reiniciar o Apache para que elas façam efeito.

O DjangoStack não ativa o ApacheMonitor na inicialização do Windows. Portanto, é preciso que você faça isso.

Na janela do Explorer, vá até a pasta “C:\Arquivos de programas\BitNami DjangoStack\apache2\bin” e clique duas vezes no arquivo executável “ApacheMonitor.exe“. Será exibido um novo ícone na bandeja, ao lado do relógio do Windows.

Obs: é recomendável que você crie um atalho do ApacheMonitor para iniciar automaticamente com o Windows, pois assim terá menos trabalho quando precisar reiniciar o Apache.

Agora clique sobre o ícone da bandeja, selecione o serviço do Apache e escolha a opção “Restart” para reiniciar o apache.

Após aguardar alguns segundos, vá até o seu navegador e carregue a URL: “http://localhost/admin/“. O usuário é “admin“, e a senha é “1“.