Django Utilidades :: Marinho Brandao

Aprendendo Django no Planeta Terra

Acabo de colocar no ar o site Aprendendo Django no Planeta Terra [1].

Quem tem me acompanhado com uma certa regularidade sabe que eu valorizo muito a imagem, mas tenho evoluído nesse sentido.

Após mais de 2 anos usando o Django em projetos profissionais e brincadeiras pessoas, e participando da comunidade brasileira, especialmente, uma coisa se tornou muito clara pra mim: é preciso dar um passo mais ousado.

Eu cheguei a escrever um livro quase completo há 1 ano atrás e não gostei do resultado. Alguns amigos apontaram o que eu já sentia: o conteúdo estava burocrático e pesado, e precisava de um certo pragmatismo (obrigado Andrews).

Então, este é um livro eletrônico voltado para o iniciante. São capítulos curtos, liberados quase que diariamente, bem ilustrados e com uma linguagem que segue a história de um alienígena, me inspirando na série do Guia do Mochileiro das Galáxias.

É a história de um alienígena e seus dois amigos terráqueos, que estão aprendendo Django e se divertindo muito com isso. À medida que a história se desenrola, o framework é desmistificado e a pessoa vai aprendendo como resolver problemas e fazer boas sacadas no seu dia-a-dia.

Sou muito grato ao Luciano Ramalho [3], Guilherme Semente [4] e Felippe Nardi pelas dicas, ao João Matheus por suas ilustrações e ao Miltinho Brandão [2] pelas idéias, ouvido e amizade de sempre. E claro, não somente eles, todo o restante da comunidade brasileira [5], da World News Network [6] e dos desenvolvedores do Django Project [7].

Links relacionados

[1]	http://www.aprendendodjango.com/

[2]	http://miltonweb.wordpress.com/

[3]	http://ramalho.org/

[4]	http://semente.taurinus.org/

[5]	http://www.djangobrasil.org/

[6]	http://wnnetworks.com/

[7]	http://www.djangoproject.com/

Versão 0.6 do Yadsel com suporte a Django

Depois de um longo período apenas mantendo a estabilidade da versão atual, tirei ontem o dia para concluir os ajustes necessários para a versão 0.6 do Yadsel, com foco quase que exclusivo em projetos construídos com Django.

Ocorre que antes disso, o Yadsel trabalhava somente com versões de forma linear, ou seja: uma classe, uma versão.

Isso permaneceu até a versão 0.4, quando implementei o recurso de Extensible Versions (versões extensíveis) e Partial Versions (versões parciais). Essa versão inaugurou a idéia de poder ter várias classes em uma só versão. Melhorou na organização dos arquivos de versões e possibilitou trabalhar várias aplicações compartilhando uma mesma versão.

Mas ainda assim, outro recurso era necessário para o uso cotidiano no Django. No Django, as aplicações são independentes umas das outras, e ainda assim, podem haver eventuais dependências. Isso cria a necessidade de suporte a múltiplas versões em um mesmo projeto, ou seja: cada aplicação, uma versão. Para isso foi necessário implementar o Version Space.

Version Space

O Version Space é um recurso novo do Yadsel que torna possível que cada "espaço" no controle de versões possua sua própria versão, histórico e log. No caso do Django, o version space traduz-se pelo nome da aplicação, em outros aplicações, o desenvolvedor pode implementar como bem quiser.

Em outras palavras: eu posso manter uma aplicação de newsletter em diversos projetos com evolução de versões independentes do restante, incluindo toda a parafernália de DDL e DML que o Yadsel suporta: Tabelas, Domínios, Triggers, Procedures, Views, etc.

Yadsel no Admin

No embalo do Version Space veio o suporte ao Admin. É simples, ao instalar a aplicação 'yadsel.drivers.django_app' em seu INSTALLED_APPS, seu Admin passará a exibir duas seções para visualizar logs e históricos da evolução do banco.

Yadsel pelo manage.py

O Yadsel implementa um novo comando ao manage.py: yadseltool. A lógica de funcionamento é a mesma da yadseltool independente, porém seguindo a sintaxe de comandos baseados aplicações do manage.py:

