tin_valid 0.1.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b248c0be6699ce56b48b082c320833ff8cb5594a62762d298ea66315d8d7555b
-  data.tar.gz: a04549a7599fbadd881f1f905e2c13235d83a3e1d4b7bd8d79dc16393cd18465
+  metadata.gz: 2a4dc099cefbd5653c35bb0a8d78061e7e9239a917f2f872e7036651c429c014
+  data.tar.gz: c540ebe0de3b7f4c69c65c2d05b0d2d67b1beca905e4ee2e99416b361d4991c9
 SHA512:
-  metadata.gz: 608e79cfe16d11cd236c02a4b5dffa9062a4b26b0f8816c2e9a9da350471917a5cc7ac6802202223ec6936f82cc0f91f9b820118a9c56868b2c6c4a9eaa8f67f
-  data.tar.gz: a17c2624d59049524fbeb5b8adec5263dd6c4009d7bb90c594ad01c499c990a6784515a195bbd3a16148278c32f524b71067b6f0095020dccd24ae5a65987da4
+  metadata.gz: d34baae639710a1f82adc36eedce1bb6b961e7fbe3f2128d091b5c61f6956276dc047207d62ac46325577028e5db562a955a4603056d0096469ce48e7698adbf
+  data.tar.gz: 97e1d3b264372400e0575a30d15087d53bb3220c49e2126a5aa24417407b806e8018e4bf26cef7e7ff8a1d749e74c907801a8b3e2ae52ddae85008394682ba28

data/.rspec

@@ -1,3 +1,2 @@
---format documentation
 --color
 --require spec_helper

data/.rubocop.yml

@@ -8,6 +8,11 @@ AllCops:
 
 # Layout
 
+Layout/LineLength:
+  Max: 80
+  Exclude:
+    - bin/rspec
+
 Layout/MultilineMethodCallIndentation:
   # On multiline calls, indent starting from the receiver.
   # E.g.:

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 ## [Unreleased]
 
+## [1.1.0] - 2025-04-18
+
+Features:
+- Add Finland 🇫🇮
+- Add France 🇫🇷
+
+Fixes:
+- Test against clearly invalid codes 00000… and 123456…
+- Check that all dates are in the past
+
+## [1.0.0] - 2025-04-17
+
+Features:
+- Add Italy 🇮🇹
+- Add Latvia 🇱🇻
+- Add Luxembourg 🇱🇺
+- Add Lithuania 🇱🇹
+- Add Malta 🇲🇹
+- Add Netherlands 🇳🇱
+- Add Poland 🇵🇱
+- Add Portugal 🇵🇹
+- Add Romania 🇷🇴
+- Add Slovakia 🇸🇰
+- Add Slovenia 🇸🇮
+- Add Spain 🇪🇸
+- Add United Kingdom 🇬🇧
+
 ## [0.1.1] - 2025-04-15
 
 Features:
@@ -7,7 +34,6 @@ Features:
 - Add Greece 🇬🇷
 - Add Hungary 🇭🇺
 - Add Ireland 🇮🇪
-- Add #normalized to Austria 🇦🇹
 
 ## [0.1.0] - 2025-04-14
 

data/README.md

@@ -10,11 +10,26 @@ Validate Tax Identification Numbers (TINs) for the following European countries:
 - Czechia 🇨🇿
 - Denmark 🇩🇰
 - Estonia 🇪🇪
+- Finland 🇫🇮
+- France 🇫🇷
 - Germany 🇩🇪
 - Greece 🇬🇷
 - Hungary 🇭🇺
 - Ireland 🇮🇪
+- Italy 🇮🇹
+- Latvia 🇱🇻
+- Lithuania 🇱🇹
+- Luxembourg 🇱🇺
+- Malta 🇲🇹
+- Netherlands 🇳🇱
+- Poland 🇵🇱
+- Portugal 🇵🇹
+- Romania 🇷🇴
+- Slovakia 🇸🇰
+- Slovenia 🇸🇮
+- Spain 🇪🇸
 - Sweden 🇸🇪
