Desenvolvimento Ágil - Blog da Improve It: Tag brazilianrails

Mais uma gem no Brazilian Rails

Marcos Tapajós — Tue, 23 Sep 2008 23:20:36 -0300

O Brazilian Rails acabou de ganhar uma gem para lidar com CPF e CNPJ desenvolvida pelo Cássio Marques. Ele fez um post no seu blog explicando como utilizar.

http://tinyurl.com/cpfcnpj

Além dessa nova gem a versão 2.0.8 do Brazilian Rails recebeu algumas pequenas correções feitas pelo Akita e pelo Sergio Brant.

Gostaria de agradecer aos três pelas colaborações.

Agora é a hora!

Marcos Tapajós — Mon, 23 Jun 2008 00:24:45 -0300

Como eu falei no meu outro post, nós estamos refatorando o Brazilian Rails e essa é a hora para quem quiser dar grandes sugestões e/ou colaborações. Quem quiser comentar algo ou faça agora ou cale-se para sempre! :-)

Tudo que estamos mexendo está em um branch chamado gems lá no Github. Para baixar o código basta seguir esses passos:

git clone git://github.com/tapajos/brazilian-rails.git
cd brazilian-rails
git checkout --track -b gems origin/gems

O futuro do Brazilian Rails

Marcos Tapajós — Sat, 21 Jun 2008 21:10:26 -0300

Já faz um bom tempo que o Tino conversou comigo sobre rescrever o Brazilian Rails só que nós fomos adiando e acabou não saindo nada. Freqüentemente nós recebemos várias sugestões e queria dizer que todas estão sendo analisadas e algumas já estão na nossa agenda(no meio digital dois corpos ocupam o mesmo espaço!).

Essa semana o Cássio e o Hallison deram a sugestão de modularizar o plugin para poder instalar apenas o que é realmente útil para um determinado projeto. Foi uma sugestão que não é inédita mas que eu juntei com uma outra que eu recebi faz um bom tempo que é transformar o plugin em uma gem para não precisar instalar em cada projeto.

A idéia é tornar um Brazilian Rails em um conjunto de gems de forma bem semelhante ao Rails mas que poderá ser usado como plugin da mesma forma como é usado hoje. Bem, esse é o futuro!

Pois bem, fiz um branch chamado gems lá no nosso repositório e já estou trabalhando na futura versão do Brazilian Rails. Se alguém quiser olhar e dar sugestões..

Brazilian Rails no github

Marcos Tapajós — Tue, 22 Apr 2008 15:33:13 -0300

Acabei de terminar a migração do plugin Brazilian Rails para o github. Achei que ia ser bem mais complicado do que foi ! :-)

Nós decidimos manter o SVN como um espelho (por um tempo) para facilitar a instalação nas versões anteriores a Rails Edge. Agora existem duas formas de instalação que estão detalhadas na página do plugin.

Para quem quiser acompanhar o projeto a url no github é:

http://github.com/tapajos/brazilian-rails

Novidades no Brazilian Rails

Marcos Tapajós — Thu, 17 Apr 2008 18:54:46 -0300

O Tino acabou de publicar no blog dele as últimas mudanças do Brazilian Rails.

Nova Página para o Brazilian Rails

Marcos Tapajós — Tue, 25 Mar 2008 19:47:57 -0300

Hoje o Brazilian Rails ganhou um site um pouco mais bonitinho com um design igual ao do nosso outro plugin.

Na verdade esse é um template, de autoria do Leandro, que será usado em todos os nossos plugins. Só não está mais bonito pois resolvi meter a mão e me antecipar ao Leandro.

Brazilian Rails: Patch aceito.

Marcos Tapajós — Tue, 25 Mar 2008 05:44:23 -0300

Como sempre estou atrasado e só hoje vi alguns patch no Brazilian Rails.

Patch #17896 - usar_como_dinheiro não funciona com audit.

O Sylvestre Mergulhão identificou uma incompatibilidade do plugin com o audit que não fazia log das colunas mapeadas com o usar_como_dinheiro. O patch que ele enviou já foi aceito.

Patch #18822 - Criação de metodos para que o select_estado funcione com o form_for.

Esse patch foi enviado pelo Rafael Cardoso e é bastante pertinente só que não foi aceito ainda pois o patch foi gerado de forma incorreta. Ele já fez contato comigo e vai enviar o patch correto em breve.

