Como novato querendo aprender a mexer em Python, vou relatar aqui meus progressos.  Basicamente o objetivo é anotar para eu mesmo me lembrar, mas se puder ajudar a mais alguém, sem dúvida será bom.

Enfim, chega de papo.  Estou montando uma solução para criação e transferência de arquivos compactados entre dois hosts.  Eu poderia implementá-la em Java, Shell ou mesmo PHP sem problemas, mas optei por Python justamente para me forçar a aprender um pouco mais.

A primeira coisa que precisei foi apenas criar arquivos zip.  Em Python é bastante simples:

>>> import zipfile.ZipFile
>>> meuzip = ZipFile('arquivo.zip', 'a')
>>> meuzip.write('conteudo.txt')
>>> meuzip.close()

Neste código, ZipFile é a classe que manipula arquivos compactados, arquivo.zip é o nome do arquivo no qual os demais serão adicionados (neste caso, apenas o arquivo conteudo.txt que está no mesmo diretório).  O segundo parâmetro do construtor da classe (‘a’ppend) é um flag bem no estilo dos flags de manipulação de arquivos em C.

Ao fechar o arquivo depois de gravar, se você vir o diretório corrente, lá já estará o arquivo.zip recém-criado.

Simples, não!?  E o que é melhor: nada dos chatos streams de Java.

Para mais informações, não deixe de ler a documentação do módulo zipfile do Python.

Em algum tempo remoto, exploradores perdidos numa excursão ao Himalaia fizeram uma descoberta surpreendente.  Num ambiente peculiar dentro de uma antiga caverna, encontraram, entre outras coisas, um inusitado livrinho velho e desgastado, contendo dizeres de sabedoria ancestrais.  Ao longo dos tempos, tais ensinamentos perduraram e, qual a surpresa ao ver-se que ainda podem ser diretamente aplicados até em ambientes de desenvolvimento de software modernos.

Você confere uma réplica (recuperada, digitalizada e agora traduzida para o português) deste pequeno livrinho, intitulado “A Maneira de Testivus”, para download aqui.  Você pode ver mais referências sobre este antigo livrinho aqui.

Boa leitura!

Logo do evento

Acontecerá entre 9 e 12 de julho em Berlin, na Alemanha, o maior evento da comunidade CakePHP mundial: CakeFest 2009.

A programação já está disponível, mas até o dia 17 de abril ainda é possível submeter sua proposta de palestra ao evento.

Ajude a divulgar o CakeFest Berlin 2009 você também, e ainda concorra a uma inscrição de graça no evento!

Nos vemos em Berlin!

O canal Discovery Channel comemora 15 anos no ar de muitos documentários, conteúdo científico, informativo, curiosidades e programas educativos.  Entretenimento inteligente garantido!  Mas não dediquei um post de meu blog a isso, mas sim à sensacional vinheta que vem sendo vinculada pelo canal: uma declaração de amor ao mundo, à diversidade e ao conhecimento.  Uma verdadeira ode à tudo que a vida tem de bom!  Um comercial simples, instigador, divertido e muitíssimo agradável!  Particularmente, me desperta bons sentimentos (e até uma pontinha de nostalgia!).

Confira o vídeo abaixo!

E a letra da música:

Eu amo a Terra
Todo o azul do mar
Pontes incríveis
Ver tubarão saltar.

Eu amo o mundo
Tudo o que nele há
Boom, de ya da. Boom, de ya da. (bis).

Eu amo as ondas
Eu amo me sujar
Amo correr assim
E múmias estudar.

Eu amo o mundo
Mistérios desvendar
Boom, de ya da. Boom, de ya da. (bis).

Amo os tornados
Eu amo as aranhas
Eu amo magma
E coisas estranhas.

Eu amo o mundo
É um lugar legal
Boom, de ya da. Boom, de ya da.
Boom, de ya da. Boom, de ya daaaaaa…

Parabéns ao Discovery Channel!  À 72andSunny pela excelente peça publicitária! E aos responsáveis pela versão em português (melhor que o original, aliás).

