cpf_cnpj_plus 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da3b0a99c5007b263786ecff3baa97962e733b978c900b43fbe3221a6c6bd29e
-  data.tar.gz: 41d063f24c63805ce0e16cf824537436344166c906f45fcbd04d011519517161
+  metadata.gz: 0be5c78bb01f594041dc6648af5e88c793a37909288d2e805ec4df415b1e80f3
+  data.tar.gz: c44eb35f3cd67072ba120f5c74960b295ba2abf8a902262743c2688f5ca8fad9
 SHA512:
-  metadata.gz: 530da6d176545b6c82b6b9226e2bb43925b76742d35ab66a38826ef3eacba32d90494ebe8447fc49aa3bf332ad01e919f984491d4d3972b376f07f059f02680d
-  data.tar.gz: 39b949f17039432825917e19c595f7b0ec90ccada9d389eef7dfa4f9bc4bac55ce0381d22288339ccacdd40e18c67e84a5ec415ebd95087929e604f4f0295e21
+  metadata.gz: 4437f396b413c092653cd6f1960d5686e392fdb1bc488bb9244b919443d3de9c992d4187ef88f29e88b939a8bc3a086f49d4f71ac53e95b3fa1d8711c97c8a00
+  data.tar.gz: 685071ce041e859639aa0cd3c6091133481c725234b419bd49f18e36761339bcd55455ce751ac01fdf12643f08e8bd7f44f9c3c3976dee0c5bb6986f298bab79

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 ## [Unreleased]
 
+## [0.4.0] - 2026-08-01
+
+- Adicionada API unificada que detecta CPF ou CNPJ pelo tamanho do
+  documento: `CpfCnpjPlus.valid?`, `CpfCnpjPlus.format` e
+  `CpfCnpjPlus.generate(:cpf | :cnpj, alphanumeric:)`.
+- Adicionado `CpfCnpjPlus.alphanumeric_cnpj?`, que identifica se um CNPJ
+  válido já usa o novo padrão alfanumérico (útil para auditar bases de
+  dados antes da migração de julho de 2026).
+- `format_cpf`/`format_cnpj` (e a nova `format`) agora aceitam a opção
+  `strict: true`, que retorna `nil` quando os dígitos verificadores ou a
+  estrutura do documento são inválidos, em vez de formatar um documento
+  incorreto silenciosamente.
+- Adicionado validador opcional para ActiveModel/Rails
+  (`require "cpf_cnpj_plus/active_model_validator"`), permitindo
+  `validates :campo, cpf_cnpj: true` (ou `type: :cpf`/`type: :cnpj`) em
+  models. Não é carregado por padrão e não adiciona `activemodel` como
+  dependência de runtime.
+- Testes adicionados para todas as features acima (100% de cobertura de
+  linhas).
+
+## [0.3.1] - 2026-08-01
+
+- Corrigido `exe/cnpj_plus --check`, que chamava um método inexistente
+  (`CpfCnpjPlus.valid?`) e quebrava com `NoMethodError`; agora usa
+  `valid_cnpj?`.
+- Corrigida a rejeição de CNPJs alfanuméricos "conhecidamente inválidos":
+  antes só bases numéricas com todos os dígitos iguais eram rejeitadas;
+  agora qualquer base de 12 caracteres repetidos é rejeitada, incluindo
+  letras (ex.: `"AAAAAAAAAAAA45"`).
+- Removida dependência morta de `byebug` nos specs do validator, que
+  quebrava `bundle exec rspec` em ambiente limpo (CI).
+- Corrigido o workflow de CI, que disparava em push apenas na branch
+  `master` e nunca era executado em `main`.
+- Corrigida a documentação do README, que citava um método
+  `CpfCnpjPlus.generate` inexistente (o correto é `generate_cpf`/`generate_cnpj`).
+- Adicionados testes para os casos acima e para os executáveis
+  `cnpj_plus`/`cpf_plus`.
+
 ## [0.1.0] - 2025-07-06
 
 - Initial release