$ python manage.py help yadseltool
Usage: manage.py yadseltool [options] [appname ...]

Executes Yadsel database version control for the given app name(s).

Options:
  --settings=SETTINGS   The Python path to a settings module, e.g.
                        "myproject.settings.main". If this isn't provided, the
                        DJANGO_SETTINGS_MODULE environment variable will be
                        used.
  --pythonpath=PYTHONPATH
                        A directory to add to the Python path, e.g.
                        "/home/djangoprojects/myproject".
  --traceback           Print traceback on exception
  --action=ACTION       Action of evolution; up=upgrade, down=downgrade
  --from=FROM
  --to=TO
  --mode=MODE           Mode of output; hidden=messages are hidden, steps=step
                        by step, interactive=confirms actions, output=only
                        prints to output
  --test=TEST           Set test mode
  --history=HISTORY     Write history of versions
  --silent=SILENT       Keeps exception messages
  --log=LOG             Write a log of changes
  --version             show program's version number and exit
  -h, --help            show this help message and exit

Exemplo de chamada do yadseltool

$ python manage.py yadseltool minha_aplicacao

Mas como afinal utilizar o Yadsel em meu projeto Django?

Bom, primeiro é necessário baixar a versão 0.6 do Yadsel em sua máquina

http://yadsel.googlecode.com/files/yadsel-0.6-with-django-support.tar.gz

Feito o download, instale o Yadsel numa versão 2.4 ou superior do Python

$ python setup.py install

Em seu projeto, acrescente a seguinte aplicação à setting INSTALLED_APPS do arquivo settings.py

'yadsel.drivers.django_app'

Rode o syndcb

$ python manage.py syncdb

Serão criadas as duas tabelas necessárias para o histórico e log do Yadsel. Entenda que 'histórico' trata-se do controle das versões, é ele que sabe se sua aplicação está na versão X ou Y. O 'log' trata-se de cada comando SQL que é gerado e executado, assim como suas respectivas eventuais mensagens de erro.

Crie a seguinte estrutura de pastas em uma de suas aplicações:

minha_aplicacao/
minha_aplicacao/yadsel_versions/
minha_aplicacao/yadsel_versions/__init__.py
minha_aplicacao/yadsel_versions/versao1.py
minha_aplicacao/yadsel_versions/versao2.py
minha_aplicacao/yadsel_versions/versaoN.py

o arquivo __init__.py deve conter ou importar as classes de versões, que podem ser estruturadas como bem quiser, seja em módulos ou em pacotes.

O conteúdo provável do arquivo __init__.py será este:

from versao1 import *

E o do arquivo versao1.py (ou qualquer outro que contenha classes de versões) será provavelmente este:

from yadsel.core import *

class Version1(Version):
    version_number = 1

    def up(self):
        pass

    def down(self):
        pass

ou como este exemplo:

from yadsel.core import *

class MinhaVersao1(Version):
    version_number = 1

    def up(self):
        CreateTable('minha_tabela_nova',
            id = Integer(primary=True)
            name = Varchar(50, required=True),
        ).append_to(self)

        AlterTable('states',
            Add('percent', Decimal(15, 5, default=0)),
        ).append_to(self)

        ExecuteSQL("""
            Create or Alter Procedure sp_teste...
        """).append_to(self)

    def down(self):
        ExecuteSQL("""
            Drop Procedure sp_teste
        """).append_to(self)

        AlterTable('states',
            DropColumn('percent'),
        ).append_to(self)

        DropTable('minha_tabela_nova').append_to(self)

A minha sugestão é que se use o Yadsel no Django somente para manter a evolução, não para criar tabelas em si. Isso porque o Django o já cria as tabelas muito bem. O que ele não faz é o resto :D

VivixVideo no ar!

Bom, como devem ter notado, tenho estado ausente até mesmo nas conversas de Google Talk e na lista de discussão.

