MercosurPlateConverter

ENGLISH 🇺🇸🇬🇧

A motivação por trás dessa GEM é validar e converter placas de veículos brasileiros do antigo modelo para o novo modelo adotado pelo Mercosul (e vice-versa).

O padrão de numeração das placas de veículos brasileiros é o antigo modelo. O padrão de numeração das placas de veículos mercosul é o novo modelo.

O padrão mercosul é composto por 3 letras, 1 número, 1 letra e 2 números. Para fazer a conversão do modelo antigo para o novo, é necessário que o número seja convertido para a letra equivalente. Essa conversão é feita a partir de uma sequência, como em um Array, onde cada elemento é uma letra de A a J de acordo com o índice desse Array.

Assim sendo:

Insira a linha abaixo em seu Gemfile:

gem 'mercosur_plate_converter'

E então execute no terminal:

$ bundle install

Ou instale manualmente, também via terminal:

$ gem install mercosur_plate_converter

Crie uma instância da classe MercosurPlateConverter e use os métodos para validar e converter placas.

O exemplo abaixo considera que você fornece uma placa válida do tipo Mercosul:

plate = MercosurPlateConverter.from_string("ABC1C34")

plate.original_plate #=> "ABC1C34"
plate.plate #=> "ABC1234"
plate.type #=> :mercosur
plate.valid? #=> true
plate.mercosur? #=> true
plate.old_brazilian? #=> false

Após verificar o repositório, execute bin/setup para instalar as dependências. Em seguida, execute rake spec para executar os testes. Você também pode executar bin/console para um prompt interativo que permitirá que você experimente.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Relatórios de bugs e pull requests são bem-vindos no GitHub em github.com/rlvendramini/mercosur_plate_converter.