bra_documents 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 215a2d930cbd6fe593e690469a1842c23f50fa3b9d7a486cbb1b71b6eab1c806
-  data.tar.gz: 66c92be6ef85b40a4aa5bcb4bd248acc6b1ae5ffbe6e23ac718253acd1e06faf
+  metadata.gz: 9660c16de3e4c0e3af2ec9e235efb07afde5143c35bbf282c24c78675f91878e
+  data.tar.gz: e9b7de683720c392be7db09dff0e094e4e8c95699d3f31123143ad02c03a9575
 SHA512:
-  metadata.gz: e9c46921964f8651778a6b8dcedc92be10be086d015c1b5a674a081670663abc4cd63112ab38a2e4a663123109146e74de6d43847f17e80bbc185524b7b2a68e
-  data.tar.gz: cd3b29c4cbd6f10f29ee242647f53f09e5854b89cb57e77f0aacfd92cd120705ed3128ae9759cf89b0ce42b8e578c8a10e9a05dd5aead45c729ba35123b8953a
+  metadata.gz: 1b9fcfaf3bb6f3a398e5ea8ebfd9739cc4060bda3fbd7a3645122390a28890e2c2136eeeee6c579d9c2c9fc777e8625a62f535811de4e8994fdf379574124a96
+  data.tar.gz: 045fc875fdf40b830b93bc58c40afffab6c6b0185e421ebc39c005cd3daa6c2b4561885575f3c74247b7a1ab330996aaf8b8b3edb00af28524684cc4a35c767c

data/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "09:00"
+  open-pull-requests-limit: 10

data/.travis.yml

@@ -6,5 +6,7 @@ rvm:
   - 2.6.6
   - 2.5.8
   - 2.4.10
+  - 3.0.3
+  - 3.1.1
 
 before_install: gem install bundler -v 2.1.4

data/CHANGELOG.md

@@ -1,5 +1,6 @@
 
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
@@ -7,10 +8,21 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+## [1.0.1] - 2020-22-10
+
+### Added
+
+- Add Formatter.raw method to make a document number to have only numbers;
+- Add Matcher.match? to check if a CPF or CNPJ has a valid format;
+- Add CPFGenerator.valid_verification_digit? to check if a CPF has a valid verification digit
+- Add CNPJGenerator.valid_verification_digit? to check if a CNPJ has a valid verification digit
+
 ## [1.0.0] - 2020-22-10
+
 ### Added
-  - CPF and CNPJ number formatter
-  - CPF number generator
-  - CNPJ number generator
-  - RSpec CPF matcher helpers
-  - RSpec CNPJ matcher helpers
+
+- CPF and CNPJ number formatter;
+- CPF number generator;
+- CNPJ number generator;
+- RSpec CPF matcher helpers;
+- RSpec CNPJ matcher helpers;

data/Gemfile.lock

@@ -1,33 +1,33 @@
 PATH
   remote: .
   specs:
-    bra_documents (1.0.0)
+    bra_documents (1.0.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     coderay (1.1.3)
-    diff-lcs (1.4.4)
-    method_source (0.9.2)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-nav (0.3.0)
-      pry (>= 0.9.10, < 0.13.0)
-    rake (13.0.1)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.3)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    diff-lcs (1.5.0)
+    method_source (1.0.0)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-nav (1.0.0)
+      pry (>= 0.9.10, < 0.15)
+    rake (13.0.6)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
 
 PLATFORMS
   ruby

data/README.md

@@ -40,6 +40,19 @@ BraDocuments::CPFGenerator.generate(person_number: '123123123', formatted: true)
 #=> "123.123.123-87"
 ```
 
+### CPF digit verification
+
+```rb
+BraDocuments::CPFGenerator.valid_verification_digit?(document: '86027265892')
+#=> true
+
+BraDocuments::CPFGenerator.valid_verification_digit?(document: '123.123.123-87')
+#=> true
+
+BraDocuments::CPFGenerator.valid_verification_digit?(document: '123.123.123-88')
+#=> false
+```
+
 ### CNPJ Generation
 
 ```rb