Queria agradecer aos dois pela colaboração constante. Já perdi a conta de quantas vezes aceitei código deles.

Brazilian Rails - Demorou mas agora foi !

Marcos Tapajós — Sat, 08 Mar 2008 13:43:00 -0300

Depois de muito tempo(ou falta de tempo) resolvi solucionar alguns bugs reportados no plugin.

Quem quiser saber de mais detalhes sobre os bugs pode dar uma olhada lá na página do projeto no RubyForge. Vou apenas listar as repostas que eu dei a cada um deles.

Bug 17663 - Inclusão da validação less-than-or-equal-to

Regis, realmente estava faltando essa messagem. Já foi adicionada. Obrigado.

Bug 17664 - Pluralização correta para 'mail' e 'email'

Regis, realmente estava faltando essa regra. Já foi adicionada. Obrigado.

Bug 17439 - Atributos possuem gênero, fazendo com que alguns erros apareçam com erros de concordância.

Lucas, não foi possível aceitar seu patch pois ele não está acompanhado de testes. Umas das nossas restrições com relação a patch e novas funcionalidades é que todas devem ser acompanhada de testes. Entretanto o problema que você relatou é realmente relevante e por isso mesmo deixarei o bug em aberto para que, quando possível, algum dos desenvolvedores corrija. Caso seja do seu interesse evoluir seu código para virar um patch que atenda as exigências do projeto a equipe estará a disposição para te ajudar no que for necessário.

Bug 18022 - Conflito de plugin.

