Gem Ruby para gerar, validar e consultar Códigos de Endereçamento Postal brasileiros (CEP / zip code) com informações de estado e região.

• ✅Zero dependências - Funciona com Ruby puro

• ✅Suporte a Ruby 3.1+ - Compatível com versões modernas

• ✅Interface simples - Fácil de usar tanto em código quanto via CLI

• ✅Dados embutidos - Não requer banco de dados ou API externa

• Aleatórios ou por estado específico

• Com ou sem formatação (12345-678 ou 12345678)

• Inclui metadados automáticos (estado e região)

• Verifica formato válido de CEP

• Checa se pertence a um estado específico

• Identifica estado e região de um CEP

• Suporte a todos os estados brasileiros

Adicione ao seu Gemfile:

gem 'bonzi_cep'

e execute

$ bundle install

ou instale diretamente

$ gem install bonzi_cep

require 'bonzi_cep'

# Gerar CEP aleatório
BonziCEP.gerar
#=> { cep: "12345-678", estado: "SP", regiao: "Sudeste" }

# Gerar para um estado específico
BonziCEP.gerar_para_estado('RJ')
#=> { cep: "20000-000", estado: "RJ", regiao: "Sudeste" }

# Validar CEP
BonziCEP.valido?("12345-678") #=> true

# Consultar CEP
BonziCEP.consultar("01001-000")
#=> { cep: "01001-000", estado: "SP", regiao: "Sudeste" }

# Verificar estado
BonziCEP.pertence_a_estado?("20000-000", "RJ") #=> true

# Listar estados suportados
BonziCEP.estados_suportados
#=> ["AC", "AL", "AM", ...]

Via terminal (CLI)

# Gerar CEP aleatório
bonzi_cep -g

# Gerar para estado específico (SP)
bonzi_cep -g -e SP

# Consultar um CEP
bonzi_cep -c 01001-000

# Validar um CEP
bonzi_cep -v 12345-678

# Listar estados suportados
bonzi_cep -l

Este projeto está licenciado sob a licença MIT - veja o arquivo MIT License. para detalhes.