company_number 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d4b40991721f4eb047e7060a428f3d85593cc4ce3dd15bb427d95ed629cbb37
-  data.tar.gz: cfedbc59ad70b411b385ba55813e5ebf32247ebaf2b2628f324b3d77799b6aed
+  metadata.gz: c02ace863de99e8b6d41ff12185285c5c4bff2131e45d23873981cf0115e03ee
+  data.tar.gz: 81ab67bc56f3de3edf78432cdb679ede3237d7fdcb40266f666ed6713c3dde35
 SHA512:
-  metadata.gz: 7f012c7724dddab12ef370a57d7e5f5d00d6f556cbd5bb4aa5f0b11c33298bcc2eee4a523cce73dbcb1e669c4824d57bd14c8a67780741bb3186b65ed568ac68
-  data.tar.gz: d51f55008b3cfd58a48e312af82a9538f00e75f6e857b0601d83c684bbfdd30612f031e89ee809811ccc99614e91af1653f761106cda6f00f1c7d34959bab1c4
+  metadata.gz: 6b6ff3493c540f62461a948d05de2ee4206ee0c2851d366eaf46e632802f74d7c9fc21c1a232404eef724197e70ee1194ec99ec3dea3c2363c53879352736799
+  data.tar.gz: 8973da310ae9ba856ca2553c3d1e8c27fdd3f0a20ff03044b1487539a735f6548ee9b8f51974fc4635421297fcb95320ab1a9cc1bc2be6939a4aa354d7c7b94f

data/.codeclimate.yml

@@ -0,0 +1,4 @@
+plugins:
+  rubocop:
+    enabled: true
+    channel: rubocop-1-31-0

data/.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: "CI"
+
+on:
+  push:
+    branches:
+      - "*"
+  pull_request:
+    branches:
+      - "*"
+
+jobs:
+  lint:
+    name: "RuboCop"
+    timeout-minutes: 5
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: "actions/checkout@v3"
+
+      - name: "Set up Ruby"
+        uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: "3.1"
+          bundler-cache: true
+
+      - name: "Run RuboCop"
+        run: "bundle exec rubocop"
+
+  test:
+    runs-on: "ubuntu-latest"
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version:
+          - "2.5"
+          - "2.6"
+          - "2.7"
+          - "3.0"
+          - "3.1"
+
+    steps:
+      - uses: "actions/checkout@v3"
+
+      - name: "Set up Ruby"
+        uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: "${{ matrix.ruby-version }}"
+          bundler-cache: true
+
+      - name: "Run specs"
+        run: "bundle exec rspec"
+
+      - name: "Upload artifacts"
+        uses: "actions/upload-artifact@v3"
+        with:
+          name: "coverage-artifacts"
+          path: "${{github.workspace}}/coverage/coverage.json"
+          retention-days: 1
+
+  coverage:
+    name: "Report coverage to Code Climate"
+    runs-on: "ubuntu-20.04"
+    needs: "test"
+    if: "success() && github.ref == 'refs/heads/master'"
+    env:
+      CC_TEST_REPORTER_ID: "${{ secrets.CC_TEST_REPORTER_ID }}"
+
+    steps:
+      - uses: "actions/checkout@v3"
+
+      - name: "Download coverage artifacts from test job"
+        uses: "actions/download-artifact@v3"
+        with:
+          name: "coverage-artifacts"
+      - uses: "paambaati/codeclimate-action@v3.2.0"
+        with:
+          coverageLocations: "coverage.json:simplecov"

data/.rubocop.yml

@@ -1,15 +1,18 @@
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 2.5
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
 
 Style/FrozenStringLiteralComment:
   Enabled: false
 
 Style/StringLiterals:
-  Enabled: false
+  EnforcedStyle: double_quotes
 
-Metrics/BlockLength:
-  Exclude:
-    - spec/**/*
+Style/Documentation:
+  Enabled: false
 
 Metrics/CyclomaticComplexity:
   Enabled: true
@@ -17,8 +20,18 @@ Metrics/CyclomaticComplexity:
 Metrics/MethodLength:
   Max: 20
 
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*_spec.rb"
+    - "*.gemspec"
+
 Layout/LineLength:
-  Max: 80
+  Exclude:
+    - "spec/**/*_spec.rb"
+    - "*.gemspec"
 
 Naming/MemoizedInstanceVariableName:
-   EnforcedStyleForLeadingUnderscores: optional
+  EnforcedStyleForLeadingUnderscores: optional
+
+Gemspec/RequireMFA:
+  Enabled: false

