Skip to content

Brazilian Rails é um conjunto de gems para serem usadas com Ruby e com o Ruby on Rails e tem como objetivo unir alguns recursos úteis para os desenvolvedores brasileiros.

Notifications You must be signed in to change notification settings

reinaldomendes/brazilian-rails

 
 

Repository files navigation

Brazilian Rails

O que foi?

O Brazilian Rails foi o plugin de internacionalização mais conhecido do Brasil e tinha como objetivo unir vários recursos de regras e traduções para o desenvolvedor brasileiro.

O que é?

Brazilian Rails é um conjunto de gems para serem usadas com Ruby e com o Ruby on Rails e tem como objetivo unir alguns recursos úteis para os desenvolvedores brasileiros.

O que vem pela frente?

Existem vários plugins espalhados, que são úteis a comunidade brasileira, e gostaria de convocar seus colaboradores a entrar em contato comigo para que juntos nós migremos para gems dentro do Brazilian Rails.

Já usava como plugin, o que eu tenho que fazer?

NADA! Essa gem foi cuidadosamente pensada permitir seu uso como plugin sem precisar fazer mais nada, preservando-se a mesma forma de instalação anterior.

Cade o SVN?

Foi desativado por completo. Agora só teremos suporte GIT.

Quais as gems que compõe o Brazilian Rails?

  • brcep
  • brdata
  • brdinheiro
  • brhelper
  • brnumeros
  • brstring
  • brcpfcnpj
  • brI18n

OBS: A gem brtraducao foi removida do Brazilian Rails devido a adição do suporte i18n do Rails. Ele continua podendo ser usada, porém não faz mais parte desse projeto. Para maiores detalhes, leia o post O Brazilian Rails e o suporte i18n

OBS: A gem brI18n foi criada para acomodar as traduções usando suporte i18n das versões mais recentes do Rails.

Suporte à Ruby 1.9 (experimental)

As gems foram portadas para Ruby 1.9, porém o suporte ainda é experimental, e contamos com a comunidade para ajudar a melhorar o suporte. Todas as gems funcionam corretamente, mas caso decida usar a nova versão do Ruby, tome um cuidado especial com a gem brdata. O método Date#parse se comporta de maneira diferente nas versões 1.8 e 1.9 do Ruby, o que pode ocasionar alguns erros.

Como faço para instalar?

É muito difícil...

No Rails 3.x

Adicionar ao seu Gemfile:

gem 'brazilian-rails'

No Rails 2.x

Como plugin:

ruby script/plugin install git://github.com/tapajos/brazilian-rails.git

Por padrão, a pluralização vem desabilitada, isso para não atrapalhar os projetos que já existem.

Como gem:

gem install brazilian-rails -v 2.1.15

Depois que todas as gems forem instaladas você pode utiliza-las individualmente ou carregando todas, como no trecho abaixo.

Rails::Initializer.run do |config|
	config.gem 'brazilian-rails', '2.1.15'
end

I18n

Por padrão a gem não carrega o suporte de traduções do Rails, para usa-la você deve fazer o require abaixo:

require 'brI18n'

Como funciona?

Está tudo explicado na nossa api.

Achei um BUG, o que eu faço?

Por favor, nos avise! Isso é fácil e rápido. Isso pode ser feito em:

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

Como contribuir?

  1. Fazer um fork do projeto
  2. Instalar as dependências: bundle install (Se não tiver o bundler instalado, faça antes: gem install bundler)
  3. Fazer os devidos ajustes com os respectivos testes (TestUnit se possível e tente fazer commits atômicos)
  4. Incrementar o número da versão de cada lib/version.rb e a constante PKG_VERSION no Rakefile do brazilian-rails
  5. Fazer pull request

Quem está por traz disso tudo?

O Marcos Tapajós tomou coragem para publicar todas as funcionalidades em um plugin, com testes unitários para garantir que tudo funcione conforme manda o figurino. Além do Tápa, outros loucos mantém tudo organizado, são: Celestino Gomes, André Luiz Kupkovski, A galera da Improve It e mais alguns que ficam escondidos para não pagar esse mico...

Muitos já contribuíram com o projeto.

git log --raw | grep "^Author: " | sed 's/Author: //' | sed 's/<.*$//' | sort | uniq
  • Cássio Marques
  • Eduardo Fiorezi
  • Eduardo Hertz
  • Everton Ribeiro
  • Fabio Akita
  • Fernando Gomes
  • Fernando Luizao
  • Joao Vitor
  • Julio Santos Monteiro
  • Kivanio Barbosa
  • Marcus Derencius
  • Marcus Sá
  • Mauricio Zaffari
  • Rafael Uchoa
  • Ricardo Shiota Yasuda
  • Sergio Brant
  • albertobraschi
  • cassio
  • dannnylo
  • elomarns
  • frederico

Algumas funcionalidades:

  • Date e Time no formato brasileiro
  • Números por Extenso
  • Dinheiro
  • Cpf e Cnpj
  • Feriado
  • Mensagens de erro traduzidas
  • etc

Duvidas?

As duvidas podem ser enviadas diretamente a um dos desenvolvedores ou através da página do projeto no RubyForge

Quem investe nesse plugin?

Este plugin é patrocinado pela Improve It.

Improve It

About

Brazilian Rails é um conjunto de gems para serem usadas com Ruby e com o Ruby on Rails e tem como objetivo unir alguns recursos úteis para os desenvolvedores brasileiros.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%