cpf_cnpj_plus 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3471ac722167a65351c70e1e5d5cc0942bd915ba0420eaef56050778bc05809b
-  data.tar.gz: d108eadcb37093bccfe1aca2b5ce65c5c4a1bfad4ebdb312a0d111fca8e0ff95
+  metadata.gz: da3b0a99c5007b263786ecff3baa97962e733b978c900b43fbe3221a6c6bd29e
+  data.tar.gz: 41d063f24c63805ce0e16cf824537436344166c906f45fcbd04d011519517161
 SHA512:
-  metadata.gz: d4aa54004da35e9333beb2fdfce720ffec85f171cee7beb9d1204e27c576dddd7d319659581ed20569810c73468fe84c5633674536b3fa6870bee22b76c0e499
-  data.tar.gz: 22d11338440ada66d77bd93d05b74297a6a10642f25f7e634d93b44b595e6b08c55ffe06cdb5ca5f74305e44133f3f6f54d32a09001850a084a30c98b57f39be
+  metadata.gz: 530da6d176545b6c82b6b9226e2bb43925b76742d35ab66a38826ef3eacba32d90494ebe8447fc49aa3bf332ad01e919f984491d4d3972b376f07f059f02680d
+  data.tar.gz: 39b949f17039432825917e19c595f7b0ec90ccada9d389eef7dfa4f9bc4bac55ce0381d22288339ccacdd40e18c67e84a5ec415ebd95087929e604f4f0295e21

data/.rubocop.yml

@@ -6,3 +6,6 @@ Style/StringLiterals:
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Metrics/BlockLength:
+  Max: 60

data/CHANGELOG.md

@@ -9,5 +9,12 @@
 
 - Adjustment to be able to create the two new generation and formatting methods
 
+## [0.3.0] - 2026-04-27
+
+- Added the `generate_cpf` method to generate valid CPF numbers.
+- Added the `generate_cnpj` method to generate valid CNPJ numbers.
+- Added the `format_cpf` method to format CPF numbers in the standard format (XXX.XXX.XXX-XX).
+- Added the `format_cnpj` method to format CNPJ numbers in the standard format (XX.XXX.XXX/XXXX-XX).
+- Updated the README.md file to include examples of the new generation and formatting methods.
 
 

data/README.md

@@ -46,14 +46,14 @@ CpfCnpjPlus.format_cpf("12345678909") # => "123.456.789-09"
 CpfCnpjPlus.generate # => Gera um CPF válido
 
 CNPJ
-CpfCnpjPlus.valid?("12.345.678/0001-95") # => true ou false
+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
 
 CNPJ Alfanumérico (novo formato)