data/.simplecov

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "simplecov_json_formatter"
+
+SimpleCov.start
+SimpleCov.formatters = SimpleCov::Formatter::JSONFormatter

data/CHANGELOG.md

@@ -1,12 +1,27 @@
 ## Changelog
 
+### 0.1.3 - 2022-11-04
+  * Enhancements:
+    * Update CI - f67a9e3
+    * Update RuboCop configuration - 3af3dc7
+
+### 0.1.2 - 2022-04-21
+  * Features:
+    * Add custom configurations - aae0d51
+      - custom_dictionary
+      - strict_validation
+      - excluded_countries
+
+  * Enhancements:
+    * Update RuboCop configuration - dcd9852
+
 ### 0.1.1 - 2022-04-04
   * Features:
     * Add dictionary to return the company number metadata - b19c8d9
 
   * Deprecations:
-    * Remove `regexp` attr_reader (moved to metadata) - #3
-    * Remove `countries` attr_reader to use `CompanyNumber::Number#valid_countries` - #3
+    * Remove `regexp` attr_reader (moved to metadata)
+    * Remove `countries` attr_reader to use `CompanyNumber::Number#valid_countries`
 
   * Bug fixes:
     * Fix `CompanyNumber::Number#to_s` method not to return trailing whitespace when country code is not filled in - 9b4f3c53

data/CODE_OF_CONDUCT.md

@@ -22,7 +22,7 @@ Examples of unacceptable behavior include:
   advances of any kind
 * Trolling, insulting or derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others' private information, such as a physical or email
+* Publishing others" private information, such as a physical or email
   address, without their explicit permission
 * Other conduct which could reasonably be considered inappropriate in a
   professional setting
@@ -76,7 +76,7 @@ Community leaders will follow these Community Impact Guidelines in determining t
 This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
 available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
 
-Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+Community Impact Guidelines were inspired by [Mozilla"s code of conduct enforcement ladder](https://github.com/mozilla/diversity).
 
 [homepage]: https://www.contributor-covenant.org
 

data/Gemfile

@@ -2,5 +2,7 @@
 
 source "https://rubygems.org"
 
-# Specify your gem's dependencies in company_number.gemspec
+# Specify your gem"s dependencies in company_number.gemspec
 gemspec
+
+gem "rubocop", "< 1.32" # Keep .codeclimate.yml channel in sync

data/README.md

@@ -1,15 +1,19 @@
 # CompanyNumber
 
-[![Build Status](https://github.com/victorauthiat/company_number/actions/workflows/build.yml/badge.svg)](https://github.com/victorauthiat/company_number/actions/workflows/build.yml)
+[![Gem Version](https://badge.fury.io/rb/company_number.svg)](https://badge.fury.io/rb/company_number)
+[![Build Status](https://github.com/VictorAuthiat/company_number/actions/workflows/ci.yml/badge.svg)](https://github.com/VictorAuthiat/company_number/actions/workflows/ci.yml)
+[![Code Climate](https://codeclimate.com/github/VictorAuthiat/company_number/badges/gpa.svg)](https://codeclimate.com/github/VictorAuthiat/company_number)
+[![Test Coverage](https://codeclimate.com/github/VictorAuthiat/company_number/badges/coverage.svg)](https://codeclimate.com/github/VictorAuthiat/company_number/coverage)
+[![Issue Count](https://codeclimate.com/github/VictorAuthiat/company_number/badges/issue_count.svg)](https://codeclimate.com/github/VictorAuthiat/company_number)
 
 CompanyNumber is a gem allowing you to validate company number based on a country code
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your application"s Gemfile:
 
 ```ruby
-gem 'company_number'
+gem "company_number"
 ```
 
 And then execute:
@@ -25,7 +29,7 @@ Or install it yourself as:
 You can obtain a `CompanyNumber::Number` object calling `parse` method:
 
 ```ruby
-company_number = CompanyNumber.parse('123456789', :fr)
+company_number = CompanyNumber.parse("123456789", :fr)
 
 # => #<CompanyNumber::Number:0x00007fc015d04e18 @company_number="123456789", @country_code=:fr, @metadata={:country=>"France", :name=>"Numéro SIREN ou SIRET", :regexp=>"^(\\d{9}|\\d{14})$", :pattern=>"9 numbers (XXXXXXXXX) or 14 numbers (XXXXXXXXXXXXXX)"}>
 ```
@@ -33,12 +37,9 @@ company_number = CompanyNumber.parse('123456789', :fr)
 Then you can run validation methods
 
 ```ruby
-company_number.valid?
-# => true
-company_number.valid_country?
-# => true
-company_number.valid_for_country?(:at)
-# => false
+company_number.valid?                  # => true
+company_number.valid_country?          # => true
+company_number.valid_for_country?(:at) # => false
 ```
 
 You can also fetch valid countries
@@ -72,7 +73,7 @@ company_number.to_h
 You can compare 2 instances of `CompanyNumber::Number` with `==` method
 
 ```ruby
-CompanyNumber.parse('123') == CompanyNumber.parse('123')
+CompanyNumber.parse("123") == CompanyNumber.parse("123")
 # => true
 ```
 
@@ -82,6 +83,95 @@ CompanyNumber.dictionary
 # => {:at=>{:country=>"Austria", :name=>"Firmenbuchnummer", :regexp=>"^([a-zA-Z]{2}\\d{1,6}|\\d{1,6})[A-Z]$", :pattern=>"2 letters + 6 numbers + 1 letter (LLXXXXXXL)", :variations=>"1-6 numbers + 1 letter (XXXXXXL)"}, ...}
 ```
 
+## Configuration
+You can configure your own dictionary using **custom_dictionary**.
+It should be a hash with the country codes as keys and the associated metadata as values.
+
+Available metadata keys:
+- country
+- name
+- regexp
+- pattern
+- variations
+
+**Example:**
+```ruby
+CompanyNumber.parse("123456789", :fr).valid?      # => true
+CompanyNumber.parse("12345678901234", :fr).valid? # => true
+
+CompanyNumber.configure do |config|
+  config.custom_dictionary = { fr: { regexp: "^\d{14}$" } }
+end
+
+CompanyNumber.parse("123456789", :fr).valid?      # => false
+CompanyNumber.parse("12345678901234", :fr).valid? # => true
+```
+
+**strict_validation:**
+
+You can also enable strict validation to reject unknow countries:
+
+```ruby
+CompanyNumber.parse("123456789").valid?      # => true
+CompanyNumber.parse("123456789", :tt).valid? # => true
+
+CompanyNumber.configure do |config|
+  config.strict_validation = true
+end
+
+CompanyNumber.parse("123456789").valid?      # => false
+CompanyNumber.parse("123456789", :tt).valid? # => false
+```
+
+**excluded_countries:**
+
+You may want to exclude some countries, this allows you to automatically validate the country"s company number when strict validation is not enabled. You can also exclude a country to overwrite all its metadata and define it later in a custom dictionary.
+
+**Example:**
+```ruby
+CompanyNumber.parse("123456789", :be).valid? # => false
+
+CompanyNumber.configure do |config|
+  config.excluded_countries = [:be]
+end
+
+CompanyNumber.parse("123456789", :be).valid? # => true
+```
+
+## Default dictionary:
+
+- `:at` - **Austria** - Firmenbuchnummer
+- `:be` - **Belgium** - Numéro d"entreprise Vestigingseenheidsnummer
+- `:bg` - **Bulgaria** - ЕИК (EIK)/ПИК (PIK) (UIC/PIC)
+- `:hr` - **Croatia** - Matični broj poslovnog subjekta (MBS)
+- `:cy` - **Cyprus** - Αριθμός Μητρώου Εταιρίας Şirket kayıt numarası
+- `:cz` - **Czech** - epublic (Identifikační číslo
+- `:dk` - **Denmark** - CVR-nummer
+- `:ee` - **Estonia** - Kood
+- `:fi` - **Finland** - Y-tunnus FO-nummer
+- `:fr` - **France** - Numéro SIREN ou SIRET
+- `:de` - **Germany** - Nummer der Firma Registernummer
+- `:gr` - **Greece** - Αριθμό Φορολογικού Μητρώου (Α.Φ.Μ.)
+- `:hu` - **Hungary** - Cégjegyzékszáma
+- `:ie` - **Ireland** - Company Number
+- `:is` - **Island** - TIN
+- `:it` - **Italy** - Codice fiscale
+- `:lv` - **Latvia** - Reģistrācijas numurs
+- `:li` - **Liechtenstein** - UID
+- `:lt` - **Lithuania** - Juridinio asmens kodas
+- `:lu` - **Luxembourg** - Numéro d"immatriculation
+- `:mt` - **Malta** - Registration Number
+- `:nl` - **Netherlands** - KvK-nummer
+- `:no` - **Norway** - TIN
+- `:pl` - **Poland** - Numer w Krajowym Rejestrze Sądowym (numer KRS)) NIPC)
+- `:ro` - **Romania** - Număr de ordine în Registrul Comerţului
+- `:sk` - **Slovakia** - Identifikačného čísla Identification number
+- `:si` - **Slovenia** - Matična številka
+- `:es` - **Spain** - Número de identificación fiscal (NIF)
+- `:se` - **Sweden** - Registreringsnummer
+- `:ch` - **Switzerland** - UID
+- `:gb` - **United Kingdom** - Company Number Registration Number
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -98,4 +188,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the CompanyNumber project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/victorauthiat/company_number/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the CompanyNumber project"s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/victorauthiat/company_number/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
+require "bundler/setup"
 require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
 
+require "rspec/core/rake_task"
 require "rubocop/rake_task"
 
-RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:test)
+RuboCop::RakeTask.new(:rubocop)
 
-task default: %i[spec rubocop]
+task default: %i[rubocop test]

data/bin/setup

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 set -euo pipefail
-IFS=$'\n\t'
+IFS=$"\n\t"
 set -vx
 
 bundle install

data/company_number.gemspec

@@ -8,9 +8,10 @@ Gem::Specification.new do |spec|
   spec.authors  = ["victorauthiat"]
   spec.email    = ["authiatv@gmail.com"]
 
-  spec.summary  = 'Validate a company number according to a country code'
-  spec.homepage = 'https://github.com/victorauthiat/company_number'
-  spec.license  = 'MIT'
+  spec.summary  = "Validate a company number according to a country code"
+  spec.homepage = "https://github.com/victorauthiat/company_number"
+  spec.license  = "MIT"
+  spec.required_ruby_version = ">= 2.5"
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
@@ -19,9 +20,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency 'bundler', '~> 2.2.25'
-  spec.add_development_dependency 'pry', '~> 0.14.1'
-  spec.add_development_dependency 'rake', '~> 13.0.6'
-  spec.add_development_dependency 'rspec', '~> 3.10.0'
-  spec.add_development_dependency 'simplecov', '~> 0.21.2'
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "simplecov"
 end

data/config/dictionary.yml

@@ -7,7 +7,7 @@ at:
 
 be:
   country: Belgium
-  name: Numéro d'entreprise Vestigingseenheidsnummer
+  name: Numéro d"entreprise Vestigingseenheidsnummer
   regexp: ^\d{10}$
   pattern: 10 numbers (XXXXXXXXXX)
 
@@ -124,9 +124,9 @@ lt:
 
 lu:
   country: Luxembourg
-  name: Numéro d'immatriculation
+  name: Numéro d"immatriculation
   regexp: ^[a-zA-Z]{1}\d{6}|[a-jA-J]\d{3}$
-  pattern: 1 letter + 6 numbers (LXXXXXX)'
+  pattern: 1 letter + 6 numbers (LXXXXXX)"
   variations: 1 letter (from A to J) + 3 numbers (AXXX)
 
 mt:

data/lib/company_number/configuration.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module CompanyNumber
+  class Configuration
+    attr_reader :excluded_countries,
+                :custom_dictionary,
+                :strict_validation
+
+    def initialize
+      @excluded_countries = []
+      @custom_dictionary  = {}
+      @strict_validation  = nil
+    end
+
+    def dictionary
+      @dictionary ||= CompanyNumber::Dictionary.new(@custom_dictionary)
+    end
+
+    def strict_validation?
+      !!@strict_validation
+    end
+
+    def custom_dictionary=(value)
+      Validation.check_dictionary_structure(value)
+
+      @dictionary        = nil
+      @custom_dictionary = value
+    end
+
+    def excluded_countries=(value)
+      Validation.check_object_class(value, [Array])
+
+      @dictionary         = nil
+      @excluded_countries = value
+    end
+
+    def strict_validation=(value)
+      Validation.check_object_class(value, [TrueClass, FalseClass, NilClass])
+
+      @strict_validation = value
+    end
+  end
+end

data/lib/company_number/dictionary.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module CompanyNumber
+  class Dictionary
+    attr_reader :country_codes_metadata, :default_hash
+
+    def self.default_dictionary_path
+      File.join(File.dirname(__FILE__), "../../config/dictionary.yml")
+    end
+
+    def initialize(country_codes_metadata = {})
+      @country_codes_metadata = country_codes_metadata
+      @default_hash           = load_default_hash
+
+      validate_country_codes_metadata
+    end
+
+    def values
+      @_values ||= fetch_values
+    end
+
+    private
+
+    def fetch_values
+      transformed_hash =
+        @default_hash.merge(@country_codes_metadata) do |country_code, _, value|
+          @default_hash[country_code.downcase].merge(value)
+        end
+
+      transformed_hash.reject do |country_code, _metadata|
+        CompanyNumber.configuration.excluded_countries.include?(country_code)
+      end
+    end
+
+    def load_default_hash
+      YAML.safe_load(
+        File.read(self.class.default_dictionary_path),
+        symbolize_names: true
+      )
+    end
+
+    def validate_country_codes_metadata
+      Validation.check_object_class(@country_codes_metadata, [Hash])
+
+      @country_codes_metadata.each do |country_code, metadata|
+        Validation.check_string_format(country_code, /^[A-Za-z]{2}$/)
+        Validation.check_country_code_metadata(metadata)
+      end
+    end
+  end
+end

data/lib/company_number/number.rb

@@ -1,10 +1,13 @@
+# frozen_string_literal: true
+
 module CompanyNumber
   class Number
     attr_reader :company_number, :country_code, :metadata
 
     def initialize(company_number, country_code = nil)
-      check_param_type(company_number, [String])
-      check_param_type(country_code, [NilClass, Symbol, String])
+      Validation.check_object_class(company_number, [String])
+      Validation.check_object_class(country_code, [NilClass, Symbol, String])
+      Validation.check_iso_code_format(country_code)
 
       @company_number = company_number
       @country_code   = country_code&.downcase&.to_sym
@@ -28,17 +31,22 @@ module CompanyNumber
     end
 
     def valid?
-      !valid_country? || valid_for_country?(@country_code)
+      if CompanyNumber.strict_validation?
+        country_code_present_and_valid_country?
+      else
+        no_country_code_or_valid_country?
+      end
     end
 
     def valid_country?
-      CompanyNumber.dictionary.keys.include?(@country_code)
+      CompanyNumber.dictionary.keys.include?(@country_code) ||
+        (!CompanyNumber.strict_validation? && !!@country_code)
     end
 
     def valid_for_country?(country_code)
-      check_param_type(country_code, [Symbol])
-
-      !!(@company_number =~ country_code_regexp(country_code))
+      Validation.check_iso_code_format(country_code)
+      regexp = CompanyNumber.dictionary.dig(country_code, :regexp)
+      (!CompanyNumber.strict_validation? && !regexp) || valid_code?(regexp)
     end
 
     def valid_countries
@@ -52,17 +60,16 @@ module CompanyNumber
 
     private
 
-    def country_code_regexp(country_code)
-      regexp = CompanyNumber.dictionary.dig(country_code, :regexp)
-
-      Regexp.new(regexp) unless regexp.nil?
+    def no_country_code_or_valid_country?
+      !@country_code || valid_for_country?(@country_code)
     end
 
-    def check_param_type(param, expected_classes = [])
-      return if expected_classes.include?(param.class)
+    def country_code_present_and_valid_country?
+      !!@country_code && valid_for_country?(@country_code)
+    end
 
-      raise ArgumentError,
-            "Expect class of #{param} to be #{expected_classes.join(', ')}"
+    def valid_code?(regexp = nil)
+      !!regexp && !!(@company_number =~ Regexp.new(regexp))
     end
   end
 end

data/lib/company_number/validation.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module CompanyNumber
+  module Validation
+    ISO_CODE_REGEXP = /^[A-Za-z]{2}$/.freeze
+
+    AVAILABLE_METADATA_KEYS = %i[
+      variations
+      pattern
+      country
+      regexp
+      name
+    ].freeze
+
+    class << self
+      def check_object_class(object, expected_classes = [])
+        return if expected_classes.include?(object.class)
+
+        raise ArgumentError,
+              "Expect #{object} class to be #{expected_classes.join(', ')}"
+      end
+
+      def check_object_inclusion(object, expected_objects = [])
+        return if expected_objects.include?(object)
+
+        raise ArgumentError,
+              "Expect #{object} to be part of #{expected_objects}"
+      end
+
+      def check_string_format(string, regexp)
+        return if string =~ regexp
+
+        raise ArgumentError, "Expect #{string} to match regexp: #{regexp}"
+      end
+
+      def check_iso_code_format(country_code)
+        return unless country_code
+
+        check_object_class(country_code, [Symbol, String])
+        check_string_format(country_code.to_s, ISO_CODE_REGEXP)
+      end
+
+      def check_country_code_metadata(metadata)
+        metadata.each do |key, value|
+          check_object_inclusion(key, AVAILABLE_METADATA_KEYS)
+          check_object_class(value, [String])
+        end
+      end
+
+      def check_dictionary_structure(value)
+        Validation.check_object_class(value, [Hash])
+
+        value.each do |country_code, metadata|
+          Validation.check_object_class(country_code, [Symbol])
+          Validation.check_object_class(metadata, [Hash])
+        end
+      end
+    end
+  end
+end

data/lib/company_number/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CompanyNumber
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end