Um exemplo ilustrativo do que quero dizer, p.ex., é a formatação de datas e horas.  Geralmente o formato de data e hora que deve ser apresentado ao usuário depende da localização do site, do público alvo, além de outros fatores.  Por exemplo, para um site de notícias em português talvez seja bom mostrar-se datas por extenso, (como “17 de março de 2009″) ou no formato dd/mm/aaaa.Supondo que você já tenha iniciado a construção do sistema neste formato de data em todas os 50 scripts de páginas de sua aplicação até que um dia decidiu-se que as datas deveriam ficar num formato mm/dd/aaaa (por exemplo 03/17/2009).  E agora?

Além disso, geralmente os dados são armazenados de forma diferente da maneira como são exibidos.  Os bancos de dados usam por padrão o formato aaaa-mm-dd para datas.  Nas mãos de um programador displicente, conversão de formatos de datas pode facilmente se tornar um problema chato.

Por hora, o CakePHP é minha ferramenta de opção.  Além de ter uma comunidade de desenvolvedores e usuários muito numerosa e atuante, uma das coisas que me fascinam no CakePHP é a clareza e a facilidade propiciadas para uso de boas práticas de programação.  Um dos melhores exemplos disso é o behaviour DateFormatter.

DateFormatter é um dos behaviours mais simples e ao mesmo tempo mais úteis que já encontrei para CakePHP.  Ele nos permite especificar a o formato de seus dados temporais tal como você deseje exibí-los aos usuários e o formato adequado para armazenamento em banco de dados de uma maneira centralizada, organizada e gerenciável.  Tudo o que você precisa é definir os formatos desejados para exibição de suas datas (o que pode depender da localização de sua aplicação) e o formato no banco de dados que o behaviour pode lidar com as formatações transparentemente.

Formatando Datas
Para utilizar o DateFormatter behaviour em sua aplicação, copie o código do site, salvando-o num arquivo em /app/models/behaviours/date_formatter.php.

Como o nome indica, um behaviour em CakePHP é um comportamento que agrupa uma funcionalidade comum a vários models.  Para usá-lo em toda a sua aplicação, aplique-o a seu app_model.php:

<?php
class AppModel extends Model {
// …
var $actsAs = array(‘DateFormatter’, …);
// …
}

E pronto!

Como definido no código do behaviour, or padrão, suas datas para o usuário estarão no formato dd/mm/aaaa e para o banco em aaaa-mm-dd (como mesmos parâmetros do comando date do PHP).  O código está muito bem comentado e você pode modificar seus formatos de data nos atributos do behaviour sem qualquer dificuldade, mas você também pode definir estes formatos nas configurações do CakePHP.

Se você analisar o código da implementação do behaviour, verá que é de uma simplicidade ímpar!  Essencialmente, antes de salvar um registro de um model no banco (callback beforeSave do AppModel), ele converterá os campos de data para o formato de banco definido e aplicará o formato de data de exibição depois de obtê-lo no banco (callback afterFind).

O que é melhor é que o DateFormatter, com os formatos consistentes, pode ser utilizado transparentemente sem qualquer problema de compatibilidade com máscaras em javascript (como, p.ex., plugins MaskedInput e MeioMask do jQuery) ou elementos de formulário para seleção de data (como o Advanced DatePicker Helper ou AnnoDommini para CakePHP).

O CakePHP também tem o TimeHelper para ajudar na formatação de datas e horas, mas como é aplicado na camada de visão, não há definição centralizada de formato.

DateFormatter passou a ser imprescindível em minhas aplicações CakePHP.  Espero que lhe ajude também!

Entendendo o problema