+- United Kingdom 🇬🇧
 
 See also the [descriptions of the structure provided by the European
 Union](https://taxation-customs.ec.europa.eu/online-services/online-services-and-databases-taxation/taxpayer-identification-number-tin_en).
@@ -38,8 +53,7 @@ gem install tin_valid
 
 ```rb
 # Austria
-TinValid::AustriaTin.new(tin: "93-173/6581").valid? # => true
-TinValid::AustriaTin.new(tin: "93-173/6581").normalized # => "931736581"
+TinValid::AustriaTin.new(tin: "…").valid? # => true
 
 # Belgium
 # Optional birth_date
@@ -68,9 +82,74 @@ TinValid::DenmarkTin.new(tin: "…", birth_date: Date.new(…)).valid?
 # Optional birth_date
 TinValid::EstoniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
 
+# Finland
+# Optional birth_date
+TinValid::FinlandTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# France
+TinValid::FranceTin.new(tin: "…").valid?
+
+# Germany
+TinValid::GermanyTin.new(tin: "…").valid?
+
+# Greece
+TinValid::GreeceTin.new(tin: "…").valid?
+
+# Hungary
+TinValid::HungaryTin.new(tin: "…").valid?
+
+# Ireland
+TinValid::IrelandTin.new(tin: "…").valid?
+
+# Italy
+# Optional birth_date
+TinValid::ItalyTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Latvia
+# Optional birth_date
+TinValid::LatviaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Lithuania
+# Optional birth_date
+TinValid::LithuaniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Luxembourg
+# Optional birth_date
+TinValid::LuxembourgTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Malta
+TinValid::MaltaTin.new(tin: "…").valid?
+
+# Netherlands
+TinValid::NetherlandsTin.new(tin: "…").valid?
+
+# Poland
+# Optional birth_date
+TinValid::PolandTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Portugal
+TinValid::PortugalTin.new(tin: "…").valid?
+
+# Romania
+# Optional birth_date
+TinValid::RomaniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Slovakia
+# Optional birth_date
+TinValid::SlovakiaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# Slovenia
+TinValid::SloveniaTin.new(tin: "…").valid?
+
+# Spain
+TinValid::SpainTin.new(tin: "…").valid?
+
 # Sweden
 # Optional birth_date
 TinValid::SwedenTin.new(tin: "…", birth_date: Date.new(…)).valid?
+
+# United Kingdom
+TinValid::UnitedKingdomTin.new(tin: "…").valid?
 ```
 
 ## Development

data/lib/tin_valid/austria_tin.rb

@@ -10,6 +10,7 @@ module TinValid
 
     def valid?
       return false unless MATCHER.match?(normalized)
+      return false if %w[000000000 123456789].include?(normalized)
 
       normalized[-1] == check
     end

data/lib/tin_valid/belgium_tin.rb

@@ -2,6 +2,8 @@
 
 module TinValid
   class BelgiumTin
+    include TinValid::Helpers
+
     def initialize(tin:, birth_date: nil)
       @tin = tin
       @birth_date = birth_date
@@ -37,6 +39,15 @@ module TinValid
     def check = match[:check].to_i
 
     def valid_check?(year, month, day, number)
+      # A month (in the range 00...12, 00 is acceptable for person not born in
+      # Belgium and with an uncertain date of birth).
+      month = 1 if month == "00"
+
+      # A day of month (in the range 00...31 depending on month and year, 00 is
+      # acceptable for person not born in Belgium and with an uncertain date of
+      # birth).
+      day = 1 if day == "00"
+
       tin_date = date(year, month, day)
       return false if tin_date.nil?
       return false if birth_date && birth_date != tin_date
@@ -54,20 +65,5 @@ module TinValid
     #
     # 2. 97 - remainder of the previous division is the check number
     def digit_check(number) = 97 - (number.to_i % 97)
-
-    def date(year, month, day)
-      # A month (in the range 00...12, 00 is acceptable for person not born in
-      # Belgium and with an uncertain date of birth).
-      month = 1 if month == "00"
-
-      # A day of month (in the range 00...31 depending on month and year, 00 is
-      # acceptable for person not born in Belgium and with an uncertain date of
-      # birth).
-      day = 1 if day == "00"
-
-      Date.new(year.to_i, month.to_i, day.to_i)
-    rescue Date::Error
-      nil
-    end
   end
 end

data/lib/tin_valid/bulgaria_tin.rb

@@ -1,11 +1,16 @@
 # frozen_string_literal: true
 
 module TinValid
-  class BulgariaTin < Data.define(:tin, :birth_date)
+  class BulgariaTin
+    include TinValid::Helpers
+
     def initialize(tin:, birth_date: nil)
-      super
+      @tin = tin
+      @birth_date = birth_date
     end
 
+    attr_reader :tin, :birth_date
+
     def valid?
       match = MATCHER.match(tin)
       return false unless match
@@ -37,9 +42,9 @@ module TinValid
       day = day.to_i
 
       if birth_date.nil?
-        past_date?("18#{year}", month - 20, day) ||
-          past_date?("19#{year}", month, day) ||
-          past_date?("20#{year}", month - 40, day)
+        date("18#{year}", month - 20, day) ||
+          date("19#{year}", month, day) ||
+          date("20#{year}", month - 40, day)
       elsif birth_year < 1900
         birth_date == date("18#{year}", month - 20, day)
       elsif birth_year < 2000
@@ -53,17 +58,6 @@ module TinValid
 
     def birth_year = birth_date.year
 
-    def past_date?(year, month, day)
-      found_date = date(year, month, day)
-      found_date && found_date < Date.today
-    end
-
-    def date(year, month, day)
-      Date.new(year.to_i, month.to_i, day.to_i)
-    rescue Date::Error
-      nil
-    end
-
     def check
       weights = [2, 4, 8, 5, 10, 9, 7, 3, 6]
 

data/lib/tin_valid/croatia_tin.rb

@@ -1,7 +1,13 @@
 # frozen_string_literal: true
 
 module TinValid
-  class CroatiaTin < Data.define(:tin)
+  class CroatiaTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
     def valid?
       return false unless /\A[0-9]{11}\z/.match?(tin)
 

data/lib/tin_valid/cyprus_tin.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
 module TinValid
-  class CyprusTin < Data.define(:tin, :kind)
+  class CyprusTin
     def initialize(tin:, kind: nil)
-      super
+      @tin = tin
+      @kind = kind
     end
 
+    attr_reader :tin, :kind
+
     def valid?
       matcher.match?(tin) && check == tin[-1]
     end

data/lib/tin_valid/czechia_tin.rb

@@ -1,11 +1,16 @@
 # frozen_string_literal: true
 
 module TinValid
-  class CzechiaTin < Data.define(:tin, :birth_date)
+  class CzechiaTin
+    include TinValid::Helpers
+
     def initialize(tin:, birth_date: nil)
-      super
+      @tin = tin
+      @birth_date = birth_date
     end
 
+    attr_reader :tin, :birth_date
+
     def valid? = valid_v1? || valid_v2?
 
     private
@@ -33,6 +38,7 @@ module TinValid
     def valid_v1?
       match = MATCHER_V1.match(tin)
       return false unless match
+      return false if tin == "000000000"
       return true if birth_date.nil?
       return false if year_of_birth >= 1954
 
@@ -46,11 +52,10 @@ module TinValid
       birth_date == date(year, month, match[:day])
     end
 
-    # rubocop:disable Metrics/AbcSize
-    # rubocop:disable Metrics/MethodLength
     def valid_v2?
       match = MATCHER_V2.match(tin)
       return false unless match
+      return false if tin == "0000000000"
       return true if birth_date.nil?
       return false if year_of_birth < 1954
 
@@ -59,30 +64,26 @@ module TinValid
       # 54 - 99 for people born between 1954 and 1999.
       year = "#{birth_century}#{match[:year]}"
 
-      # Month (in the range 1...12 only for men) or month + 20 (in the range
-      # 21…32 only for men) or month + 50 (in the range 51...62 only for women)
-      # or month + 70 (in the range 71…82 only for women).
-      month = match[:month].to_i
-      if month > 70
-        month -= 70
-      elsif month > 50
-        month -= 50
-      elsif month > 20
-        month -= 20
-      end
-
-      birth_date == date(year, month, match[:day])
+      birth_date == date(year, month_integer(match[:month]), match[:day])
     end
-    # rubocop:enable Metrics/AbcSize
-    # rubocop:enable Metrics/MethodLength
 
     def year_of_birth = birth_date&.year
     def birth_century = birth_date.strftime("%Y")[..1]
 
-    def date(year, month, day)
-      Date.new(year.to_i, month.to_i, day.to_i)
-    rescue Date::Error
-      nil
+    # Month (in the range 1...12 only for men) or month + 20 (in the range
+    # 21…32 only for men) or month + 50 (in the range 51...62 only for women)
+    # or month + 70 (in the range 71…82 only for women).
+    def month_integer(number)
+      number = number.to_i
+      if number > 70
+        number - 70
+      elsif number > 50
+        number - 50
+      elsif number > 20
+        number - 20
+      else
+        number
+      end
     end
   end
 end

data/lib/tin_valid/denmark_tin.rb

@@ -1,14 +1,21 @@
 # frozen_string_literal: true
 
 module TinValid
-  class DenmarkTin < Data.define(:tin, :birth_date)
+  class DenmarkTin
+    include TinValid::Helpers
+
     def initialize(tin:, birth_date: nil)
-      super
+      @tin = tin
+      @birth_date = birth_date
     end
 
+    attr_reader :tin, :birth_date
+
+    # rubocop:disable Metrics/AbcSize
     def valid?
       match = MATCHER.match(tin)
       return false unless match
+      return false if tin == "0000000000"
 
       if birth_date
         year = "#{birth_century}#{match[:year]}"
@@ -19,6 +26,7 @@ module TinValid
 
       match[:check].to_i == checksum
     end
+    # rubocop:enable Metrics/AbcSize
 
     private
 
@@ -38,12 +46,6 @@ module TinValid
     def birth_century = birth_date.strftime("%Y")[..1]
     def birth_year = birth_date.year
 
-    def date(year, month, day)
-      Date.new(year.to_i, month.to_i, day.to_i)
-    rescue Date::Error
-      nil
-    end
-
     def checksum
       # 1. Multiply the values of each position by the corresponding weight:
       weights =

data/lib/tin_valid/estonia_tin.rb

@@ -1,11 +1,16 @@
 # frozen_string_literal: true
 
 module TinValid
-  class EstoniaTin < Data.define(:tin, :birth_date)
+  class EstoniaTin
+    include TinValid::Helpers
+
     def initialize(tin:, birth_date: nil)
-      super
+      @tin = tin
+      @birth_date = birth_date
     end
 
+    attr_reader :tin, :birth_date
+
     def valid?
       match = MATCHER.match(tin)
       return false unless match
@@ -36,12 +41,6 @@ module TinValid
     def birth_century = birth_date.strftime("%Y")[..1]
     def birth_year = birth_date.year
 
-    def date(year, month, day)
-      Date.new(year.to_i, month.to_i, day.to_i)
-    rescue Date::Error
-      nil
-    end
-
     def checksum
       # 1. Multiply the values of each position by the corresponding weight:
       # 2. Add up the results of the above multiplications;

data/lib/tin_valid/finland_tin.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module TinValid
+  class FinlandTin
+    include TinValid::Helpers
+
+    def initialize(tin:, birth_date: nil)
+      @tin = tin
+      @birth_date = birth_date
+    end
+
+    attr_reader :tin, :birth_date
+
+    def valid?
+      match = MATCHER.match(tin)
+      return false unless match
+
+      tin_date = date(
+        "#{tin_century(match[:century])}#{match[:year]}",
+        match[:month],
+        match[:day],
+      )
+      return false unless tin_date
+      return false if birth_date && birth_date != tin_date
+
+      tin[-1] == check
+    end
+
+    private
+
+    MATCHER = %r{
+      \A
+      (?<day>[0-3][0-9])
+      (?<month>[0-1][0-9])
+      (?<year>[0-9][0-9])
+      (?<century>[-+A-FU-Y])
+      [0-9]{3}
+      [0-9A-Z]
+      \z
+    }x
+    private_constant :MATCHER
+
+    def tin_century(character)
+      case character
+      when "+" then 18
+      when "-", "U", "V", "W", "X", "Y" then 19
+      else 20
+      end
+    end
+
+    def check
+      # 1. Concatenate C1, C2, C3, C4, C5, C6, C8, C9, C10
+      # (warning: C7 is not part of the check digit);
+      number = "#{tin[0..5]}#{tin[7..9]}".to_i
+
+      # 2. Calculate the modulo 31 of the abovementioned number;
+      remainder = number % 31
+
+      # 4. The result of calculating modulo 31 will give as a result a number,
+      # which will provide the check mark through the following table:
+      case remainder
+      when ..9 then remainder.to_s
+      when ..15 then (remainder + 55).chr
+      when 16 then "H"
+      when ..21 then (remainder + 57).chr
+      when 21 then "P"
+      else (remainder + 59).chr
+      end
+    end
+  end
+end

data/lib/tin_valid/france_tin.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module TinValid
+  class FranceTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
+    def valid?
+      return false unless /\A[0-3][0-9]{12}\z/.match?(tin)
+      return false if tin == "0000000000000"
+
+      tin[-3..].to_i == check
+    end
+
+    private
+
+    def check
+      # 1. Concatenate C1, C2, C3, C4, C5, C6, C7, C8, C9, C10;
+      # 2. Get modulo 511 of the result of the previous result;
+      # 3. Check digit = remainder if remainder < 100, C11 = 0
+      # (if remainder < 10, C11 = 0 and C12 = 0).
+      tin[..-4].to_i % 511
+    end
+  end
+end

data/lib/tin_valid/germany_tin.rb

@@ -1,7 +1,13 @@
 # frozen_string_literal: true
 
 module TinValid
-  class GermanyTin < Data.define(:tin)
+  class GermanyTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
     def valid?
       valid_v1? || valid_v2?
     end
@@ -12,7 +18,9 @@ module TinValid
       # 1. 13 characters
       # 2. Only digits
       # 3. C5 is a 0
-      /\A[0-9]{4}0[0-9]{8}\z/.match?(tin)
+      return false unless /\A[0-9]{4}0[0-9]{8}\z/.match?(tin)
+
+      tin.to_i != 0
     end
 
     # rubocop:disable Metrics/AbcSize
@@ -48,13 +56,16 @@ module TinValid
         # 3. Multiply the result by 2;
         result *= 2
 
-        # 4. Take modulo 11 of the result. Update the value of variable X with the result of this operation;
+        # 4. Take modulo 11 of the result. Update the value of variable X with
+        # the result of this operation;
         x = result % 11
 
         # 5. Take C2 + X modulo 10. If result is 0, result is 10;
         # 6. Multiply the result by 2;
-        # 7. Take modulo 11 of the result. Update the value of variable X with the result of this operation;
-        # 8. Apply steps 5, 6 and 7 in an analogue way for digits C3 to C10. Consider that last value called Y;
+        # 7. Take modulo 11 of the result. Update the value of variable X with
+        # the result of this operation;
+        # 8. Apply steps 5, 6 and 7 in an analogue way for digits C3 to C10.
+        # Consider that last value called Y;
         x
       end
 

data/lib/tin_valid/greece_tin.rb

@@ -1,9 +1,17 @@
 # frozen_string_literal: true
 
 module TinValid
-  class GreeceTin < Data.define(:tin)
+  class GreeceTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
     def valid?
-      /\A[0-9]{9}\z/.match?(tin)
+      return false unless /\A[0-9]{9}\z/.match?(tin)
+
+      tin != "000000000" && tin != "123456789"
     end
   end
 end

data/lib/tin_valid/helpers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module TinValid
+  module Helpers
+    private
+
+    def date(year, month, day)
+      found_date = Date.new(year.to_i, month.to_i, day.to_i)
+      found_date if found_date < Date.today
+    rescue Date::Error
+      nil
+    end
+  end
+end

data/lib/tin_valid/hungary_tin.rb

@@ -1,7 +1,13 @@
 # frozen_string_literal: true
 
 module TinValid
-  class HungaryTin < Data.define(:tin)
+  class HungaryTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
     def valid?
       return false unless /\A8[0-9]{9}\z/.match?(tin)
 
@@ -11,8 +17,6 @@ module TinValid
     private
 
     def check
-      tin[..-2].chars
-
       # 1. Multiply the values of each position by the corresponding weight:
       # 2. Add up the results of the above multiplications;
       result = (1..9).each_with_index.sum { |num, i| num * tin[i].to_i }