Realmente confirmei que existe essa incompatibilidade. Não analisei mais a fundo o problema mas ao que me parece o plugin ActiveScaffoldLocalize modifica a forma como as validações são armazenadas e seus usos. Como apenas traduzimos, sem mudar nada, temos problemas sempre que o nosso plugin é iniciado após o ActiveScaffoldLocalize. Estou analisando a melhor forma de solucionar esse problema. Com relação ao link no Readme ele está correto. O segundo link nessa sua mensagem está errado pois o protocolo usado não é o http. O link correto é o do Readme (svn://rubyforge.org/projects/brazilian-rails/).

Bug 18077 - usar_como_dinheiro

O usar_como_dinheiro foi planejado para funcionar com o Active Record. Ele utiliza coisas específicas do Active Record, como, por exemplo, as validações. Para utilizar em modelos que não tem herança do Active Record é necessário fazer uma nova implementação que no momento não está planejada mas quem sabe num futuro próximo possa ser feita.

Gostaria de agradecer a todos pelo feedback mas em especial ao Regis que mandou duas soluções prontas. Prometo tentar responder mais rapidamente.

Plugin Brazilian Rails atualizado.

Marcos Tapajós — Wed, 23 Jan 2008 16:52:00 -0200

O Eduardo Fiorezi e o Bruno Iecker identificaram um bug no Brazilian Rails e me enviaram um patch só que devido a minha falta de tempo ainda não tinha verificado. Acabei de aplicar o patch e como os outros que eles enviaram está tudo muito bem feito e testado.

Gostaria de pedir desculpas pela demora e agradecer novamente aos dois pela ajuda.

Plugin Brazilian Rails atualizado

Marcos Tapajós — Sat, 22 Dec 2007 05:08:00 -0200

O Vinícius e o pessoal do Lucidus, andaram corrigindo alguns comportamentos indesejáveis na classe dinheiro quando ela era usada em composição no Active Record. Agora o método usar_como_dinheiro tem o mesmo comportamento das composições com Date.

Além disso o Rafael e o Sylvestre identificaram um comportamento que apesar de não ser um bug não fazia muito sentido. Quando um dinheiro era comparado com alguma coisa que não era Dinheiro ele lançava uma exceção ao invés de retornar false. Esse é um comportamento que foge ao padrão do Ruby. Normalmente em Ruby objetos diferentes podem ser comparados e o retorno será false. Exemplos:

"a" == Date.today
false
"a" == 1
false
"a" == Dinheiro.new(1)
false

Como estou preso no aeroporto de Curitiba, sem nada para fazer, acabei de aplicar o patch que eles enviaram. Obrigado pessoal !

Improvecast 19: XP na Ancar

Vinicius Manhães Teles — Tue, 02 Oct 2007 01:23:00 -0300

Acaba de ser publicado o podcast mais divertido que já gravei: o Improvecast 19. Dessa vez entrevistei a equipe de desenvolvimento da Ancar (veja as fotos), que atua na gestão de shopping centers e é cliente dos serviços de mentoring da Improve It. A Ancar vem trabalhando com XP desde o início de 2005. Durante dois anos os esforços de desenvolvimento estiveram concentrados em Java e mais recentemente a equipe passou a utilizar também Ruby on Rails.

Dessa vez, além do podcast, você também pode ler o estudo de caso da Ancar e ver as inúmeras fotos da equipe da Ancar trabalhando com XP. São nada menos que doze álbuns de fotos da Ancar. Aproveite!

Esses foram os assuntos tratados no Improvecast 19:

Quem é a Ancar e o que ela faz?
Como vocês conheceram o XP?
Que tipo de problemas vocês tinham antes de adotar o XP e o que os levou a querer adotá-lo?
Que abordagem vocês utilizaram para adotar o XP e quando começou a adoção?
Qual era a plataforma de desenvolvimento utilizada na época em que vocês começaram com o XP?
O que motivou vocês a adotarem o Java?
Que treinamentos vocês fizeram antes de iniciar o primeiro projeto XP e como eles foram conduzidos?
Depois do período inicial de mentoring e treinamento, vocês deram início ao primeiro projeto XP na Ancar, o Ancar2Go. O que é o Ancar2Go e que benefícios de negócio eram esperados dele?

Tela do Ancar2Go com a planta de um dos shoppings administrados pela Ancar.

Quantas pessoas havia na equipe do Ancar2Go?
Quem atuava como cliente desse projeto?
Qual o tamanho das iterações?
Que práticas do XP mais se destacaram nesse projeto?
Que tipo de transformações vocês notaram no relacionamento com o cliente a partir da adoção do XP?
O que mudou no entrosamento e motivação da equipe?
Um dos aspectos que mais me marcaram no desenvolvimento do Ancar2Go foi a troca de abordagem que ocorreu logo no início do projeto. Começamos pensando em desenvolver um sistema web. Entretanto, à medida que o projeto avançou umas duas semanas, começou a ficar claro que um sistema desktop seria mais adequado. Lembro-me até hoje de uma reunião de planejamento semanal na qual observei, pela expressão do do rosto do Rafal, que ele não estava à vontade com a maneira como o sistema estava sendo desenvolvido. Então, pedi a ele que expressasse sua opinião, o que ele fez muito bem, levando-nos ao caminho que se revelou corretíssimo: uma aplicação desktop. Vocês acreditam que a estrutura de trabalho do XP, com suas iterações curtas, foco em adaptar-se a mudanças, re-planejamento a cada início da iteração e envolvimento de todos no planejamento, contribuiu para identificarmos cedo que estávamos indo no caminho errado?
No início de 2006, após diversas tentativas de contratar desenvolvedores aqui no Rio, vocês decidiram tentar algo novo: importar profissionais do Paraná, recém-graduados, que estivessem dispostos a mudar-se para um apartamento próximo à Ancar, no Rio de Janeiro. Nesse processo, vocês adotaram a programação em par como forma de avaliar os candidatos. Vocês poderiam falar um pouco mais sobre o que foi feito nesse sentido?
Depois da contratação, como a programação em par contribuiu para o trabalho dos novos desenvolvedores?
Um aspecto muito forte aí na Ancar é a questão do desenvolvimento orientado a testes. No último projeto que vocês fizeram em Java, a taxa de cobertura dos testes era extremamente elevada, bem próxima de 100%. Agora, com dois anos de uso permanente do XP, qual a visão que vocês têm sobre a criação de testes automatizados ao longo do desenvolvimento? Eles realmente fazem a diferença e contribuem para elevar a qualidade dos produtos gerados?
Outro aspecto significativo aí na Ancar é o nível de automação dos builds. Explique um pouquinho como é conduzido o processo de integração contínua e qual é o papel do Bob Esponja nessa questão. :-)
O entrosamento da equipe sempre foi uma preocupação de todos nós aí na Ancar. Uma das tradições que criamos aí foi o almoço semanal com boliche. Vocês poderiam falar um pouco mais sobre ele?
Recentemente vocês se viram diante da necessidade de desenvolver o primeiro sistema web. Diante disso, foi preciso tomar uma decisão sobre a plataforma. Vocês estudaram várias soluções no mundo Java, mas acabaram optando por sair do Java e utilizar Ruby on Rails. O que os motivou a fazer essa migração?
Vocês podem falar um pouco sobre esse novo projeto?
Vocês acham que está valendo a pena trabalhar com o Rails?
O que vocês mais têm gostado a respeito do Rails?
Quais têm sido os maiores desafios e como eles vêm sendo tratados?
Recentemente vocês, em conjunto com o Tapajós, aqui da Improve It, desenvolveram um plugin para o Rails. O que ele faz?
Finalmente, quais são seus planos para o futuro em termos de desenvolvimento ágil e Ruby on Rails?

