Versão Ruby (Gem) do pacote BrazilianUtils.
Repo brazilian-utils/ruby, read from GitHub 1 min ago. brazilian-utils has not joined Take My Repo.
brazilian-utils/ruby is a public repo on GitHub by brazilian-utils. Versão Ruby (Gem) do pacote BrazilianUtils. It declares the MIT license on GitHub. It is written mainly in Ruby, has 11 stars and last changed on 2026-09-30. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Biblioteca de utilitários para dados específicos do Brasil / Utils library for Brazilian-specific data
Utilitários para trabalhar com formatos de dados brasileiros:
gem 'br-utils'
bundle install
# CPF require 'brazilian-utils/cpf-utils' BrazilianUtils::CPFUtils.is_valid('11144477735') # => true BrazilianUtils::CPFUtils.format_cpf('11144477735') # => "111.444.777-35" BrazilianUtils::CPFUtils.generate # => "12345678901" # CNS (Cartão Nacional de Saúde) require 'brazilian-utils/cns-utils' BrazilianUtils::CNSUtils.is_valid('123456789010000') # => true BrazilianUtils::CNSUtils.format('123456789010001') # => "123 4567 8901 0001" # Passaporte require 'brazilian-utils/passport-utils' BrazilianUtils::PassportUtils.is_valid('CL125167') # => true BrazilianUtils::PassportUtils.format('acd12736') # => "ACD12736" BrazilianUtils::PassportUtils.generate # => "LB809567" # Certidão de Registro Civil require 'brazilian-utils/certidao-utils' BrazilianUtils::CertidaoUtils.is_valid('10453901552013100012021000012321') # => true BrazilianUtils::CertidaoUtils.format('10453901552013100012021000012321') # => "104539 01 55 2013 1 00012 021 0000123 21" BrazilianUtils::CertidaoUtils.get_info('10453901552013100012021000012321') # => {registryCns: "104539", acervo: "01", service: "55", year: 2013, type: "birth", ...} # Registro Profissional (OAB/CRM/CRO/CRP/CRC) require 'brazilian-utils/registro-profissional-utils' BrazilianUtils::RegistroProfissionalUtils.is_valid(value: '123456/SP', council: 'OAB') # => true BrazilianUtils::RegistroProfissionalUtils.is_valid(value: '06/12345', council: 'CRP') # => true # CNPJ require 'brazilian-utils/cnpj-utils' BrazilianUtils::CNPJUtils.is_valid('34665388000161') # => true BrazilianUtils::CNPJUtils.format_cnpj('34665388000161') # => "34.665.388/0001-61" # CNPJ v2 (alfanumérico, IN RFB 2.119) BrazilianUtils::CNPJUtils.valid?('12ABC345000188', version: 2) # => true BrazilianUtils::CNPJUtils.generate(version: 2) # => "12ABC345000188" (alfanumérico) # Inscrição Estadual (IE) require 'brazilian-utils/ie-utils' BrazilianUtils::IEUtils.is_valid('110042490114', 'SP') # => true BrazilianUtils::IEUtils.is_valid('12345678', 'RJ') # => true # CEP require 'brazilian-utils/cep-utils' BrazilianUtils::CEPUtils.format_cep('01310100') # => "01310-100" BrazilianUtils::CEPUtils.get_address('01310100') # => {...endereço completo...} # Moeda require 'brazilian-utils/currency-utils' BrazilianUtils::CurrencyUtils.format_currency(1234.56) # => "1.234,56" BrazilianUtils::CurrencyUtils.number_to_text(1234.56) # => "mil duzentos e trinta e quatro reais..." # Bancos require 'brazilian-utils/bank-utils' BrazilianUtils::BankUtils.get_by_code('341') # => {code: "341", ispb: "60701190", name: "ITAÚ UNIBANCO S.A."} BrazilianUtils::BankUtils.get_by_ispb('00000000') # => {code: "001", ispb: "00000000", name: "Banco do Brasil S.A."} # Conta Bancária require 'brazilian-utils/bank-account-utils' BrazilianUtils::BankAccountUtils.is_valid(bankCode: '001', agency: '1234', account: '123456', digit: 'X') # => true # IBAN require 'brazilian-utils/iban-utils' BrazilianUtils::IBANUtils.is_valid('BR1500000000000010932840814P2') # => true BrazilianUtils::IBANUtils.format('BR1500000000000010932840814P2') # => "BR15 0000 0000 0000 1093 2840 814P 2" # Cartão de Crédito/Débito require 'brazilian-utils/credit-card-utils' BrazilianUtils::CreditCardUtils.is_valid('4111111111111111') # => true (Visa) BrazilianUtils::CreditCardUtils.is_valid('4111111111111112') # => false (falha no dígito de Luhn) # Chave Pix require 'brazilian-utils/pix-key-utils' BrazilianUtils::PixKeyUtils.is_valid('123.456.789-09') # => true BrazilianUtils::PixKeyUtils.get_info('123.456.789-09') # => {type: "cpf", value: "12345678909"} # Payload Pix (BR Code) require 'brazilian-utils/pix-payload-utils' payload = BrazilianUtils::PixPayloadUtils.generate( key: '123.456.789-09', merchantName: 'Fulano de Tal', merchantCity: 'Brasília' ) BrazilianUtils::PixPayloadUtils.is_valid(payload) # => true BrazilianUtils::PixPayloadUtils.get_info(payload) # => {merchantName: "Fulano de Tal", merchantCity: "Brasilia", pointOfInitiation: "static", key: "12345678909"} # Data require 'brazilian-utils/date-utils' BrazilianUtils::DateUtils.is_holiday(Date.new(2024, 1, 1)) # => true BrazilianUtils::DateUtils.is_business_day(Date.new(2024, 3, 4)) # => true BrazilianUtils::DateUtils.add_business_days(Date.new(2024, 3, 1), 1) # => #<Date: 2024-03-04> # CAEPF require 'brazilian-utils/caepf-utils' BrazilianUtils::CAEPFUtils.is_valid('293.118.610/001-84') # => true BrazilianUtils::CAEPFUtils.format('29311861000184') # => "293.118.610/001-84" # CNO require 'brazilian-utils/cno-utils' BrazilianUtils::CNOUtils.is_valid('11.084.01680/62') # => true BrazilianUtils::CNOUtils.format('111130137368') # => "11.113.01373/68" # CEI require 'brazilian-utils/cei-utils' BrazilianUtils::CEIUtils.is_valid('11.583.00249/85') # => true BrazilianUtils::CEIUtils.format('277297118187') # => "27.729.71181/87" # CBO require 'brazilian-utils/cbo-utils' BrazilianUtils::CBOUtils.is_valid('2124-05') # => true BrazilianUtils::CBOUtils.get('212405') # => {code: "212405", description: "Analista de desenvolvimento de sistemas"} # CFOP require 'brazilian-utils/cfop-utils' BrazilianUtils::CFOPUtils.is_valid('5102') # => true BrazilianUtils::CFOPUtils.get('5102')[:description] # => "Venda de mercadoria adquirida ou recebida de terceiros..." # CNAE require 'brazilian-utils/cnae-utils' BrazilianUtils::CNAEUtils.is_valid('6201-5/01') # => true BrazilianUtils::CNAEUtils.get('6201501') # => {code: "6201501", description: "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA"} # NCM require 'brazilian-utils/ncm-utils' BrazilianUtils::NCMUtils.is_valid('2203.00.00') # => true BrazilianUtils::NCMUtils.format('84713012') # => "8471.30.12" # CSOSN require 'brazilian-utils/csosn-utils' BrazilianUtils::CSOSNUtils.is_valid('101') # => true BrazilianUtils::CSOSNUtils.get_description('101') # => "Tributada pelo Simples Nacional com permissão de crédito" # CST (ICMS/IPI/PIS-COFINS) require 'brazilian-utils/cst-utils' BrazilianUtils::CSTUtils.is_valid('110') # => true (ICMS) BrazilianUtils::CSTUtils.is_valid('07', tax: 'pis') # => true # Placa de Veículo require 'brazilian-utils/license-plate-utils' BrazilianUtils::LicensePlateUtils.is_valid('ABC1234') # => true BrazilianUtils::LicensePlateUtils.convert_to_mercosul('ABC1234') # => "ABC1C34" # VIN (Chassi) require 'brazilian-utils/vin-utils' BrazilianUtils::VINUtils.is_valid('1HGCM82633A004352') # => true BrazilianUtils::VINUtils.is_valid('1M8GDM9AXKP042788') # => true (dígito verificador X) # Telefone require 'brazilian-utils/phone-utils' BrazilianUtils::PhoneUtils.is_valid('11987654321') # => true BrazilianUtils::PhoneUtils.format('987654321') # => "98765-4321" BrazilianUtils::PhoneUtils.format('11987654321', mask: :ddd) # => "(11) 98765-4321" # Título de Eleitor require 'brazilian-utils/voter-id-utils' BrazilianUtils::VoterIdUtils.is_valid_voter_id('690847092828') # => true BrazilianUtils::VoterIdUtils.format('690847092828') # => "6908 4709 28 28" BrazilianUtils::VoterIdUtils.generate('SP') # => "123456780140" # DDD require 'brazilian-utils/area-code-utils' BrazilianUtils::AreaCodeUtils.get_info('11') # => {areaCode: 11, stateCode: "SP", stateName: "São Paulo", regionCode: "SE", regionName: "Sudeste", stateCodes: ["SP"]} BrazilianUtils::AreaCodeUtils.list_by_state('SP') # => [11, 12, 13, 14, 15, 16, 17, 18, 19] # Estados (UF) require 'brazilian-utils/state-utils' BrazilianUtils::StateUtils.get_by_ibge_code('35') # => {code: "SP", name: "São Paulo", regionCode: "SE", regionName: "Sudeste", ibgeCode: 35} BrazilianUtils::StateUtils.get_timezone('AM') # => "America/Manaus" # Municípios require 'brazilian-utils/municipality-utils' BrazilianUtils::MunicipalityUtils.get_by_code('3550308') # => {code: "3550308", name: "São Paulo", stateCode: "SP"} BrazilianUtils::MunicipalityUtils.list('DF') # => [{code: "5300108", name: "Brasília", stateCode: "DF"}] # Chave de Acesso NF-e/DF-e require 'brazilian-utils/nfe-key-utils' BrazilianUtils::NfeKeyUtils.is_valid('35170458716523000119550010000000121000123458') # => true BrazilianUtils::NfeKeyUtils.format('35170458716523000119550010000000121000123458') # => "3517 0458 7165 2300 0119 5500 1000 0000 1210 0012 3458" # Números por Extenso require 'brazilian-utils/number-utils' BrazilianUtils::NumberUtils.convert_to_words(123) # => "cento e vinte e três" BrazilianUtils::NumberUtils.convert_to_words(1, gender: :feminine) # => "uma" # Texto require 'brazilian-utils/text-utils' BrazilianUtils::TextUtils.capitalize('fulano de tal') # => "Fulano de Tal" BrazilianUtils::TextUtils.remove_accents('São Paulo') # => "Sao Paulo"
Para exemplos completos de cada utilitário, consulte a pasta examples/.
Principais Módulos:
CPFUtils - Validação e formatação de CPFCNPJUtils - Validação e formatação de CNPJCEPUtils - Validação de CEP e busca de endereçosPhoneUtils - Validação de telefonesLicensePlateUtils - Placas de veículosVoterIdUtils - Títulos de eleitorCurrencyUtils - Formatação de moedaDateUtils - Feriados e datas por extensoEmailUtils - Validação de emailLegalNatureUtils - Natureza jurídicaLegalProcessUtils - Processos judiciaisPISUtils - PIS/PASEPRENAVAMUtils - RENAVAMCNHUtils - CNHTextUtils - Capitalização e remoção de acentosNumberUtils - Números por extensoStateUtils - Estados brasileiros (UF)AreaCodeUtils - DDDsBankUtils - Bancos (código COMPE/ISPB)BankAccountUtils - Contas bancáriasMunicipalityUtils - Municípios (código IBGE)CFOPUtils - CFOPCNAEUtils - CNAECBOUtils - CBONCMUtils - NCMCSOSNUtils - CSOSNCSTUtils - CST (ICMS/IPI/PIS-COFINS)CEIUtils - CEICNOUtils - CNOCNSUtils - Cartão Nacional de SaúdeCAEPFUtils - CAEPFCertidaoUtils - Certidão de registro civilCreditCardUtils - Cartão de crédito/débito (Luhn)VINUtils - Chassi (VIN)PassportUtils - PassaporteIBANUtils - IBAN brasileiroNfeKeyUtils - Chave de acesso NF-e/DF-ePixKeyUtils - Chave PixPixPayloadUtils - Payload Pix (BR Code)RegistroProfissionalUtils - OAB/CRM/CRO/CRP/CRCIEUtils - Inscrição Estadual (IE)BoletoUtils - Boleto bancárioUtilities for working with Brazilian data formats:
gem 'br-utils'
bundle install
# CPF require 'brazilian-utils/cpf-utils' BrazilianUtils::CPFUtils.is_valid('11144477735') # => true BrazilianUtils::CPFUtils.format_cpf('11144477735') # => "111.444.777-35" BrazilianUtils::CPFUtils.generate # => "12345678901" # CNS (National Health Card) require 'brazilian-utils/cns-utils' BrazilianUtils::CNSUtils.is_valid('123456789010000') # => true BrazilianUtils::CNSUtils.format('123456789010001') # => "123 4567 8901 0001" # Passport require 'brazilian-utils/passport-utils' BrazilianUtils::PassportUtils.is_valid('CL125167') # => true BrazilianUtils::PassportUtils.format('acd12736') # => "ACD12736" BrazilianUtils::PassportUtils.generate # => "LB809567" # Civil Registry Certificate require 'brazilian-utils/certidao-utils' BrazilianUtils::CertidaoUtils.is_valid('10453901552013100012021000012321') # => true BrazilianUtils::CertidaoUtils.format('10453901552013100012021000012321') # => "104539 01 55 2013 1 00012 021 0000123 21" BrazilianUtils::CertidaoUtils.get_info('10453901552013100012021000012321') # => {registryCns: "104539", acervo: "01", service: "55", year: 2013, type: "birth", ...} # Professional Registration (OAB/CRM/CRO/CRP/CRC) require 'brazilian-utils/registro-profissional-utils' BrazilianUtils::RegistroProfissionalUtils.is_valid(value: '123456/SP', council: 'OAB') # => true BrazilianUtils::RegistroProfissionalUtils.is_valid(value: '06/12345', council: 'CRP') # => true # CNPJ require 'brazilian-utils/cnpj-utils' BrazilianUtils::CNPJUtils.is_valid('34665388000161') # => true BrazilianUtils::CNPJUtils.format_cnpj('34665388000161') # => "34.665.388/0001-61" # CNPJ v2 (alphanumeric, IN RFB 2.119) BrazilianUtils::CNPJUtils.valid?('12ABC345000188', version: 2) # => true BrazilianUtils::CNPJUtils.generate(version: 2) # => "12ABC345000188" (alphanumeric) # State Registration (IE) require 'brazilian-utils/ie-utils' BrazilianUtils::IEUtils.is_valid('110042490114', 'SP') # => true BrazilianUtils::IEUtils.is_valid('12345678', 'RJ') # => true # CEP (Postal Code) require 'brazilian-utils/cep-utils' BrazilianUtils::CEPUtils.format_cep('01310100') # => "01310-100" BrazilianUtils::CEPUtils.get_address('01310100') # => {...complete address...} # Currency require 'brazilian-utils/currency-utils' BrazilianUtils::CurrencyUtils.format_currency(1234.56) # => "1.234,56" BrazilianUtils::CurrencyUtils.number_to_text(1234.56) # => "mil duzentos e trinta e quatro reais..." # Banks require 'brazilian-utils/bank-utils' BrazilianUtils::BankUtils.get_by_code('341') # => {code: "341", ispb: "60701190", name: "ITAÚ UNIBANCO S.A."} BrazilianUtils::BankUtils.get_by_ispb('00000000') # => {code: "001", ispb: "00000000", name: "Banco do Brasil S.A."} # Bank Account require 'brazilian-utils/bank-account-utils' BrazilianUtils::BankAccountUtils.is_valid(bankCode: '001', agency: '1234', account: '123456', digit: 'X') # => true # IBAN require 'brazilian-utils/iban-utils' BrazilianUtils::IBANUtils.is_valid('BR1500000000000010932840814P2') # => true BrazilianUtils::IBANUtils.format('BR1500000000000010932840814P2') # => "BR15 0000 0000 0000 1093 2840 814P 2" # Credit/Debit Card require 'brazilian-utils/credit-card-utils' BrazilianUtils::CreditCardUtils.is_valid('4111111111111111') # => true (Visa) BrazilianUtils::CreditCardUtils.is_valid('4111111111111112') # => false (Luhn check digit fails) # Pix Key require 'brazilian-utils/pix-key-utils' BrazilianUtils::PixKeyUtils.is_valid('123.456.789-09') # => true BrazilianUtils::PixKeyUtils.get_info('123.456.789-09') # => {type: "cpf", value: "12345678909"} # Pix Payload (BR Code) require 'brazilian-utils/pix-payload-utils' payload = BrazilianUtils::PixPayloadUtils.generate( key: '123.456.789-09', merchantName: 'Fulano de Tal', merchantCity: 'Brasília' ) BrazilianUtils::PixPayloadUtils.is_valid(payload) # => true BrazilianUtils::PixPayloadUtils.get_info(payload) # => {merchantName: "Fulano de Tal", merchantCity: "Brasilia", pointOfInitiation: "static", key: "12345678909"} # Date require 'brazilian-utils/date-utils' BrazilianUtils::DateUtils.is_holiday(Date.new(2024, 1, 1)) # => true BrazilianUtils::DateUtils.is_business_day(Date.new(2024, 3, 4)) # => true BrazilianUtils::DateUtils.add_business_days(Date.new(2024, 3, 1), 1) # => #<Date: 2024-03-04> # CAEPF require 'brazilian-utils/caepf-utils' BrazilianUtils::CAEPFUtils.is_valid('293.118.610/001-84') # => true BrazilianUtils::CAEPFUtils.format('29311861000184') # => "293.118.610/001-84" # CNO require 'brazilian-utils/cno-utils' BrazilianUtils::CNOUtils.is_valid('11.084.01680/62') # => true BrazilianUtils::CNOUtils.format('111130137368') # => "11.113.01373/68" # CEI require 'brazilian-utils/cei-utils' BrazilianUtils::CEIUtils.is_valid('11.583.00249/85') # => true BrazilianUtils::CEIUtils.format('277297118187') # => "27.729.71181/87" # CBO require 'brazilian-utils/cbo-utils' BrazilianUtils::CBOUtils.is_valid('2124-05') # => true BrazilianUtils::CBOUtils.get('212405') # => {code: "212405", description: "Analista de desenvolvimento de sistemas"} # CFOP require 'brazilian-utils/cfop-utils' BrazilianUtils::CFOPUtils.is_valid('5102') # => true BrazilianUtils::CFOPUtils.get('5102')[:description] # => "Venda de mercadoria adquirida ou recebida de terceiros..." # CNAE require 'brazilian-utils/cnae-utils' BrazilianUtils::CNAEUtils.is_valid('6201-5/01') # => true BrazilianUtils::CNAEUtils.get('6201501') # => {code: "6201501", description: "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA"} # NCM require 'brazilian-utils/ncm-utils' BrazilianUtils::NCMUtils.is_valid('2203.00.00') # => true BrazilianUtils::NCMUtils.format('84713012') # => "8471.30.12" # CSOSN require 'brazilian-utils/csosn-utils' BrazilianUtils::CSOSNUtils.is_valid('101') # => true BrazilianUtils::CSOSNUtils.get_description('101') # => "Tributada pelo Simples Nacional com permissão de crédito" # CST (ICMS/IPI/PIS-COFINS) require 'brazilian-utils/cst-utils' BrazilianUtils::CSTUtils.is_valid('110') # => true (ICMS) BrazilianUtils::CSTUtils.is_valid('07', tax: 'pis') # => true # License Plate require 'brazilian-utils/license-plate-utils' BrazilianUtils::LicensePlateUtils.is_valid('ABC1234') # => true BrazilianUtils::LicensePlateUtils.convert_to_mercosul('ABC1234') # => "ABC1C34" # VIN (Chassis) require 'brazilian-utils/vin-utils' BrazilianUtils::VINUtils.is_valid('1HGCM82633A004352') # => true BrazilianUtils::VINUtils.is_valid('1M8GDM9AXKP042788') # => true (check digit is X) # Phone require 'brazilian-utils/phone-utils' BrazilianUtils::PhoneUtils.is_valid('11987654321') # => true BrazilianUtils::PhoneUtils.format('987654321') # => "98765-4321" BrazilianUtils::PhoneUtils.format('11987654321', mask: :ddd) # => "(11) 98765-4321" # Voter ID require 'brazilian-utils/voter-id-utils' BrazilianUtils::VoterIdUtils.is_valid_voter_id('690847092828') # => true BrazilianUtils::VoterIdUtils.format('690847092828') # => "6908 4709 28 28" BrazilianUtils::VoterIdUtils.generate('SP') # => "123456780140" # Area Code (DDD) require 'brazilian-utils/area-code-utils' BrazilianUtils::AreaCodeUtils.get_info('11') # => {areaCode: 11, stateCode: "SP", stateName: "São Paulo", regionCode: "SE", regionName: "Sudeste", stateCodes: ["SP"]} BrazilianUtils::AreaCodeUtils.list_by_state('SP') # => [11, 12, 13, 14, 15, 16, 17, 18, 19] # States (UF) require 'brazilian-utils/state-utils' BrazilianUtils::StateUtils.get_by_ibge_code('35') # => {code: "SP", name: "São Paulo", regionCode: "SE", regionName: "Sudeste", ibgeCode: 35} BrazilianUtils::StateUtils.get_timezone('AM') # => "America/Manaus" # Municipalities require 'brazilian-utils/municipality-utils' BrazilianUtils::MunicipalityUtils.get_by_code('3550308') # => {code: "3550308", name: "São Paulo", stateCode: "SP"} BrazilianUtils::MunicipalityUtils.list('DF') # => [{code: "5300108", name: "Brasília", stateCode: "DF"}] # NF-e/DF-e Access Key require 'brazilian-utils/nfe-key-utils' BrazilianUtils::NfeKeyUtils.is_valid('35170458716523000119550010000000121000123458') # => true BrazilianUtils::NfeKeyUtils.format('35170458716523000119550010000000121000123458') # => "3517 0458 7165 2300 0119 5500 1000 0000 1210 0012 3458" # Number to Words require 'brazilian-utils/number-utils' BrazilianUtils::NumberUtils.convert_to_words(123) # => "cento e vinte e três" BrazilianUtils::NumberUtils.convert_to_words(1, gender: :feminine) # => "uma" # Text require 'brazilian-utils/text-utils' BrazilianUtils::TextUtils.capitalize('fulano de tal') # => "Fulano de Tal" BrazilianUtils::TextUtils.remove_accents('São Paulo') # => "Sao Paulo"
For detailed examples of each utility, check the examples/ folder.
Main Modules:
CPFUtils - CPF validation and formattingCNPJUtils - CNPJ validation and formattingCEPUtils - CEP validation and address lookupPhoneUtils - Phone validationLicensePlateUtils - Vehicle platesVoterIdUtils - Voter IDsCurrencyUtils - Currency formattingDateUtils - Holidays, business days, and date textEmailUtils - Email validationLegalNatureUtils - Legal nature codesLegalProcessUtils - Legal process IDsPISUtils - PIS/PASEPRENAVAMUtils - Vehicle registrationCNHUtils - Driver's licenseTextUtils - Capitalization and accent removalNumberUtils - Numbers to wordsStateUtils - Brazilian states (UF)AreaCodeUtils - Area codes (DDD)BankUtils - Banks (COMPE/ISPB code)BankAccountUtils - Bank accountsMunicipalityUtils - Municipalities (IBGE code)CFOPUtils - CFOPCNAEUtils - CNAECBOUtils - CBONCMUtils - NCMCSOSNUtils - CSOSNCSTUtils - CST (ICMS/IPI/PIS-COFINS)CEIUtils - CEICNOUtils - CNOCNSUtils - National Health CardCAEPFUtils - CAEPFCertidaoUtils - Civil registry certificateCreditCardUtils - Credit/debit card (Luhn)VINUtils - Chassis (VIN)PassportUtils - PassportIBANUtils - Brazilian IBANNfeKeyUtils - NF-e/DF-e access keyPixKeyUtils - Pix keyPixPayloadUtils - Pix payload (BR Code)RegistroProfissionalUtils - OAB/CRM/CRO/CRP/CRCIEUtils - State registration (IE)BoletoUtils - Bank slip (boleto)# Install dependencies bundle install # Run tests bundle exec rspec # Run specific test bundle exec rspec spec/cpf_utils_spec.rb
Most utilities follow these patterns:
Validation:
.is_valid(value) # Main validation method .valid?(value) # Alias for is_valid
Formatting:
.format(value) # Format with standard symbols .remove_symbols(value) # Remove formatting symbols
Generation:
.generate # Generate random valid value
CEP:
get_address(cep) - Fetch address from CEPget_cep_information_from_address(uf, city, street) - Find CEPsPhone:
is_valid(phone, type:) - Validate with type (:mobile or :landline)remove_international_dialing_code(phone) - Remove +55/55License Plate:
convert_to_mercosul(plate) - Convert old format to Mercosulget_format(plate) - Detect format ("LLLNNNN" or "LLLNLNN")Voter ID:
generate(uf) - Generate for specific stateCurrency:
format_currency(value) - Format as X.XXX,XX (pass symbol: true for "R$ X.XXX,XX")number_to_text(value) - Convert to Brazilian Portuguese textDate:
is_holiday(date, uf) - Check if date is holidayconvert_date_to_text(date) - Convert to Portuguese textLegal Nature:
get_description(code) - Get description for codelist_by_category(category) - List codes by category (1-5)Legal Process:
generate(year, orgao) - Generate for specific year and judicial segment# Validate user input cpf = params[:cpf] if BrazilianUtils::CPFUtils.valid?(cpf) # Process valid CPF else errors.add(:cpf, "inválido") end
# Format for display cpf = "11144477735" formatted = BrazilianUtils::CPFUtils.format_cpf(cpf) puts formatted # => "111.444.777-35"
# Generate test data 10.times do cpf = BrazilianUtils::CPFUtils.generate puts BrazilianUtils::CPFUtils.format_cpf(cpf) end
# Lookup address from CEP address = BrazilianUtils::CEPUtils.get_address('01310100') if address puts "#{address.logradouro}, #{address.bairro}" puts "#{address.localidade} - #{address.uf}" end
Contributions are welcome! Please feel free to submit pull requests.
Como contribuir / How to contribute:
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE.txt para detalhes.
This project is licensed under the MIT License - see the LICENSE.txt file for details.
Baseado na implementação Python: brazilian-utils/python
Based on the Python implementation: brazilian-utils/python
brazilian-utils/ruby is a public repo on GitHub by brazilian-utils. Versão Ruby (Gem) do pacote BrazilianUtils.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-09-30. GitHub counts 0 open issues and pull requests. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Automated Integration Testing and Live Documentation for your API
ScanAPI examples
Biblioteca de utilitários projetada para validar, gerar e manipular dados de acordo com as particularidades do Brasil 🇧🇷

Utility library designed to validate, generate, and manipulate data according to Brazil-specific requirements