data/README.md

@@ -1,6 +1,10 @@
 # CPF CNPJ Plus
 
-**cpf_cnpj_plus** é uma biblioteca Ruby para **validar, gerar e formatar** números de CPF e CNPJ brasileiros, tanto via código Ruby quanto pela linha de comando.
+[![Gem Version](https://img.shields.io/gem/v/cpf_cnpj_plus.svg)](https://rubygems.org/gems/cpf_cnpj_plus)
+[![Ruby](https://github.com/DougNeo/cpf_cnpj_plus/actions/workflows/main.yml/badge.svg)](https://github.com/DougNeo/cpf_cnpj_plus/actions/workflows/main.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
+
+**cpf_cnpj_plus** é uma biblioteca Ruby para **validar, gerar e formatar** números de CPF e CNPJ brasileiros. Funciona em **Ruby puro** (sem dependências de runtime), tem um **validador opcional para Rails/ActiveModel**, e oferece **ferramentas de linha de comando**.
 
 ---
 
@@ -40,22 +44,57 @@ A gem oferece uma API unificada para CPF e CNPJ. Exemplos:
 ```ruby
 require "cpf_cnpj_plus"
 
-CPF
+# CPF
 CpfCnpjPlus.valid_cpf?("123.456.789-09") # => true ou false
 CpfCnpjPlus.format_cpf("12345678909") # => "123.456.789-09"
-CpfCnpjPlus.generate # => Gera um CPF válido
+CpfCnpjPlus.generate_cpf # => Gera um CPF válido
 
-CNPJ
+# CNPJ
 CpfCnpjPlus.valid_cnpj?("12.345.678/0001-95") # => true ou false
 CpfCnpjPlus.format_cnpj("12345678000195") # => "12.345.678/0001-95"
-CpfCnpjPlus.generate # => Gera um CNPJ válido
+CpfCnpjPlus.generate_cnpj # => Gera um CNPJ válido
+
+# CNPJ Alfanumérico (novo formato)
+CpfCnpjPlus.valid_cnpj?("12.ABC.345/01DE-35") # => true
+CpfCnpjPlus.format_cnpj("12ABC34501DE35") # => "12.ABC.345/01DE-35"
+CpfCnpjPlus.generate_cnpj(alphanumeric: true) # => Gera um CNPJ alfanumérico válido
+CpfCnpjPlus.alphanumeric_cnpj?("12ABC34501DE35") # => true (identifica se já usa o novo padrão)
+
+# API unificada (detecta CPF ou CNPJ pelo tamanho do documento)
+CpfCnpjPlus.valid?("123.456.789-09")   # => true ou false
+CpfCnpjPlus.valid?("12.345.678/0001-95") # => true ou false
+CpfCnpjPlus.format("12345678909")      # => "123.456.789-09"
+CpfCnpjPlus.format("12345678000195")   # => "12.345.678/0001-95"
+CpfCnpjPlus.generate(:cpf)             # => Gera um CPF válido
+CpfCnpjPlus.generate(:cnpj, alphanumeric: true) # => Gera um CNPJ alfanumérico válido
+
+# Formatação estrita (retorna nil se os dígitos verificadores forem inválidos)
+CpfCnpjPlus.format_cpf("12345678900", strict: true)   # => nil (dígitos verificadores errados)
+CpfCnpjPlus.format_cnpj("12345678000199", strict: true) # => nil (dígitos verificadores errados)
+```
+
+### Validação em Rails/ActiveModel
+
+A gem também traz um validador opcional para uso com `ActiveModel::Validations`
+(inclusive em models Rails). Ele **não** é carregado junto com
+`require "cpf_cnpj_plus"` — é preciso requerê-lo explicitamente, e `activemodel`
+precisa estar disponível na sua aplicação:
+
+```ruby
+require "cpf_cnpj_plus/active_model_validator"
+
+class Empresa
+  include ActiveModel::Model
+  attr_accessor :cnpj, :cpf
 
-CNPJ Alfanumérico (novo formato)
-CpfCnpjPlus.valid_cnpj?("A1234567B00195") # => true ou false
-CpfCnpjPlus.format_cnpj("A1234567B00195") # => "A1.234.567/B001-95"
-CpfCnpjPlus.generate(alphanumeric: true) # => Gera um CNPJ alfanumérico válido
+  validates :cnpj, cpf_cnpj: { type: :cnpj }  # aceita CNPJ numérico ou alfanumérico
+  validates :cpf, cpf_cnpj: { type: :cpf }
+  # ou, para detectar o tipo automaticamente pelo tamanho:
+  # validates :documento, cpf_cnpj: true
+end
 ```
 
+Suporta as opções padrão do Rails (`allow_nil`, `allow_blank`, `message`).
 
 ### Linha de comando
 
@@ -66,21 +105,27 @@ $ cpf_plus --check 123.456.789-09
 $ cpf_plus --format 12345678909
 $ cpf_plus --generate
 $ cnpj_plus --check 12.345.678/0001-95
-$ cnpj_plus --check A12.345.67B/0019-5
+$ cnpj_plus --check 12.ABC.345/01DE-35
 $ cnpj_plus --generate
 ```
 
 ## Compatibilidade
 
-- Ruby >= 3.1.0
+- Ruby >= 3.1.0 (testado em CI nas versões 3.1, 3.2, 3.3, 3.4 e 4.0).
+- Sem dependências de runtime — funciona em qualquer projeto Ruby puro.
+- Uso com Rails/ActiveModel é opcional: só é necessário se você requerer
+  `cpf_cnpj_plus/active_model_validator` (veja a seção "Validação em
+  Rails/ActiveModel" acima).
 
 ## Contribuição
 
 1. Faça um fork do projeto
 2. Crie sua branch (`git checkout -b minha-feature`)
-3. Commit suas alterações (`git commit -am 'Adiciona nova feature'`)
-4. Faça push para a branch (`git push origin minha-feature`)
-5. Abra um Pull Request
+3. Rode `bundle install` e depois `bundle exec rake` (specs + rubocop) para
+   garantir que tudo continua passando
+4. Commit suas alterações (`git commit -am 'Adiciona nova feature'`)
+5. Faça push para a branch (`git push origin minha-feature`)
+6. Abra um Pull Request
 
 ## Licença
 

data/exe/cnpj_plus

@@ -14,7 +14,7 @@ OptionParser.new do |opts|
 end.parse!
 
 if options[:check]
-  valid = CpfCnpjPlus.valid?(options[:check])
+  valid = CpfCnpjPlus.valid_cnpj?(options[:check])
   puts valid ? "✅ CNPJ válido" : "❌ CNPJ inválido"
 elsif options[:format]
   result = CpfCnpjPlus.format_cnpj(options[:format])

data/lib/cpf_cnpj_plus/active_model_validator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "active_model"
+require_relative "../cpf_cnpj_plus"
+
+# Validador ActiveModel opcional. Não é carregado por padrão junto com a gem —
+# quem quiser usar em um model Rails/ActiveModel deve fazer:
+#
+#   require "cpf_cnpj_plus/active_model_validator"
+#
+#   class Empresa
+#     include ActiveModel::Model
+#     attr_accessor :cnpj
+#
+#     validates :cnpj, cpf_cnpj: true                # detecta CPF ou CNPJ pelo tamanho
+#     validates :cnpj, cpf_cnpj: { type: :cnpj }      # aceita só CNPJ (numérico ou alfanumérico)
+#     validates :cpf,  cpf_cnpj: { type: :cpf }       # aceita só CPF
+#   end
+class CpfCnpjValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    return if options[:allow_nil] && value.nil?
+    return if options[:allow_blank] && (value.nil? || value.to_s.strip.empty?)
+
+    record.errors.add(attribute, options.fetch(:message, :invalid)) unless valid_document?(value)
+  end
+
+  private
+
+  def valid_document?(value)
+    case options[:type]&.to_sym
+    when :cpf then CpfCnpjPlus.valid_cpf?(value)
+    when :cnpj then CpfCnpjPlus.valid_cnpj?(value)
+    when nil then CpfCnpjPlus.valid?(value)
+    else
+      raise ArgumentError, "type deve ser :cpf ou :cnpj (recebido: #{options[:type].inspect})"
+    end
+  end
+end

data/lib/cpf_cnpj_plus/formatter/cnpj.rb

@@ -6,11 +6,12 @@ module CpfCnpjPlus
     # Suporta o formato numérico tradicional e o novo formato alfanumérico,
     # aplicando a máscara padrão XX.XXX.XXX/XXXX-XX.
     class Cnpj
-      def self.format(cnpj)
-        cnpj = cnpj.to_s.upcase.gsub(/[^A-Z0-9]/, "")
-        return nil unless cnpj.length == 14
+      def self.format(cnpj, strict: false)
+        cleaned = cnpj.to_s.upcase.gsub(/[^A-Z0-9]/, "")
+        return nil unless cleaned.length == 14
+        return nil if strict && !Validator::Cnpj.valid?(cleaned)
 
-        "#{cnpj[0..1]}.#{cnpj[2..4]}.#{cnpj[5..7]}/#{cnpj[8..11]}-#{cnpj[12..13]}"
+        "#{cleaned[0..1]}.#{cleaned[2..4]}.#{cleaned[5..7]}/#{cleaned[8..11]}-#{cleaned[12..13]}"
       end
     end
   end

data/lib/cpf_cnpj_plus/formatter/cpf.rb

@@ -5,11 +5,12 @@ module CpfCnpjPlus
     # Responsável por formatar números de CPF para exibição.
     # Aplica a máscara padrão XXX.XXX.XXX-XX a partir de uma string numérica.
     class Cpf
-      def self.format(cpf)
-        cpf = cpf.to_s.gsub(/[^0-9]/, "")
-        return nil unless cpf.length == 11
+      def self.format(cpf, strict: false)
+        cleaned = cpf.to_s.gsub(/[^0-9]/, "")
+        return nil unless cleaned.length == 11
+        return nil if strict && !Validator::Cpf.valid?(cleaned)
 
-        "#{cpf[0..2]}.#{cpf[3..5]}.#{cpf[6..8]}-#{cpf[9..10]}"
+        "#{cleaned[0..2]}.#{cleaned[3..5]}.#{cleaned[6..8]}-#{cleaned[9..10]}"
       end
     end
   end

data/lib/cpf_cnpj_plus/validator/cnpj.rb

@@ -57,11 +57,14 @@ module CpfCnpjPlus
         digit
       end
 
+      def self.alphanumeric?(cnpj)
+        cnpj = normalize(cnpj)
+        valid?(cnpj) && cnpj[0..11].match?(/[A-Z]/)
+      end
+
       def self.cnpj_not_valid?(cnpj)
-        cnpj = cnpj.to_s.gsub(/[^0-9]/, "")
-        %w[00000000000000 11111111111111 22222222222222 33333333333333
-           44444444444444 55555555555555 66666666666666 77777777777777
-           88888888888888 99999999999999].include?(cnpj)
+        base = cnpj.to_s[0..11]
+        base.to_s.length == 12 && base.chars.uniq.length == 1
       end
     end
   end

data/lib/cpf_cnpj_plus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CpfCnpjPlus
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/cpf_cnpj_plus.rb

@@ -16,8 +16,8 @@ module CpfCnpjPlus
     CpfCnpjPlus::Validator::Cpf.valid?(cpf)
   end
 
-  def self.format_cpf(cpf)
-    CpfCnpjPlus::Formatter::Cpf.format(cpf)
+  def self.format_cpf(cpf, strict: false)
+    CpfCnpjPlus::Formatter::Cpf.format(cpf, strict: strict)
   end
 
   def self.generate_cpf
@@ -30,11 +30,49 @@ module CpfCnpjPlus
     CpfCnpjPlus::Validator::Cnpj.valid?(cnpj)
   end
 
-  def self.format_cnpj(cnpj)
-    CpfCnpjPlus::Formatter::Cnpj.format(cnpj)
+  def self.format_cnpj(cnpj, strict: false)
+    CpfCnpjPlus::Formatter::Cnpj.format(cnpj, strict: strict)
   end
 
   def self.generate_cnpj(alphanumeric: false)
     CpfCnpjPlus::Generator::Cnpj.generate(alphanumeric: alphanumeric)
   end
+
+  def self.alphanumeric_cnpj?(cnpj)
+    CpfCnpjPlus::Validator::Cnpj.alphanumeric?(cnpj)
+  end
+
+  # API unificada (detecta CPF ou CNPJ pelo tamanho do documento)
+
+  def self.valid?(doc)
+    case document_type(doc)
+    when :cpf then valid_cpf?(doc)
+    when :cnpj then valid_cnpj?(doc)
+    else false
+    end
+  end
+
+  def self.format(doc, strict: false)
+    case document_type(doc)
+    when :cpf then format_cpf(doc, strict: strict)
+    when :cnpj then format_cnpj(doc, strict: strict)
+    end
+  end
+
+  def self.generate(type, alphanumeric: false)
+    case type.to_s.downcase
+    when "cpf" then generate_cpf
+    when "cnpj" then generate_cnpj(alphanumeric: alphanumeric)
+    else
+      raise ArgumentError, "type deve ser :cpf ou :cnpj (recebido: #{type.inspect})"
+    end
+  end
+
+  def self.document_type(doc)
+    case doc.to_s.upcase.gsub(/[^A-Z0-9]/, "").length
+    when 11 then :cpf
+    when 14 then :cnpj
+    end
+  end
+  private_class_method :document_type
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cpf_cnpj_plus
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - DougNeo
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -23,10 +37,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: |-
-  Fornece métodos práticos para validar, gerar e formatar números de CPF e CNPJ, incluindo
-                          ferramentas de linha de comando para facilitar integrações em sistemas bancários,
-                          governamentais e aplicações Ruby em geral.
+description: Fornece métodos práticos para validar, gerar e formatar números de CPF
+  e CNPJ (incluindo o novo CNPJ alfanumérico), com API para Ruby puro, validador opcional
+  para Rails/ActiveModel e ferramentas de linha de comando.
 email:
 - doug.neo@gmail.com
 executables:
@@ -35,7 +48,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".byebug_history"
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
@@ -46,6 +58,7 @@ files:
 - exe/cnpj_plus
 - exe/cpf_plus
 - lib/cpf_cnpj_plus.rb
+- lib/cpf_cnpj_plus/active_model_validator.rb
 - lib/cpf_cnpj_plus/formatter.rb
 - lib/cpf_cnpj_plus/formatter/cnpj.rb
 - lib/cpf_cnpj_plus/formatter/cpf.rb
@@ -62,7 +75,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/DougNeo/cpf_cnpj_plus
+  rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/DougNeo/cpf_cnpj_plus
   changelog_uri: https://github.com/DougNeo/cpf_cnpj_plus/blob/main/CHANGELOG.md
 rdoc_options: []

data/.byebug_history

@@ -1,4 +0,0 @@
-c
-described_class.valid_cpf?("10321255780")
-described_class.valid_cpf?("103.212.557-80")
-described_class.valid_cpf?("10321255780")