Além de escutar o podcast, veja as fotos. E lembre-se, quem quer aprender mais sobre desenvolvimento ágil deve ficar atento. Em breve lançaremos nossos primeiros treinamentos abertos ao público. Fique sabendo de todos os detalhes mais cedo e concorra a descontos. Basta cadastrar seu email para receber todos os detalhes. Cadastre-se.

Documentação online do Brazilian Rails

Vinicius Manhães Teles — Mon, 01 Oct 2007 13:59:00 -0300

O Tapajós publicou a documentação do plugin Brazilian Rails. Agora você pode acessar mais facilmente a API do Brazilian Rails. Ainda há muito a ser melhorado na documentação, mas esse é um passo importante para facilitar o uso do plugin.

Correção no Brazilian Rails relacionada ao uso de BigDecimal

Vinicius Manhães Teles — Fri, 28 Sep 2007 09:19:00 -0300

Felipe Barreto, nosso especialista de plantão em Rails, JavaScript, Web Standards e mais um monte de coisas, me informou ontem que identificou um problema na classe Dinheiro, do Brazilian Rails, relacionado ao tratamento de BigDecimals. O teste que revelava o problema era:

def testa_soma_de_dinheiro_com_big_decimal
assert_equal Dinheiro.new(200), BigDecimal.new("100").reais + "100".reais
end

A soma estava dando 0 e não 200, como deveria. Ooopppsss, isso é sério. Mas, já fiz a correção. Portanto, se estiver usando o plugin, faça a atualização.

Mais atualizações no Brazilian Rails

Vinicius Manhães Teles — Wed, 26 Sep 2007 23:22:00 -0300

Celestino Gomes, ou melhor, Tino, avisa que tem também mais essas novidades no Brazilian Rails:

Retornar numeros por extenso. (Código de Shairon Toledo). Exemplos:
1.to_extenso ==> 'um'
1.to_extenso_real => 'um real'
Normalizar nomes próprios. Exemplo:
'maria da silva e souza dos santos'. nome_proprio => 'Maria da Silva e Souza dos Santos'
Remover acentos. Exemplo:
'texto está com acentuação'.remover_acentos => 'texto esta com acentuacao'

Atualizações no Brazilian Rails

Vinicius Manhães Teles — Wed, 26 Sep 2007 20:02:00 -0300

Nos últimos dias comecei a me envolver também no Brazilian Rails e notei que a organização do repositório poderia ser aprimorada para facilitar a instalação. O Tapajós já resolveu essa questão e agora é possível instalar corretamente com o comando:

script/plugin install -x \
svn://rubyforge.org/var/svn/brazilian-rails

Se não quiser que ele fique instalado com externals apontando para o repositório, basta retirar o parâmetro -x.

Mais uma coisinha. O Felipe Santiago entrou em contato dizendo que estava difícil persistir a classe Dinheiro, caso ela fosse usada como atributo de uma classe de modelo do projeto. Ele estava coberto de razão. Muito obrigado, Felipe.

Para facilitar as coisas, adicionamos o método valor_decimal na classe Dinheiro e colocamos alguns exemplos no diretório samples/dinheiro. Em resumo, para usar a classe Dinheiro em uma classe de modelo, basta adicionar:

composed_of :valor, 
        :class_name => Dinheiro, 
        :mapping => [[:valor, :valor_decimal]];

Plugin Brazilian Rails atualizado.

Marcos Tapajós — Mon, 03 Sep 2007 07:04:00 -0300

Acabei de atualizar o plugin Brazilian Rails adicionando uma classe para lidar com dinheiro.

