cpf_cnpj_plus 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0205bbfedea020597d02606a1dd67e642278d11cca9f66b1aa798a136326bda
-  data.tar.gz: 0712a0959fe535b47d1d03c7f9a0493248354f242a6dd0b29d0a4716d8bd9dcb
+  metadata.gz: 3471ac722167a65351c70e1e5d5cc0942bd915ba0420eaef56050778bc05809b
+  data.tar.gz: d108eadcb37093bccfe1aca2b5ce65c5c4a1bfad4ebdb312a0d111fca8e0ff95
 SHA512:
-  metadata.gz: 4dd053dc269c7868957eea4fef508713e41022b31f9bc60ea40cfa1d0d928df60f7624c6e35fa5dd057912663640be2b36a2b7a23030475793507af0425f27cc
-  data.tar.gz: c84da6e355ed10be01f01745de51b5dac6f781d5a64bcd6cd60bc9e3772b3a15ebb0674065d9c666db5abc1e28cc39927c29b6927501f6c0fce3656d8d11fe3a
+  metadata.gz: d4aa54004da35e9333beb2fdfce720ffec85f171cee7beb9d1204e27c576dddd7d319659581ed20569810c73468fe84c5633674536b3fa6870bee22b76c0e499
+  data.tar.gz: 22d11338440ada66d77bd93d05b74297a6a10642f25f7e634d93b44b595e6b08c55ffe06cdb5ca5f74305e44133f3f6f54d32a09001850a084a30c98b57f39be

data/CHANGELOG.md

@@ -5,5 +5,9 @@
 - 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
+
 
 

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?("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?("A1234567B00195") # => true ou false
+CpfCnpjPlus.format_cnpj("A1234567B00195") # => "A12.345.67B/0019-5"
+CpfCnpjPlus.generate # => Gera um CNPJ alfanumérico válido
 ```
 
 

data/lib/cpf_cnpj_plus/validator/cnpj.rb

@@ -1,17 +1,32 @@
+# 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
+        cnpj = normalize(cnpj)
+        return false unless valid_length?(cnpj)
         return false if cpj_not_valid?(cnpj)
-        return false unless cnpj[0..11] =~ /^[A-Z0-9]{12}$/ && cnpj[12..13] =~ /^[0-9]{2}$/
+        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)
@@ -26,11 +41,10 @@ module CpfCnpjPlus
 
       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 +62,13 @@ module CpfCnpjPlus
         digit = 0 if digit == 10
         digit
       end
+
       def self.cpj_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,15 +1,18 @@
+# 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)
+
         first_digit(cpf) && second_digit(cpf)
       end
 
-      private
-
       def self.first_digit(cpf)
         first_digit = cpf[0..8]
         soma = 0
@@ -31,15 +34,15 @@ module CpfCnpjPlus
           soma += res
           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)
         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 futuros (como 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.2.0"
 end

data/lib/cpf_cnpj_plus.rb

@@ -3,8 +3,12 @@
 require_relative "cpf_cnpj_plus/version"
 require_relative "cpf_cnpj_plus/validator"
 
+# 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
+
   def self.valid_cnpj?(cnpj)
     CpfCnpjPlus::Validator::Cnpj.valid?(cnpj)
   end
@@ -12,4 +16,20 @@ module CpfCnpjPlus
   def self.valid_cpf?(cpf)
     CpfCnpjPlus::Validator::Cpf.valid?(cpf)
   end
+
+  def self.format_cpf(cpf)
+    CpfCnpjPlus::Format::Cpf.format(cpf)
+  end
+
+  def self.format_cnpj(cnpj)
+    CpfCnpjPlus::Format::Cnpj.format(cnpj)
+  end
+
+  def self.generate_cpf
+    CpfCnpjPlus::Generate::Cpf.generate
+  end
+
+  def self.generate_cnpj
+    CpfCnpjPlus::Generate::Cnpj.generate
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cpf_cnpj_plus
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - DougNeo
@@ -23,9 +23,10 @@ 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: []