Também não é por menos, passo atualmente por três lançamentos de peso onde tenho a resposabilidade técnica de fazer acontecer. É prazeroso, mas ao final do dia tudo o que eu quero é a família, e assim tem sido.

A última grande novidade que tenho para vocês é o VivixVideo [1], um site bilíngue para agregação de vídeos totalmente baseado nos conceitos da web2.0: o usuário faz o site, em quase todas as formas da palavra, e os planos levam em consideração a amplitude dessa filosofia: teremos em breve uma área de desenvolvimento onde será possível publicar tickets e participar da construção do site até onde for possível essa interação.

A criação levou pouco mais de 2 meses, contando com uma equipe de 5 pessoas em seu tempo extra-expediente, mas com muita boa vontade, as previsões de prazo foram cumpridas com algumas gordurinhas a mais trasformada em recursos adicionais.

O lançamento conta com premiações e possibilidades de lucro por parte dos participantes, e os planos para novidades são ousados.

Django

A versão utilizada do Django é a 0.97-newforms-admin [2], a versão do Python é 2.5, com Apache, mod_python e Fedora Gnu/Linux.

Aplicações externas

Dentre os recursos extra utilizados, pelos quais somos gratos, destacam-se:

django-diario [3]
django-forum [4]
django-tagging [5]
django-ads [6]
django-microformats [7]
djapian [8]
django-plus [9]
ajax many2many widget [10]
jQuery [11]
jQuery auto-complete plugin [12]
yadsel [13]

Equipe

A equipe, que está parabéns pelos resultados é composta por:

Márcio [14]
Marcos Freitas [15]
Mariana Queiroz [16]
Marinho Brandão [17]
Miltinho Brandão [18]

Links relacionados

[1]	http://vivixvideo.com/

[2]	http://code.djangoproject.com/wiki/NewformsAdminBranch

[3]	http://code.google.com/p/django-diario

[4]	http://code.google.com/p/django-forum

[5]	http://code.google.com/p/django-tagging

[6]	http://code.google.com/p/django-ads

[7]	http://code.google.com/p/django-microformats

[8]	http://code.google.com/p/djapian

[9]	http://code.google.com/p/django-plus

[10]	http://django-plus.googlecode.com/files/ajax_m2m_widget.rar

[11]	http://jquery.com

[12]	http://code.google.com/p/jquery-autocomplete/

[13]	http://code.google.com/p/yadsel

[14]	http://vivixvideo.com/u/editor/

[15]	http://vivixvideo.com/u/marcosfreitas/

[16]	http://vivixvideo.com/u/Mariana/

[17]	http://vivixvideo.com/u/marinho/

[18]	http://vivixvideo.com/u/miltinho/

Site da DjangoBrasil no ar!

Neste final de semana, a revista Info [1] edição de dezembro chegou à casa dos assinantes com a matéria sobre o Django, Ruby on Rails e outros frameworks ágeis. Eu ainda não tive a oportunidade de lê-la (quero fazer isso na segunda-feira) mas pelo que o Ítalo Maia [6] indicou, a matéria ficou bacana e destacou os pontos fortes dos frameworks analisados - e parece que o Django se saiu bem :)

Agora a notícia que já veio no mesmo pacote foi o lançamento do site da nossa comunidade no endereço oficial [2], anunciado [3] pelo Semente. É muito importante exaltar o trabalho que o Semente (na programação e configuração), o Jader Rubini [4] (no design) e o Jean Rito (criador do domínio) fizeram pelo site, como principais expoentes, assim como agradecer ao pessoal da PyTown [5] por ceder a hospedagem e apoiar a comunidade, e ao restante do pessoal que participou.

Agora nosso desafio é exatamente suprir nos pontos que o Django não está forte: documentação em língua portuguesa, o que vai ser de bom grado para o conteúdo do site.

No mais, só parabenizar e agradecer!

Links relacionados

[1]	http://info.abril.com.br/

[2]	http://www.djangobrasil.org/

[3]	http://groups.google.com.br/group/django-brasil/browse_thread/thread/c8c5c204986a7405

[4]	http://jaderubini.wordpress.com

[5]	http://pytown.com/