No plugin existe um arquivo com os exemplos de como usar cada uma dessas novas funcionalidades.

Problema no Brazilian Rails corrigido.

Marcos Tapajós — Thu, 02 Aug 2007 18:59:00 -0300

Uma das nossas premissas é que o nosso plugin nunca deve conflitar com o padrão do Rails, ou seja, uma aplicação já em funcionamento deve ser capaz de instalar o plugin e não parar de funcionar.

Essa preocupação surgiu quando ao modificar o to_s da classe Date minha aplicação parou de funcionar já que eu esperava um formato diferente de "%d/%m/%Y". Resolvi criando um outro método chamado to_s_br e mantendo o to_s original.

Hoje o Kristopher Murata me chamou a atenção para um problema, que ontem mesmo eu tinha notado e comentado com o Celestino Gomes, que o nosso plugin estava quebrando essa nossa premissa ao modificar as regras de pluralização do Rails.

Para corrigi esse problema eu retirei uma linha do init.rb do plugin deixando a inclusão dessa funcionalidade opcional através da adição de uma linha ao enviroment.rb

Gostaria de agradecer o feedback do Kristopher.

Plugin Brazilian Rails Atualizado

Marcos Tapajós — Tue, 31 Jul 2007 18:55:00 -0300

Acabei de atualizar o plugin Brazilian Rails adicionando ao método to_date da classe String a capacidade de lidar com datas no formato "DD/MM/AAAA".

A classe Date recebeu um método chamado to_s_br que gera uma string com a formatação "DD/MM/AAAA".

Foi criado o método estático valid? na classe Date para validar os formatos da data e o seu conteúdo.

No plugin existe um arquivo com os exemplos de como usar cada uma dessas novas funcionalidades.

Atualizado em 31/07/2007 às 22:46

Também foram adicionadas as traduções para os nomes do meses e dos dias e suas respectivas abreviações.

Plugin Brazilian Rails Atualizado

Marcos Tapajós — Sun, 08 Jul 2007 15:33:00 -0300

Acabei de atualizar o plugin Brazilian Rails adicionando ao modulo Inflector algumas regras de formação de plural para o português.

Plugin Brazilian Rails

Marcos Tapajós — Fri, 06 Jul 2007 21:30:00 -0300

Acabei de publicar no RubyForge a primeira versão do plugin Brazilian Rails.

Desde que eu comecei a programar em Ruby, usando o Ruby on Rails, sempre adorei o sistema de plugins, onde facilmente podemos incorporar novas funcionalidades que atendem a vários projetos.

Sempre tive vontade de colocar nossos códigos disponíveis como plugins mas nunca tive tempo para fazer isso. Inevitavelmente continuo sem tempo mas agora estou contando com um time de amigos que resolveram me ajudar. São eles:

André Luiz Kupkovski (Ancar)
Celestino Ferreira Gomes (Ancar)
Rafael Fraga Walter (Ancar)
Fernando João Manfroi (Ancar)
Luciene Souza Luna (Ancar)

Esse plugin surgiu da necessidade de usar o método error_messages_for para sinalizar na camada de vista os erros encontrados nas validações do nosso modelo. Essas mensagens eram em inglês, o que fazia com que os desenvolvedores tivessem que implementar algo semelhante no RHTML.

Acabamos notando que várias outras coisas poderiam ficar mais simples aos brasileiros usando-as como estamos acostumados. Por exemplo, nosso formato padrão de data é DD/MM/AAAA mas Ruby não trabalha da mesma forma. Para solucionar esse problema fizemos uma implementação que modifica o método to_date do modulo String para lidar com esse nosso formato.

Esse nosso primeiro release não abrange todas as nossas implementações mas resolvemos publicar o quanto antes para poder contar com o feedback dos nossos usuários e melhorar continuamente.

Trata-se de um projeto Open Source, onde gostaríamos de contar com a colaboração da comunidade Brasileira com sugestões e quem sabe com novos desenvolvedores. Minha única exigência com relação aos patches é que eles venham acompanhados de testes.

Quem quiser experimentar nosso plugin basta executar uma única linha e reiniciar sua aplicação Rails.

script/plugin install -x \
svn://rubyforge.org/var/svn/brazilian-rails

Como temos vários tipos de códigos diferentes devemos fazer outros plugins em breve !