A codificação de caracteres mais primitiva é a chamada codificação ASCII.  ASCII é uma codificação de 7 bits, ou (2⁷) 128 caracteres.  Essa quantidade de caracteres é mais que suficiente para representar as letras do alfabeto inglês em maiúsculas e minúsculas (de a-z e de A-Z, ou 52 caracteres no total), os dígitos de 0-9, alguns sinais de pontuação (como .;:?!@#$%&, e outros) além de alguns caracteres não imprimíveis para funções de controle (como quebras de linha, tabulações, espaçamento, fim de arquivo, etc).

Porém, não havia como representar, em ASCII, caracteres comuns nos idiomas latinos, como os acentos comuns nos idiomas português e español.  Essa deficiência foi contornada com uma versão estendida da tabela ASCII em 8 bits, ou 256 posições – o dobro da capacidade.

Mas a tabela ASCII estendida não era uma solução definitiva para codificações de caracteres.  Principalmente com a popularização da Internet, tornou-se mais do que necessário unificar as representações de caracteres.  Afinal, ainda havia problema de compatibilização com caracteres para idiomas orientais tais como 日本語 (japonês), Русский (russo), Ελληνικά (grego), العربية (árabe) e muitos outros.

Uma solução adotada pelo organismo internacional de padronização – ISO – consistia em definir o que se chamou de páginas de conjuntos de caracteres, que eram padronizadas e específicas para cada um dos diferentes idiomas.  No padrão da ISO, a página para o conjunto de caracteres dos idiomas latinos é a ISO-8859-1.

Apesar de o uso de páginas de caracteres ter sido bastante difundido a partir de sua adoção como padrão ISO, havia o inconveniente do gerenciamento de páginas de codificação.  Por exemplo, se você deseja ter um site em idiomas com 4 codificações distintas, a rigor, deveria criar cada página, salvando-as na codificação devida e configurando seu servidor e sua aplicação para chavear entre as páginas de caracteres.  Esse tipo de tarefa, ainda que simples, pode representar bastante trabalho.

Surgiu então a iniciativa Unicode, ou conjunto de caracteres universal.   Um consórcio de diversas entidades se formou com a ideia de definir uma representação unificada e padronizada para todos caracteres de todos os diferentes idiomas.  Um grande desafio!  Mas hoje a maioria dos sites web que estão no ar já utilizam Unicode e seu crescente suporte já é amplamente difundido em muitas aplicações.  Você pode aprender mais sobre Unicode na Wikipedia,  ou neste excelente artigo do Joel on Software.

E o “cake” isso tudo tem a ver com o CakePHP?

Para evitar a ocorrência de problemas de codificação de caracteres com sua aplicação em CakePHP, a recomendação definitiva é: utilize UTF-8 em todo local que você vir relacionado a codificação de caracteres e você não vai ter problema.  (É claro que se você tem certeza de que nunca vai ter conteúdo escrito em outro idioma que não o português do Brasil, ao invés de UTF-8, pode utilizar tudo na codificação ISO-8859-1).

Abaixo segue um checklist sobre todos os locais que você deve conferir para esta codificação, em ordem do mais simples e que provavelmente já deve estar okay, até o mais inusitado e que você só vai querer mexer em caso de paranoia total.  Se você estiver enfrentando problemas com codificação de caracteres, vá fazendo uma de cada vez e verifique até que ponto o problema ainda persiste:

1. App.encoding no arquivo core.php
   Por padrão, o CakePHP já vem configurado para trabalhar com UTF-8.  Esta configuração é feita no arquivo core.php (em /app/config).  Confira se este arquivo contém uma linha como a abaixo:

   Configure::write(‘App.encoding’, ‘UTF-8′);

   Vale lembrar também que este é o valor que é retornado quando se utiliza $html->charset() numa view ou num layout.

2. Codificação de seus arquivos .php
   Os arquivos .php que você escrever (particularmente seus models, suas views e seus controllers) devem ser gravados na codificação UTF-8.  Esta é uma questão comum já que em alguns editores a configuração da codificação de caracteres acaba ficando escondida.  Portanto, dê preferência para usar um editor de código “esperto” que especificar adequadamente a codificação de caracteres ao salvar seus arquivos.Um detalhe um pouco mais técnico é que a codificação de seus arquivo deve ser “UTF-8 sem BOM”.  BOM significa byte order mark.  É que UTF-8 por padrão utiliza uma marcação escondida antes de cada caracter apenas para que os byte da representação interna possam ficar ordenados.  O problema é que essa marcação interna não é compreendida pelo PHP que acaba inserindo uns caracteres estranhos como lixo no começo da página.  Se você vir algo como

   

   então abra seus arquivos .php em um editor de texto esperto e salve-os novamente na codificação “UTF-8 sem BOM” (procure por algo correlato no seu editor de texto, geralmente em Preferências, algum item de menu, barra de status ou até no próprio diálogo Salvar). Citando Túlio Faria, nunca use BOM, porque BOM é ruim…

3. Metatag de codificação de caracteres no layout
   A especificação da linguagem (X)HTML define informações de metadados referentes à própria página, as chamadas metatags.  Certifique-se de que seus arquivos de layout (em /app/views/layouts) possuam esta tag meta em seu cabeçalho:

   <meta http-equiv=”content-type” content=”text/html; charset=UTF-8″ />

4. Codificação do servidor web Apache
   A metatag acima é a forma de indicar, no padrão (X)HTML, em que codificação de caracteres está o conteúdo da página.  Mas necessariamente isto não significa (infelizmente) que o navegador irá utilizar esta codificação.  No Mozilla Firefox, a definição da codificação de caracteres pode ser trocada no menu Exibir > Codificação (a propósito, ficar experimentando com as opções deste menu é uma boa maneira de se descobrir em que codificação de caracteres o conteúdo está).Assim, para que as páginas de sua aplicação já venham por padrão com a codificação correta definida, você deve configurar o servidor web também para serví-las em UTF-8.  No caso do Apache (sem esquecer de reiniciá-lo depois), adicione a seguinte ao arquivo httpd.conf (ou onde vir ser mais adequado):

   AddDefaultCharset UTF-8

   Se você não tiver acesso às configurações do servidor Apache (uma aplicação já em produção, p.ex.), pode adicionar a linha acima ao final de seus arquivos .htaccess na raiz do CakePHP.

5. Codificação no banco de dados MySQL
   Problemas de codificação no banco de dados são um pouco mais sérios porque podem até fazer com que dados contendo caracteres especiais não apareçam em algumas listagens.  No caso do MySQL, a codificação pode ser definida na criação da tabela com a opção CHARACTER SET.  Para definir todos os campos textuais da tabela em UTF-8, crie-a como no exemplo:

   CREATE TABLE posts (
   id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
   title VARCHAR(50),
   body TEXT,
   created DATETIME DEFAULT NULL,
   modified DATETIME DEFAULT NULL
   ) CHARACTER SET utf8 COLLATE utf8_bin;

   PS: A parte “COLLATE utf8_bin” é opcional.  Mas se por acaso você quiser deixar seu banco insensível à diferença entre maiúsculas e minúsculas, você poderia deixar “COLLATE utf8_unicode_ci” (o sufixo “_ci” significa case insensitive).

6. Alterando a codificação padrão do interpretador PHP via php.ini
   Se você seguiu os cinco itens anteriores corretamente, então com 99,9% de certeza seu problema com codificação de caracteres já terá sido resolvido.  Todavia, se você está certo de que fez tudo corretamente, e está arrancando os cabelos porque ainda vê quadrados, pontos de interrogação ou caracteres estranhos onde deveriam estar acentos.  Se já perguntou na lista e não teve a solução do problema.  Se você já estiver ficando louco e não sabe mais o que fazer, tente modificar a codificação padrão do interpretador PHP.  No arquivo php.ini de sua instalação do PHP, deve haver um trecho semelhante a este:

   ; PHP’s built-in default is text/html
   default_mimetype = “text/html”
   ;default_charset = “iso-8859-1″

   Você pode retirar o ponto-e-vírgula da frente da diretiva “default_charset” e modificar seu valor para “utf-8″, reiniciando seu servidor web em seguida.  Mas novamente, só faça isto  em último caso!

É isso!  Embora longo, espero que este artigo lhe seja útil!

Fiz algumas apresentações sobre esta sensacional ferramenta durante o último ano.  Na Semana Acadêmica da Faculdade ESAMAZ, no PHP Pattern do Fórum Paraense de Software Livre e na Semana Paraense de Informática.  Os slides são um pouco antigos (antes do lançamento oficial da versão 1.2) mas ainda válidos como palestra introdutória e acho que é importante disponibilizá-los aqui por referência.

Os slides estão disponíveis para visualização e download no Slideshare. Confira!

Passo 1. – Abandone seus velhos hábitos

Tendo você ou não ótimos hábitos, a familiaridade com diversos outros frameworks, ou de fato até nenhuma experiência… ainda assim será muito benéfico para você abrir sua mente e experimentar o modo “Cake” de fazer as coisas.  Você pode não concordar, você pode não gostar, mas se você quiser vislumbrar o poder do CakePHP, ponha seus conhecimentos prévios de lado por um instante e tente entender porque as coisas são feitas da forma que devem ser feitas.  No fim das contas, você deverá concordar, gostar ou mesmo começar a se sentir um pouco mais por dentro dos novos paradigmas e das novas oportunidades que se abrirão a você como desenvolvedor.

“É muito mais fácil criar uma obra de arte em uma tela em branco do que pintar sobre algo que alguém já começou.”

Passo 2. – Ler a documentação ajuda muito

Volta e meia chego a ouvir que a documentação do CakePHP “não presta”.  Pessoalmente, eu acho que isso não poderia estar mais longe da realidade (mas vamos focar no assunto).  O novo manual em http://book.cakephp.org – chamado de “The Book” (“O Livro”) ou “Cookbook” (“Livro de Receitas”) – está melhor do que nunca.  E o que é mais importante é que ele é fruto de um trabalho coletivo da comunidade.  Qualquer parte do livro pode ser editara e você mais do que ninguém é convidado a contribuir e melhorar a documentação como bem quiser.  Seja corrigindo erros de ortografia, incluindo algum código de exemplo ou esclarecendo alguma explicação, tudo conta e não há nada que não seja importante de ser colocada no framework.  Em outras palavras, se você encontrar um problema ou algo faltando, você tem o poder para melhorá-la você mesmo.

Passo 3. – Entre na lista de discussão (Google Group)

O CakePHP é uma comunidade bem abrangente, atuante e colaborativa: http://groups.google.com/group/cakephp-pt.  Entre na lista, poste suas dúvidas quando você estiver engatado em alguma coisa para obter ajuda de outros usuários.  Participando da lista, você não só tem a chance de trocar conhecimento com outras pessoas (o que, no mínimo, é uma boa sensação), mas também de aprender um pouco mais apenas lendo as mensagens e possivelmente ajudando nos problemas que os outros estejam tendo.

(N.T.: Se o idioma inglês não é problema para você, participe também da comunidade internacional do CakePHP em http://groups.google.com/group/cake-php)

Passo 5. – Entre no amigável canal IRC da comunidade

Para coisas em geral, o CakePHP tem um canal IRC (#cakephp na rede irc.freenode.net) excelente e bastante ativo, o que é perfeito para quando você precisar de algum suporte em tempo real.  Além de bastante amistoso e colaborativo, o canal também é um ambiente de bastante descontração e certamente pode ser usado como uma ótima ferramenta de aprendizado para aprofundar seus conhecimentos.

Passo 5. – Comece a programar, logo

Toda a leitura e preparativos são incentivadas, mas a parte mais importante para entrar de fato no mundo do CakePHP é sentar e começar a programar nele.  Mesmo se você simplesmente seguir o tutorial do blog.  Mesmo se você não tiver segurança se a abordagem que está seguindo é a melhor.  Programar é algo que envolve melhoramentos constantes e refatoração é mais uma parte natural da vida de um desenvolvedor.  Quanto mais cedo você começar, mais cedo você estará se aprimorando.  Talvez não precisasse se dizer, mas é claro que você pode não conseguir fazer um bom bolo a menos que você tente realmente pôr a mão na massa.

Passo 6. – Fique íntimo da API

No momento em que escrevia este artigo, o CakePHP tinha acabado de ganhar uma nova API (apenas alguns dias atrás), graças a Mark Story e outros colaboradores.  Sim, ainda há uns poucos ajustes a serem feitos, mas a API é uma ferramenta indispensável para qualquer desenvolvedor.  Ela pode lhe parecer um pouco indimidadora no início, mas é bom você se acostumar a ela e aprender a gostar dela.  A API é a resposta definitiva para muitas de suas perguntas sobre o desenvolvimento com CakePHP.  Seguir em frente para compreendê-la pode até ser um pouco difícil no começo, mas vale muito a pena no fim das contas.

Passo 7. – Apaixone-se você também pelos casos de teste

Existe alguma coisa melhor para um desenvolvedor do que a API do CakePHP?
De faro, há os casos de teste.  Os casos de teste principais (aos que me refiro aqui), cobrem cerca de 90% de todo o código do framework.  Eles lhe mostram cada pequeno detalhe sobre como usar este ou aquele método no CakePHP e depois de dedicar seu tempo no Passo 6, dar uma olhada nos casos de teste irá melhorar em muito o seu grau de conhecimento.

Passo 8. – Submeta um artigo para o Bakery

Agora você está quase lá… pode ser que você tenha tido dificuldade em algum ponto ou outro, mas deve tê-los superado.  É o momento perfeito para compartilhar sua experiência com a comunidade.

Você desenvolveu alguma aplicação interessante que gostaria de mostrar ao mundo? …compatilhe-a como um caso de estudo.
Criou algum pequeno helper que outras pessoas também poderiam aproveitar? …escreva sobre ele em um artigo.
Precisou fazer algum código em algum método que facilitou a sua vida? …submeta um trecho de código.

O Bakery (a padaria) é o local definitivo para compartilhar seu conhecimento com outros e aprender uma coisa ou outra no processo e ao mesmo tempo apresentar o que você aprendeu à comunidade… além de exercitar sua mente.

Passo 9. – Acompanhe os tíquetes na linha de tempo do trac

Aqui, você já está em um bom nível dentro do CakePHP.  Neste ponto, acompanhar o trac do CakePHP é algo de caráter educativo… e também importante, se você quiser estar antenado sobre as novidades e o futuro do framework.  A linha do tempo em  https://trac.cakephp.org/timeline lhe oferece uma perfeita visão geral sobre o que está acontecendo diariamente na vida dos desenvolvedores do CakePHP.  Você vai ver a maior parte do código submetido diariamente sendo incorporado ao núcleo do framework e os diversos tíquetes sendo respondidos e fechados pelas mais variadas (e “divertidas”) razões.  Além disso, o que é mais importante, você percebe que o framework como uma coisa viva e se desenvolvendo ao longo do tempo.

É reconfortante saber que quando você estiver cumprido todos esses passos, ao final, você não está sozinho.  Os desenvolvedores do CakePHP estão trabalhando duro e incansavelmente para estar sempre facilitando e aprimorando as coisas.

Passo 10. – Escreva um caso de teste e submeta um patch

Posso imaginar que você é um verdadeiro especialista no CakePHP, não?  Bem, diga o que quiser mas nada é perfeito.  Se você vir algo no framework de que você não goste ou se tiver uma idéia brilhante de como otimizar algo no código, seja benevolente e submeta um tíquete com um patch e um caso de teste.  Mas, por favor, faça as coisas direito! … Dizer que “Isto não está funcionando!” não é um tíquete muito útil para ninguém.

Dedique algum tempo, sente-se e pense sobre como seria uma correção e um caso de teste neste caso.  Assim, sua idéia poderá rapidamente ser relacionada e implementada.  No fim das contas, ninguém gosta de ficar esperar pela correção de problemas.

Passo 12. – Contribua

Não importa se você já for um guru do CakePHP, um mestre da orientação a objetos ou um entusiasta do PHP.  É possível contribuir com o projeto de diferentes formas, por diversos meios e de várias maneiras.  Como já dito… desde uma pequena ajuda com a documentação, com projetos relacionados, com algum componente esperto que você tenha criado, com um bom trecho de código (ou mesmo um artigo em seu blog, se for o caso)… são todas contribuições úteis.  Cada pessoa trabalhando nisto em em outros projetos semelhantes é um voluntário.  Respeite isso, e se torne voluntário você também.  Pode não ser um hábito simples de se adquirir mas que pode representar um impacto positivo muito grande em sua vida como um todo.

Passo 12. – Comece a estudar outros frameworks

É, não é brincadeira.  Não importa o quanto você se aprofunde como um especialista em CakePHP, sempre é importante ter em mente que nenhuma ferramenta é perfeita para qualquer tarefa.  Há muitos outros ótimos frameworks construídos por excelentes programadores e que certamente podem ajudar você a se aprimorar como programador.  É claro que eu apoiar que você grite sempre: “Cake é o MELHOR!” sempre que puder, mas seja respeitoso com os demais, que não tenham tanta sorte!

P.S. Atualização!  Este guia simples de 12-passos está disponível livremente e sem custos, mas se você quiser, sinta-se à vontade para me enviar duas contribuições de $9.95 ou apenas uma de $12.35…