[6]	http://eusouolobomal.blogspot.com/

Projetos brasileiros

Um dia desses eu e o Andrews [1] estávamos papeando sobre a nossa ânsia de ajudar na comunidade. Ela sem dúvida é muito maior do que a nossa condição real para isso, afinal, a Tarsila [2] e a Larissa são ainda mais importantes e as esposas também.

Ainda assim, é perceptível a saúde da comunidade: é fácil notar ao menos 4 ou 5 líderes naturais na comunidade tomando a iniciativa e buscando evoluir, cada qual do seu jeito, evidentemente. Estamos nos preparando para o lançamento do site oficial [3] e com uma ousada meta para dobrar, triplicar ou até aumentar em dez vezes o nosso número - em um ano. É possível.

Nem todos os esforços são destacados: às vezes um bocado de artigos ou alguns projetos tocados podem aparecer mais do que outros esforços que são feitos para moderar, manter documentação, responder os colegas, criar snippets, criar screencasts... enfim, cada um contribui da maneira que se sente melhor e a coisa vai andando.

Mas eu quero destacar aqui hoje alguns projetos brasileiros bacanas - e seguramente eu posso ter passado em branco por algum ou talvez até não tenha conhecimento de outros, pois eles crescem rapidamente:

Djapian [4]

Projeto criado pelo Rafael SDM Sierra [10]. É o que eu mais gostei até agora na comunidade: utiliza do Xapian [11] para fazer buscas full-text em bancos de dados.

Yadsel [5]

Criado por mim, está começando a ganhar corpo, com o uso de outras pessoas fora eu e meu emprego [12]. É uma biblioteca que inclui uma API e ferramentas para evolução e regressão de bancos de dados, se baseando em drivers para cada SGBD ou ORM.

django-diario [6]

Criado pelo Semente, é uma aplicação plugável de blog. Idéia muito bem sacada: você baixa, coloca no seu projeto e pronto!

django-durus [7]

Criado pelo Andrews Medina [1], este também é muito interessante. É uma interface para acesso ao SGBDOO Durus [13], que acredito que será incorporado como backend oficial no futuro.

django-zodb

Também criado pelo Andrews Medina [1], este é semelhante ao django-durus mas para o SGBDOO ZODB [14]. Ainda não foi disponibilizado.

bingo [8]

CMS (sistema de gestão de conteúdo, como o WordPress [15] ou Joomla [16]) criado pelo Andrews Medina [1], que ainda não foi disponibilizado.

django-gadgets [9]

Criado por mim, já está na versão 1.0 (suporte completo à API). Útil para a criação de Gadgets para o iGoogle, Google Desktop, OpenSocial [17], Orkut, MySpace, Ning, Hi5, etc.

Seria injusto destacar esses projetos e não destacar o aclamado snippet do Rodrigo Senra [18] sobre classes de modelo dinâmicas, que pode ser encontrado em [19]. Outro destaque ainda deve ser dado ao field DateTimeField [20] de autoria do Andrews Medina e aos LocalFlavors brasileiros [21], que agora não me recordo o nome do autor.

Você pode ainda encontrar outros dando uma navegada por aqui: [22].

Até a próxima!

Links relacionados

[1]	(1, 2, 3, 4) http://pyman.blogspot.com/

[2]	http://www.flickr.com/photos/marinho/tags/tarsila/

[3]	http://www.djangobrasil.org/

[4]	http://code.google.com/p/djapian/

[5]	http://code.google.com/p/yadsel/

[6]	http://code.google.com/p/django-diario/

[7]	http://code.google.com/p/django-durus/

[8]	http://code.google.com/p/bingo/

[9]	http://code.google.com/p/django-gadgets/

[10]	http://blog.stiod.com.br/

[11]	http://www.xapian.org/

[12]	http://www.tron.com.br/

[13]	http://www.mems-exchange.org/software/durus/

[14]	http://www.zope.org/Wikis/ZODB

[15]	http://wordpress.org/

[16]	http://joomla.org/

[17]	http://code.google.com/apis/opensocial/

