cpf_cnpj_plus 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0205bbfedea020597d02606a1dd67e642278d11cca9f66b1aa798a136326bda
-  data.tar.gz: 0712a0959fe535b47d1d03c7f9a0493248354f242a6dd0b29d0a4716d8bd9dcb
+  metadata.gz: da3b0a99c5007b263786ecff3baa97962e733b978c900b43fbe3221a6c6bd29e
+  data.tar.gz: 41d063f24c63805ce0e16cf824537436344166c906f45fcbd04d011519517161
 SHA512:
-  metadata.gz: 4dd053dc269c7868957eea4fef508713e41022b31f9bc60ea40cfa1d0d928df60f7624c6e35fa5dd057912663640be2b36a2b7a23030475793507af0425f27cc
-  data.tar.gz: c84da6e355ed10be01f01745de51b5dac6f781d5a64bcd6cd60bc9e3772b3a15ebb0674065d9c666db5abc1e28cc39927c29b6927501f6c0fce3656d8d11fe3a
+  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

@@ -5,5 +5,16 @@
 - Initial release
 - Basic functionality for CPF and CNPJ validation.
 
+## [0.2.0] - 2025-07-07
+
+- 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

@@ -41,19 +41,19 @@ A gem oferece uma API unificada para CPF e CNPJ. Exemplos:
 require "cpf_cnpj_plus"
 
 CPF
-CPFPlus.format("12345678909") # => "123.456.789-09"
-CPFPlus.valid?("123.456.789-09") # => true ou false
-CPFPlus.generate # => Gera um CPF válido
+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
 
 CNPJ
-CNPJPlus.format("12345678000195") # => "12.345.678/0001-95"
-CNPJPlus.valid?("12.345.678/0001-95") # => true ou false
-CNPJPlus.generate # => Gera um CNPJ válido
+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)
-CNPJPlus.valid?("A1234567B00195") # => true ou false
-CNPJPlus.format("A1234567B00195") # => "A12.345.67B/0019-5"
-CNPJPlus.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

@@ -1,36 +1,44 @@
+# frozen_string_literal: true
+
 module CpfCnpjPlus
   module Validator
+    # Responsável por validar, formatar e manipular números de CNPJ.
+    # Inclui métodos para checagem de validade, geração e formatação.
     class Cnpj
       def self.valid?(cnpj)
-        cnpj = cnpj.to_s.upcase.gsub(/[^A-Z0-9]/, "")
-        return false unless cnpj.length == 14
-        return false if cpj_not_valid?(cnpj)
-        return false unless cnpj[0..11] =~ /^[A-Z0-9]{12}$/ && cnpj[12..13] =~ /^[0-9]{2}$/
+        cnpj = normalize(cnpj)
+        return false unless valid_length?(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) }
         dv = cnpj[12..13]
 
-        dv_calc = calculate_cnpj_digits(base)
-        dv == dv_calc
+        dv == calculate_cnpj_digits(base)
+      end
+
+      def self.normalize(cnpj)
+        cnpj.to_s.upcase.gsub(/[^A-Z0-9]/, "")
+      end
+
+      def self.valid_length?(cnpj)
+        cnpj.length == 14
+      end
+
+      def self.valid_structure?(cnpj)
+        cnpj[0..11] =~ /^[A-Z0-9]{12}$/ && cnpj[12..13] =~ /^[0-9]{2}$/
       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)
         first_digit = calculate_digit(base, fator_index_1d)
-        second_digit = calculate_digit((base + [first_digit]), fator_index_2d)
+        second_digit = calculate_digit(base + [first_digit], fator_index_2d)
         "#{first_digit}#{second_digit}"
       end
 
-
       def self.fator_index_1d
         [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]
       end
@@ -48,12 +56,13 @@ module CpfCnpjPlus
         digit = 0 if digit == 10
         digit
       end
-      def self.cpj_not_valid?(cnpj)
+
+      def self.cnpj_not_valid?(cnpj)
         cnpj = cnpj.to_s.gsub(/[^0-9]/, "")
-        ["00000000000000", "11111111111111", "22222222222222", "33333333333333",
-         "44444444444444", "55555555555555", "66666666666666", "77777777777777",
-         "88888888888888", "99999999999999"].include?(cnpj)
+        %w[00000000000000 11111111111111 22222222222222 33333333333333
+           44444444444444 55555555555555 66666666666666 77777777777777
+           88888888888888 99999999999999].include?(cnpj)
       end
     end
   end
-end
+end

data/lib/cpf_cnpj_plus/validator/cpf.rb

@@ -1,45 +1,47 @@
+# frozen_string_literal: true
+
 module CpfCnpjPlus
   module Validator
+    # Responsável por validar, formatar e manipular números de CPF.
+    # Inclui métodos para checagem de validade, geração e formatação.
     class Cpf
       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
 
-      private
-
       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 == 0)
+        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]/, "")
-        ["00000000000", "11111111111", "22222222222", "33333333333",
-         "44444444444", "55555555555", "66666666666",
-         "77777777777", "88888888888", "99999999999"].include?(cpf)
+        %w[00000000000 11111111111 22222222222 33333333333
+           44444444444 55555555555 66666666666
+           77777777777 88888888888 99999999999].include?(cpf)
       end
     end
   end
-end
+end

data/lib/cpf_cnpj_plus/validator.rb

@@ -1,6 +1,11 @@
+# frozen_string_literal: true
+
 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 CNPJ alfanumérico.
   module Validator
-    require_relative 'validator/cnpj'
-    require_relative 'validator/cpf'
+    require_relative "validator/cnpj"
+    require_relative "validator/cpf"
   end
 end

data/lib/cpf_cnpj_plus/version.rb

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

data/lib/cpf_cnpj_plus.rb

@@ -2,14 +2,39 @@
 
 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,
+# incluindo suporte ao novo padrão de CNPJ alfanumérico.
 module CpfCnpjPlus
   class Error < StandardError; end
+
+  # CPF
+  def self.valid_cpf?(cpf)
+    CpfCnpjPlus::Validator::Cpf.valid?(cpf)
+  end
+
+  def self.format_cpf(cpf)
+    CpfCnpjPlus::Formatter::Cpf.format(cpf)
+  end
+
+  def self.generate_cpf
+    CpfCnpjPlus::Generator::Cpf.generate
+  end
+
+  # CNPJ
+
   def self.valid_cnpj?(cnpj)
     CpfCnpjPlus::Validator::Cnpj.valid?(cnpj)
   end
 
-  def self.valid_cpf?(cpf)
-    CpfCnpjPlus::Validator::Cpf.valid?(cpf)
+  def self.format_cnpj(cnpj)
+    CpfCnpjPlus::Formatter::Cnpj.format(cnpj)
+  end
+
+  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.1.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
@@ -23,12 +23,15 @@ 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
+                          ferramentas de linha de comando para facilitar integrações em sistemas bancários,
+                          governamentais e aplicações Ruby em geral.
 email:
 - doug.neo@gmail.com
-executables: []
+executables:
+- cnpj_plus
+- cpf_plus
 extensions: []
 extra_rdoc_files: []
 files:
@@ -40,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
@@ -68,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: []