@@ -62,6 +75,19 @@ BraDocuments::CNPJGenerator.generate(company_number: '53855973', matrix_subsidia
 #=> "53.855.973/0001-79"
 ```
 
+### CNPJ digit verification
+
+```rb
+BraDocuments::CNPJGenerator.valid_verification_digit?(document: '62885807804809')
+#=> true
+
+BraDocuments::CNPJGenerator.valid_verification_digit?(document: '53.855.973/0001-79')
+#=> true
+
+BraDocuments::CNPJGenerator.valid_verification_digit?(document: '53855973000177')
+#=> false
+```
+
 ### Formatting
 
 ```rb
@@ -70,6 +96,25 @@ BraDocuments::Formatter.format('86027265892', as: :cpf)
 
 BraDocuments::Formatter.format('53855973879456', as: :cnpj)
 #=> "53.855.973/8794-56"
+
+BraDocuments::Formatter.raw('53.855.973/8794-56')
+#=> "53855973879456"
+```
+
+### Matching
+
+```rb
+BraDocuments::Matcher.match?('11111111111', kind: :cpf, mode: :raw)
+#=> true
+
+BraDocuments::Matcher.match?('11111111111', kind: :cpf, mode: :formatted)
+#=> false
+
+BraDocuments::Matcher.match?('11111111111', kind: :cnpj, mode: :raw)
+#=> false
+
+BraDocuments::Matcher.match?('90.978.812/0001-07', kind: :cnpj, mode: :formatted)
+#=> true
 ```
 
 ### Tests Matching

data/lib/bra_documents/cnpj_generator.rb

@@ -12,12 +12,27 @@ module BraDocuments
       # Generates a random CNPJ document number or add verifying digits to one if it's given.
       # It can return only numbers or formatted with mask
       #
-      # BraDocuments::CNPJGenerator.generate # => "62885807804809"
-      # BraDocuments::CNPJGenerator.generate(formatted: true) # => "53.855.973/0664-39"
-      # BraDocuments::CNPJGenerator.generate(company_number: '53855973') # => "53855973879456"
-      # BraDocuments::CNPJGenerator.generate(company_number: '53855973', formatted: true) # => "53.855.973/8189-02"
-      # BraDocuments::CNPJGenerator.generate(company_number: '53855973', matrix_subsidiary_number: '0001') # => "53855973000179"
-      # BraDocuments::CNPJGenerator.generate(company_number: '53855973', matrix_subsidiary_number: '0001', formatted: true) # => "53.855.973/0001-79"
+      #  BraDocuments::CNPJGenerator.generate
+      #  # => "62885807804809"
+      #
+      #  BraDocuments::CNPJGenerator.generate(formatted: true)
+      #  # => "53.855.973/0664-39"
+      #
+      #  BraDocuments::CNPJGenerator.generate(company_number: '53855973')
+      #  # => "53855973879456"
+      #
+      #  BraDocuments::CNPJGenerator.generate(company_number: '53855973', formatted: true)
+      #  # => "53.855.973/8189-02"
+      #
+      #  BraDocuments::CNPJGenerator.generate(company_number: '53855973', matrix_subsidiary_number: '0001')
+      #  # => "53855973000179"
+      #
+      #  BraDocuments::CNPJGenerator.generate(
+      #    company_number: '53855973',
+      #    matrix_subsidiary_number: '0001',
+      #    formatted: true
+      #    )
+      #  # => "53.855.973/0001-79"
       def generate(company_number: nil, matrix_subsidiary_number: nil, formatted: false)
         company_number = number_for('Company', COMPANY_NUMBER_SIZE, company_number)
         matrix_subsidiary_number = number_for('Matrix or subsidiary', MATRIX_SUBSIDIARY_SIZE, matrix_subsidiary_number)
@@ -28,6 +43,29 @@ module BraDocuments
         formatted ?  Formatter.format(full_number, as: :cnpj) : full_number
       end
 
+      # Returns if a CPF has a valid verification digit.
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '11.111.111/1111-11')
+      #   # => false
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '20.163.606/0001-55')
+      #   # => true
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '29432530000190')
+      #   # => true
+      def valid_verification_digit?(document:)
+        raw_document = Formatter.raw(document)
+        return false if raw_document.chars.uniq.size == 1
+
+        company_number = raw_document.slice(0..(COMPANY_NUMBER_SIZE - 1))
+        matrix_subsidiary_number = raw_document
+          .slice(COMPANY_NUMBER_SIZE..(COMPANY_NUMBER_SIZE + MATRIX_SUBSIDIARY_SIZE - 1))
+        verified_digit = raw_document.slice(-2..-1)
+
+        generate(company_number: company_number, matrix_subsidiary_number: matrix_subsidiary_number)
+          .end_with?(verified_digit)
+      end
+
       private
 
       def verification_digit_multiplicators_for(numbers)

data/lib/bra_documents/cpf_generator.rb

@@ -11,15 +11,42 @@ module BraDocuments
       # Generates a random CPF document number or add verifying digits to one if it's given.
       # It can return only numbers or formatted with mask
       #
-      # BraDocuments::CPFGenerator.generate # => "86027265892"
-      # BraDocuments::CPFGenerator.generate(formatted: true) # => "038.857.544-10"
-      # BraDocuments::CPFGenerator.generate(person_number: '123123123') # => "12312312387"
-      # BraDocuments::CPFGenerator.generate(person_number: '123123123', formatted: true) # => "123.123.123-87"
+      #   BraDocuments::CPFGenerator.generate
+      #   # => "86027265892"
+      #
+      #   BraDocuments::CPFGenerator.generate(formatted: true)
+      #   # => "038.857.544-10"
+      #
+      #   BraDocuments::CPFGenerator.generate(person_number: '123123123')
+      #   # => "12312312387"
+      #
+      #   BraDocuments::CPFGenerator.generate(person_number: '123123123', formatted: true)
+      #   # => "123.123.123-87"
       def generate(person_number: nil, formatted: false)
         numbers = number_for('Person', PERSON_NUMBER_SIZE, person_number)
         full_number = complete!(numbers)
 
-        formatted ?  Formatter.format(full_number, as: :cpf) : full_number
+        formatted ? Formatter.format(full_number, as: :cpf) : full_number
+      end
+
+      # Returns if a CPF has a valid verification digit.
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '111.111.111-11')
+      #   # => false
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '123.456.700-88')
+      #   # => true
+      #
+      #   BraDocuments::CPFGenerator.valid_verification_digit?(document: '12345670088')
+      #   # => true
+      def valid_verification_digit?(document:)
+        raw_document = Formatter.raw(document)
+        return false if raw_document.chars.uniq.size == 1
+
+        person_number = raw_document.slice(0..(PERSON_NUMBER_SIZE - 1))
+        verified_digit = raw_document.slice(PERSON_NUMBER_SIZE..(raw_document.size - 1))
+
+        generate(person_number: person_number).end_with?(verified_digit)
       end
 
       private

data/lib/bra_documents/formatter.rb

@@ -2,20 +2,47 @@
 
 module BraDocuments
   class Formatter
+    NOT_NUMBER = /\D/
     FORMATS = {
       cpf: { pattern: /\A(\d{3})(\d{3})(\d{3})(\d{2})\z/, mask: '%s.%s.%s-%s' },
-      cnpj: { pattern: /\A(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})\z/, mask: '%s.%s.%s/%s-%s'}
+      cnpj: { pattern: /\A(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})\z/, mask: '%s.%s.%s/%s-%s' }
     }.freeze
 
-    # Formats a only numbers CPF or CNPJ in their own mask
-    #
-    # BraDocuments::Formatter.format('86027265892', as: :cpf) # => "860.272.658-92"
-    # BraDocuments::Formatter.format('53855973879456', as: :cnpj) # => "53.855.973/8794-56"
-    def self.format(number, as:)
-      format_data = FORMATS[as]
+    class << self
+      # Formats a only numbers CPF or CNPJ in their own mask
+      #
+      # BraDocuments::Formatter.format('86027265892', as: :cpf) # => "860.272.658-92"
+      # BraDocuments::Formatter.format('53855973879456', as: :cnpj) # => "53.855.973/8794-56"
+      def format(number, as:)
+        raise ArgumentError, "\"#{number.inspect}\" must be a String." unless number.is_a?(String)
+        unless known_format?(as)
+          raise ArgumentError, "Format \"#{as}\" is not know. Known formats: #{known_formats.join(', ')}."
+        end
 
-      Kernel.format(format_data[:mask], *format_data[:pattern].match(number).captures)
+        format_data = FORMATS[as]
+
+        Kernel.format(format_data[:mask], *format_data[:pattern].match(number).captures)
+      end
+
+      # Formats removing all not number caracters from string.
+      #
+      # BraDocuments::Formatter.raw('860.272.658-9') # => "286027265892"
+      # BraDocuments::Formatter.format('53.855.973/8794-56') # => "53855973879456"
+      def raw(number)
+        raise ArgumentError, "\"#{number.inspect}\" must be a String." unless number.is_a?(String)
+
+        number.gsub(NOT_NUMBER, '')
+      end
+
+      private
+
+      def known_formats
+        @known_formats ||= FORMATS.keys
+      end
+
+      def known_format?(format)
+        known_formats.include?(format)
+      end
     end
   end
 end
-

data/lib/bra_documents/matcher.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module BraDocuments
+  class Matcher
+    FORMATS = {
+      cpf: { formatted: /\A(\d{3}\.){2}\d{3}-\d{2}\z/, raw: /\A\d{11}\z/ },
+      cnpj: { formatted: /\A\d{2}.\d{3}\.\d{3}\/\d{4}-\d{2}\z/, raw: /\A\d{14}\z/ }
+    }.freeze
+
+    class << self
+      # Macthes with Brazilian CPF and CNPJ documents.
+      #
+      #   BraDocuments::Matcher.match?('11111111111', kind: :cpf, mode: :raw)
+      #   # => true
+      #
+      #   BraDocuments::Matcher.match?('11111111111', kind: :cpf, mode: :formatted)
+      #   # => false
+      #
+      #   BraDocuments::Matcher.match?('11111111111', kind: :cnpj, mode: :raw)
+      #   # => false
+      #
+      #   BraDocuments::Matcher.match?('90.978.812/0001-07', kind: :cnpj, mode: :formatted)
+      #   # => true
+      def match?(number, kind:, mode:)
+        raise ArgumentError, "\"#{number.inspect}\" must be a String." unless number.is_a?(String)
+
+        unless known_format?(kind)
+          raise ArgumentError, "Unknown document kind \"#{kind.inspect}\". Known documents: #{known_formats.join(', ')}."
+        end
+
+        unless known_mode?(mode)
+          raise ArgumentError, "Unknown document format mode \"#{mode.inspect}\". Known modes: #{known_modes.join(', ')}."
+        end
+
+        formats_to_match(kind, mode).any? { |format| format.match?(number) }
+      end
+
+      private
+
+      def known_formats
+        @known_formats ||= FORMATS.keys
+      end
+
+      def known_modes
+        @known_modes ||= FORMATS[known_formats.first].keys << :any
+      end
+
+      def known_format?(format)
+        known_formats.include?(format)
+      end
+
+      def known_mode?(mode)
+        known_modes.include?(mode)
+      end
+
+      def formats_to_match(kind, mode)
+        document_formats = FORMATS[kind]
+
+        mode == :any ? document_formats.values : [document_formats[mode]]
+      end
+    end
+  end
+end

data/lib/bra_documents/national_register_base.rb

@@ -3,7 +3,6 @@
 module BraDocuments
   class NationalRegisterBase
     class << self
-      NOT_NUMBER_PATTERN = /\D/.freeze
       BASE = 11
 
       private
@@ -14,9 +13,12 @@ module BraDocuments
       end
 
       def number_for(number_description, number_size, given_value)
-        given_value = only_digits_for(given_value)
+        given_value = Formatter.raw(given_value.to_s)
         if !given_value.to_s.empty?
-          raise ArgumentError, "#{number_description} number must be a number with #{number_size} digits." unless given_value.size == number_size
+          unless given_value.size == number_size
+            raise ArgumentError, "#{number_description} number must be a number with #{number_size} digits."
+          end
+
           given_value.split('').map(&:to_i)
         else
           number_with(number_size)
@@ -27,10 +29,6 @@ module BraDocuments
         size.times.map { rand(10) }
       end
 
-      def only_digits_for(number)
-        number.to_s.gsub(NOT_NUMBER_PATTERN, '')
-      end
-
       def verification_digit_for(numbers)
         verification_digit_multiplicators = verification_digit_multiplicators_for(numbers)
         sum_and_multiplication = sum_and_multiply(numbers, verification_digit_multiplicators)
@@ -43,7 +41,8 @@ module BraDocuments
       end
 
       def sum_and_multiply(numbers, multiplicators)
-        multiplicators.map
+        multiplicators
+          .map
           .with_index { |multiplicator, position| numbers[position] * multiplicator }
           .sum
       end

data/lib/bra_documents/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BraDocuments
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

data/lib/bra_documents.rb

@@ -4,8 +4,8 @@ require 'bra_documents/national_register_base'
 require 'bra_documents/cpf_generator'
 require 'bra_documents/cnpj_generator'
 require 'bra_documents/formatter'
-require "bra_documents/version"
-
+require 'bra_documents/matcher'
+require 'bra_documents/version'
 
 module BraDocuments
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bra_documents
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Bruno Vicenzo
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-22 00:00:00.000000000 Z
+date: 2022-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -74,6 +74,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
@@ -91,6 +92,7 @@ files:
 - lib/bra_documents/cnpj_generator.rb
 - lib/bra_documents/cpf_generator.rb
 - lib/bra_documents/formatter.rb
+- lib/bra_documents/matcher.rb
 - lib/bra_documents/national_register_base.rb
 - lib/bra_documents/testing/rspec.rb
 - lib/bra_documents/testing/rspec/matchers/cnpj_matcher.rb
@@ -104,7 +106,7 @@ metadata:
   homepage_uri: https://github.com/bvicenzo/bra_documents
   source_code_uri: https://github.com/bvicenzo/bra_documents
   changelog_uri: https://github.com/bvicenzo/bra_documents/blob/master/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -119,8 +121,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 3.3.7
+signing_key: 
 specification_version: 4
 summary: A implementation for generating Brazilian CPF and CNPJ document numbers.
 test_files: []