[18]	http://rodsenra.vox.com/

[19]	http://www.djangosnippets.org/snippets/314/

[20]	http://code.djangoproject.com/browser/django/trunk/django/db/models/fields/__init__.py

[21]	http://code.djangoproject.com/browser/django/trunk/django/contrib/localflavor/br

[22]	http://code.google.com/hosting/search?q=label:django

Matéria na revista Info

Bom, agora que voltamos à ativa, vamos botar esse blog aqui pra ferver.

O primeiro destaque que quero dar é à matéria que será publicada sobre o Django na revista Info [1] do mês de dezembro/2007. Quem está elaborando é a simpática Cibele Gandolpho. Esta matéria terá foco no potencial da ferramenta para oportunidades profissionais.

Criamos um tópico [2] no grupo com o objetivo de movimentar a comunidade em prol de dar a ela informações como cases de negócio e profissionais.
O tópico surpreendeu até a nós que estamos vivenciando o crescimento do framework dia-a-dia. Só para se ter uma idéia, o Django Sites [3] publicava ontem 826 sites criados com Django, hoje no momento em que escrevo este, já são 833, e por lá ainda não constam vários sites publicados, como este blog e o YAH [4]. Também não costam trabalhos de acesso restrito, que são cada vez mais numerosos.

Agora fica o pedido: se você têm informações a acrescentar ao tópico para informações sobre o Django no Brasil, como cases e trabalhos experimentais, ou oportunidades de trabalho e negócio, dê uma passada por lá. Basta dizer que esta é a primeira atenção que o Django recebe da mídia abrangente nacional e isso tem vital importância para a ferramenta em nosso país.

Links relacionados:

adorador.es 0.2 no ar

A nova versão do adorador.es [1] está no ar. Demorou, afinal a Tarsila [2] tem sido bem exigente nas últimas semanas, e a qualidade também. A nova versão oferece, além de ajustes gerais para várias funcionalidades, o suporte a comunidades [3], o que já coloca o site em pé de igualdade com o Orkut [4], e posiciona o sistema para a próxima atualização, que focará recursos em Ajax, especialmente o novo editor XHTML, publicação de videos, bookmarks, nova ferramenta para publicação de fotos, planeta, mashup na página central [5] e outros recursos, além de ter a busca customizada [6] mais enriquecida com sites bons de contéudo, e possibilidade para customizar mais a página externa :) A migração do banco foi feita com o DBMigrations [7], que segurou muito bem o tranco. Agora vamos torcer para o DreamHost [8] ajustar a instabilidade recente do meu servidor, aí vai ficar perfeito! PS: como hoje nosso foco é o desenvolvimento dos recursos para a versão 1.0, não temos feito esforços de marketing, mas já estamos iniciando negociações de parceirias e teremos algumas novidades para os membros (não muito diferentes das do Secundum [9] e do Via6 [10]), à medida que os recursos forem implementados. Links relacionados:

Primeiro grande case de Django no Brasil

O primeiro grande projeto brasileiro em Django saiu do forno: o Favoritos do Garimpar é todo construído em Django e pelo que eu entendi de uma conversa com um dos criadores, os outros projetos da empresa também o são. Pra quem não conhece, a Garimpar tem objetivos ousados, que é oferecer sistema de buscas de notícias e redes sociais de forma ainda mais aprofundada que o que é hoje feito pelo Google e pelo Yahoo. Eu mesmo já troquei o del.icio.us pelo Garimpar, já que ele oferece as mesmas vantagens e algumas mais. Ponto pra internet brasileira, e ponto para o Django, que começa a se firmar.

Proposta de Layout para o Django Brasil

Proposta de Layout para o Django Brasil
Originally uploaded by Marinho Brandão.

uma das propostas que enviei para o grupo Django Brasil avaliar :)

está bombando xD

Proposta de Logo para o Django Brasil

Proposta de Logo para o Django Brasil
Originally uploaded by Marinho Brandão.

A intenção é passar a idéia das tags, da marca (Django Brasil) e das cores nacionais, em conjunto com a maca do Django