-CpfCnpjPlus.valid?("A1234567B00195") # => true ou false
-CpfCnpjPlus.format_cnpj("A1234567B00195") # => "A12.345.67B/0019-5"
-CpfCnpjPlus.generate # => Gera um CNPJ alfanumérico válido
+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
 ```
 
 

data/exe/cnpj_plus

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../lib/cpf_cnpj_plus"
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Uso: cnpj_plus [opções]"
+  opts.on("--check CNPJ",    "Valida um CNPJ (numérico ou alfanumérico)") { |v| options[:check]  = v }
+  opts.on("--format CNPJ",   "Formata um CNPJ")                           { |v| options[:format] = v }
+  opts.on("--generate",      "Gera um CNPJ numérico válido")              { options[:generate] = true }
+  opts.on("--alphanumeric",  "Gera um CNPJ alfanumérico (com --generate)") { options[:alphanumeric] = true }
+end.parse!
+
+if options[:check]
+  valid = CpfCnpjPlus.valid?(options[:check])
+  puts valid ? "✅ CNPJ válido" : "❌ CNPJ inválido"
+elsif options[:format]
+  result = CpfCnpjPlus.format_cnpj(options[:format])
+  puts result || "❌ CNPJ inválido para formatação"
+elsif options[:generate]
+  puts CpfCnpjPlus.generate_cnpj(alphanumeric: options[:alphanumeric] || false)
+else
+  puts "Use --help para ver as opções disponíveis."
+end

data/exe/cpf_plus

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../lib/cpf_cnpj_plus"
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Uso: cpf_plus [opções]"
+  opts.on("--check CPF",    "Valida um CPF")    { |v| options[:check]  = v }
+  opts.on("--format CPF",   "Formata um CPF")   { |v| options[:format] = v }
+  opts.on("--generate",     "Gera um CPF válido") { options[:generate] = true }
+end.parse!
+
+if options[:check]
+  valid = CpfCnpjPlus.valid_cpf?(options[:check])
+  puts valid ? "✅ CPF válido" : "❌ CPF inválido"
+elsif options[:format]
+  result = CpfCnpjPlus.format_cpf(options[:format])
+  puts result || "❌ CPF inválido para formatação"
+elsif options[:generate]
+  puts CpfCnpjPlus.generate_cpf
+else
+  puts "Use --help para ver as opções disponíveis."
+end

data/lib/cpf_cnpj_plus/formatter/cnpj.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  module Formatter
+    # Responsável por formatar números de CNPJ para exibição.
+    # 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
+
+        "#{cnpj[0..1]}.#{cnpj[2..4]}.#{cnpj[5..7]}/#{cnpj[8..11]}-#{cnpj[12..13]}"
+      end
+    end
+  end
+end

data/lib/cpf_cnpj_plus/formatter/cpf.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  module Formatter
+    # 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
+
+        "#{cpf[0..2]}.#{cpf[3..5]}.#{cpf[6..8]}-#{cpf[9..10]}"
+      end
+    end
+  end
+end

data/lib/cpf_cnpj_plus/formatter.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  # Módulo responsável por agrupar formatadores de CPF e CNPJ.
+  # Fornece métodos e classes auxiliares para formatação de documentos brasileiros,
+  # incluindo suporte a formatos tradicionais e CNPJ alfanumérico.
+  module Formatter
+    require_relative "formatter/cnpj"
+    require_relative "formatter/cpf"
+  end
+end

data/lib/cpf_cnpj_plus/generator/cnpj.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  module Generator
+    # Responsável por gerar números de CNPJ válidos aleatoriamente.
+    # Suporta geração no formato numérico tradicional e no novo formato
+    # alfanumérico, calculando os dígitos verificadores conforme a Receita Federal.
+    class Cnpj
+      DIGITS = ("0".."9").to_a.freeze
+      LETTERS = ("A".."Z").to_a.freeze
+      ALPHANUMERIC = (DIGITS + LETTERS).freeze
+
+      WEIGHTS_1D = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+      WEIGHTS_2D = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      def self.generate(alphanumeric: false)
+        loop do
+          base = build_base(alphanumeric)
+          cnpj = build_cnpj(base)
+          return cnpj unless Validator::Cnpj.cnpj_not_valid?(cnpj)
+        end
+      end
+
+      def self.build_base(alphanumeric)
+        if alphanumeric
+          # Garante ao menos uma letra para ser genuinamente alfanumérico
+          base = Array.new(12) { ALPHANUMERIC.sample }
+          base[rand(0..11)] = LETTERS.sample
+          base
+        else
+          Array.new(12) { DIGITS.sample }
+        end
+      end
+
+      def self.build_cnpj(base)
+        values = base.map { |c| char_to_value(c) }
+        d1 = calculate_digit(values, WEIGHTS_1D)
+        d2 = calculate_digit(values + [d1], WEIGHTS_2D)
+        base.join + "#{d1}#{d2}"
+      end
+
+      def self.char_to_value(char)
+        char.ord - 48
+      end
+
+      def self.calculate_digit(values, weights)
+        soma = weights.each_with_index.sum { |w, i| values[i] * w }
+        result = (soma * 10) % 11
+        result == 10 ? 0 : result
+      end
+    end
+  end
+end

data/lib/cpf_cnpj_plus/generator/cpf.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  module Generator
+    # Responsável por gerar números de CPF válidos aleatoriamente.
+    # Calcula os dígitos verificadores conforme o algoritmo oficial da Receita Federal.
+    class Cpf
+      def self.generate
+        loop do
+          base = Array.new(9) { rand(0..9) }
+          cpf = build_cpf(base)
+          return cpf unless Validator::Cpf.cpf_not_valid?(cpf)
+        end
+      end
+
+      def self.build_cpf(base)
+        d1 = calculate_digit(base, (2..10).to_a.reverse)
+        d2 = calculate_digit(base + [d1], (2..11).to_a.reverse)
+        (base + [d1, d2]).join
+      end
+
+      def self.calculate_digit(digits, weights)
+        soma = digits.each_with_index.sum { |d, i| d * weights[i] }
+        result = (soma * 10) % 11
+        result == 10 ? 0 : result
+      end
+    end
+  end
+end

data/lib/cpf_cnpj_plus/generator.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CpfCnpjPlus
+  # Módulo responsável por agrupar geradores de CPF e CNPJ.
+  # Fornece métodos e classes auxiliares para geração de documentos brasileiros,
+  # incluindo suporte a formatos tradicionais e CNPJ alfanumérico.
+  module Generator
+    require_relative "generator/cnpj"
+    require_relative "generator/cpf"
+  end
+end

data/lib/cpf_cnpj_plus/validator/cnpj.rb

@@ -8,7 +8,7 @@ module CpfCnpjPlus
       def self.valid?(cnpj)
         cnpj = normalize(cnpj)
         return false unless valid_length?(cnpj)
-        return false if cpj_not_valid?(cnpj)
+        return false if cnpj_not_valid?(cnpj)
         return false unless valid_structure?(cnpj)
 
         base = cnpj[0..11].chars.map { |c| char_to_value(c) }
@@ -30,13 +30,7 @@ module CpfCnpjPlus
       end
 
       def self.char_to_value(char)
-        if ("0".."9").include?(char)
-          char.ord - 48
-        elsif ("A".."Z").include?(char)
-          char.ord - 48 # Ajuste para A=10, B=11, ..., Z=35
-        else
-          raise ArgumentError, "Caractere inválido"
-        end
+        char.ord - 48
       end
 
       def self.calculate_cnpj_digits(base)
@@ -63,7 +57,7 @@ module CpfCnpjPlus
         digit
       end
 
-      def self.cpj_not_valid?(cnpj)
+      def self.cnpj_not_valid?(cnpj)
         cnpj = cnpj.to_s.gsub(/[^0-9]/, "")
         %w[00000000000000 11111111111111 22222222222222 33333333333333
            44444444444444 55555555555555 66666666666666 77777777777777

data/lib/cpf_cnpj_plus/validator/cpf.rb

@@ -8,36 +8,35 @@ module CpfCnpjPlus
       def self.valid?(cpf)
         cpf = cpf.to_s.gsub(/[^0-9]/, "")
         return false unless cpf.length == 11 && cpf =~ /^\d{11}$/
-        return false if cpj_not_valid?(cpf)
+        return false if cpf_not_valid?(cpf)
 
         first_digit(cpf) && second_digit(cpf)
       end
 
       def self.first_digit(cpf)
-        first_digit = cpf[0..8]
+        base_digits = cpf[0..8]
         soma = 0
         ponteiro = 10
-        first_digit.chars.each do |char|
-          res = (char.to_i * ponteiro)
-          soma += res
+        base_digits.chars.each do |char|
+          soma += char.to_i * ponteiro
           ponteiro -= 1
         end
-        soma * 10 % 11 == cpf[9].to_i
+        result = soma * 10 % 11
+        result == cpf[9].to_i || (result == 10 && cpf[9].to_i.zero?)
       end
 
       def self.second_digit(cpf)
-        second_digit = cpf[0..9]
+        base_digits = cpf[0..9]
         soma = 0
         ponteiro = 11
-        second_digit.chars.each do |char|
-          res = (char.to_i * ponteiro)
-          soma += res
+        base_digits.chars.each do |char|
+          soma += char.to_i * ponteiro
           ponteiro -= 1
         end
         soma * 10 % 11 == cpf[10].to_i || (soma * 10 % 11 == 10 && cpf[10].to_i.zero?)
       end
 
-      def self.cpj_not_valid?(cpf)
+      def self.cpf_not_valid?(cpf)
         cpf = cpf.to_s.gsub(/[^0-9]/, "")
         %w[00000000000 11111111111 22222222222 33333333333
            44444444444 55555555555 66666666666

data/lib/cpf_cnpj_plus/validator.rb

@@ -3,7 +3,7 @@
 module CpfCnpjPlus
   # Módulo responsável por agrupar validadores de CPF e CNPJ.
   # Fornece métodos e classes auxiliares para validação de documentos brasileiros,
-  # incluindo suporte a formatos tradicionais e futuros (como CNPJ alfanumérico).
+  # incluindo suporte a formatos tradicionais e CNPJ alfanumérico.
   module Validator
     require_relative "validator/cnpj"
     require_relative "validator/cpf"

data/lib/cpf_cnpj_plus/version.rb

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

data/lib/cpf_cnpj_plus.rb

@@ -2,6 +2,8 @@
 
 require_relative "cpf_cnpj_plus/version"
 require_relative "cpf_cnpj_plus/validator"
+require_relative "cpf_cnpj_plus/formatter"
+require_relative "cpf_cnpj_plus/generator"
 
 # Módulo principal da gem cpf_cnpj_plus.
 # Fornece métodos para validação, geração e formatação de CPFs e CNPJs,
@@ -9,27 +11,30 @@ require_relative "cpf_cnpj_plus/validator"
 module CpfCnpjPlus
   class Error < StandardError; end
 
-  def self.valid_cnpj?(cnpj)
-    CpfCnpjPlus::Validator::Cnpj.valid?(cnpj)
-  end
-
+  # CPF
   def self.valid_cpf?(cpf)
     CpfCnpjPlus::Validator::Cpf.valid?(cpf)
   end
 
   def self.format_cpf(cpf)
-    CpfCnpjPlus::Format::Cpf.format(cpf)
+    CpfCnpjPlus::Formatter::Cpf.format(cpf)
   end
 
-  def self.format_cnpj(cnpj)
-    CpfCnpjPlus::Format::Cnpj.format(cnpj)
+  def self.generate_cpf
+    CpfCnpjPlus::Generator::Cpf.generate
   end
 
-  def self.generate_cpf
-    CpfCnpjPlus::Generate::Cpf.generate
+  # CNPJ
+
+  def self.valid_cnpj?(cnpj)
+    CpfCnpjPlus::Validator::Cnpj.valid?(cnpj)
+  end
+
+  def self.format_cnpj(cnpj)
+    CpfCnpjPlus::Formatter::Cnpj.format(cnpj)
   end
 
-  def self.generate_cnpj
-    CpfCnpjPlus::Generate::Cnpj.generate
+  def self.generate_cnpj(alphanumeric: false)
+    CpfCnpjPlus::Generator::Cnpj.generate(alphanumeric: alphanumeric)
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: cpf_cnpj_plus
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - DougNeo
 bindir: exe
 cert_chain: []
-date: 2025-07-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simplecov
@@ -29,7 +29,9 @@ description: |-
                           governamentais e aplicações Ruby em geral.
 email:
 - doug.neo@gmail.com
-executables: []
+executables:
+- cnpj_plus
+- cpf_plus
 extensions: []
 extra_rdoc_files: []
 files:
@@ -41,20 +43,28 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- exe/cnpj_plus
+- exe/cpf_plus
 - lib/cpf_cnpj_plus.rb
+- lib/cpf_cnpj_plus/formatter.rb
+- lib/cpf_cnpj_plus/formatter/cnpj.rb
+- lib/cpf_cnpj_plus/formatter/cpf.rb
+- lib/cpf_cnpj_plus/generator.rb
+- lib/cpf_cnpj_plus/generator/cnpj.rb
+- lib/cpf_cnpj_plus/generator/cpf.rb
 - lib/cpf_cnpj_plus/validator.rb
 - lib/cpf_cnpj_plus/validator/cnpj.rb
 - lib/cpf_cnpj_plus/validator/cpf.rb
 - lib/cpf_cnpj_plus/version.rb
 - sig/cpf_cnpj_plus.rbs
-homepage: https://github.com/DougNeo/cpf_cnpj_plus.git
+homepage: https://github.com/DougNeo/cpf_cnpj_plus
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/DougNeo/cpf_cnpj_plus.git
-  source_code_uri: https://github.com/DougNeo/cpf_cnpj_plus.git
-  changelog_uri: https://github.com/DougNeo/cpf_cnpj_plus.git/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/DougNeo/cpf_cnpj_plus
+  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: []
 require_paths:
 - lib
@@ -69,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.5
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Validação, geração e formatação de números de CPF e CNPJ para o Brasil.
 test_files: []