tin_valid 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5b010dba783fef5da5341515542f830f73ac1baeca9fd8334fee16867d07a5a
-  data.tar.gz: 42d87f203dd942dc281636c0f3ff6b21e4104d9ae22904974cc81d7f503ead3a
+  metadata.gz: b248c0be6699ce56b48b082c320833ff8cb5594a62762d298ea66315d8d7555b
+  data.tar.gz: a04549a7599fbadd881f1f905e2c13235d83a3e1d4b7bd8d79dc16393cd18465
 SHA512:
-  metadata.gz: 886d2bfe8eb377af5fed28166a3a97f2a56f0c5dddea52c06f5e844d0a6d7194e73750a601422ce9e2a90ed93fe5f7ee99f323c6af56c375d53b5b4a83bb1b30
-  data.tar.gz: '09cd02962705707d397f82dba292263a5414ecf1993bb67c5d87645f6f782a50a74cfe75c97e3cddba494767a8442de2ad6515872b0b5a60d16e4ad22d6f5875'
+  metadata.gz: 608e79cfe16d11cd236c02a4b5dffa9062a4b26b0f8816c2e9a9da350471917a5cc7ac6802202223ec6936f82cc0f91f9b820118a9c56868b2c6c4a9eaa8f67f
+  data.tar.gz: a17c2624d59049524fbeb5b8adec5263dd6c4009d7bb90c594ad01c499c990a6784515a195bbd3a16148278c32f524b71067b6f0095020dccd24ae5a65987da4

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 ## [Unreleased]
 
+## [0.1.1] - 2025-04-15
+
+Features:
+- Add Germany 🇩🇪
+- Add Greece 🇬🇷
+- Add Hungary 🇭🇺
+- Add Ireland 🇮🇪
+- Add #normalized to Austria 🇦🇹
+
 ## [0.1.0] - 2025-04-14
 
-- Initial release
+- Initial release with:
+  - Austria 🇦🇹
+  - Belgium 🇧🇪
+  - Bulgaria 🇧🇬
+  - Croatia 🇭🇷
+  - Cyprus 🇨🇾
+  - Czechia 🇨🇿
+  - Denmark 🇩🇰
+  - Estonia 🇪🇪
+  - Germany 🇩🇪
+  - Greece 🇬🇷
+  - Sweden 🇸🇪

data/README.md

@@ -1,20 +1,27 @@
-# TinValid
+# TinValid 🇪🇺
 
 Validate Tax Identification Numbers (TINs) for the following European countries:
 
-- Austria
-- Belgium
-- Bulgaria
-- Croatia
-- Cyprus
-- Czechia
-- Denmark
-- Estonia
-- Sweden
+- Austria 🇦🇹
+- Belgium 🇧🇪
+- Bulgaria 🇧🇬
+- Croatia 🇭🇷
+- Cyprus 🇨🇾
+- Czechia 🇨🇿
+- Denmark 🇩🇰
+- Estonia 🇪🇪
+- Germany 🇩🇪
+- Greece 🇬🇷
+- Hungary 🇭🇺
+- Ireland 🇮🇪
+- Sweden 🇸🇪
+
+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).
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+Add the gem to your application’s Gemfile by executing:
 
 ```bash
 bundle add tin_valid
@@ -31,7 +38,8 @@ gem install tin_valid
 
 ```rb
 # Austria
-TinValid::AustriaTin.new(tin: "…").valid?
+TinValid::AustriaTin.new(tin: "93-173/6581").valid? # => true
+TinValid::AustriaTin.new(tin: "93-173/6581").normalized # => "931736581"
 
 # Belgium
 # Optional birth_date
@@ -80,10 +88,10 @@ git commits and the created tag, and push the `.gem` file to
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at
-https://github.com/sunny/tin_valid. This project is intended to be a safe,
+https://github.com/cults/tin_valid. This project is intended to be a safe,
 welcoming space for collaboration, and contributors are expected to adhere to
 the
-[code of conduct](https://github.com/sunny/tin_valid/blob/main/CODE_OF_CONDUCT.md).
+[code of conduct](https://github.com/cults/tin_valid/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -94,4 +102,4 @@ The gem is available as open source under the terms of the
 
 Everyone interacting in the TinValid project's codebases, issue trackers, chat
 rooms and mailing lists is expected to follow the
-[code of conduct](https://github.com/sunny/tin_valid/blob/main/CODE_OF_CONDUCT.md).
+[code of conduct](https://github.com/cults/tin_valid/blob/main/CODE_OF_CONDUCT.md).

data/lib/tin_valid/austria_tin.rb

@@ -1,15 +1,28 @@
 # frozen_string_literal: true
 
 module TinValid
-  class AustriaTin < Data.define(:tin)
+  class AustriaTin
+    def initialize(tin:)
+      @tin = tin
+    end
+
+    attr_reader :tin
+
     def valid?
-      return false unless /\A[0-9]{9}\z/.match?(tin)
+      return false unless MATCHER.match?(normalized)
 
-      tin[-1] == check
+      normalized[-1] == check
+    end
+
+    def normalized
+      @normalized ||= tin.to_s.strip.tr("-/", "")
     end
 
     private
 
+    MATCHER = %r{\A[0-9]{2}-?[0-9]{3}/?[0-9]{4}\z}
+    private_constant :MATCHER
+
     # rubocop:disable Metrics/AbcSize
     def check
       # 1. Multiply the values of each position by the corresponding weight:
@@ -22,10 +35,10 @@ module TinValid
       # - C7: 1
       # - C8: 2
       values_by_weight =
-        tin
-          .chars
+        normalized
+          .chars[..-2]
           .each_with_index
-          .map { |n, i| n.to_i * (i.even? ? 2 : 1) }
+          .map { |n, i| n.to_i * (i.even? ? 1 : 2) }
 
       # 2. If the product of a doubling operation is > 9, sum the digits of the
       # product;

data/lib/tin_valid/germany_tin.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module TinValid
+  class GermanyTin < Data.define(:tin)
+    def valid?
+      valid_v1? || valid_v2?
+    end
+
+    private
+
+    def valid_v1?
+      # 1. 13 characters
+      # 2. Only digits
+      # 3. C5 is a 0
+      /\A[0-9]{4}0[0-9]{8}\z/.match?(tin)
+    end
+
+    # rubocop:disable Metrics/AbcSize
+    def valid_v2?
+      # C1: Must never be 0.
+      return false unless /\A[1-9][0-9]{10}\z/.match?(tin)
+
+      # C1-C10: One and only one mandatory duplicate or triple value:
+      # - One of the first ten digits is used twice (the recurrent digits do
+      #   not have to be located at subsequent positions but they can be);
+      # - One of the first ten digits is used tree times (only two recurrent
+      #   digits are allowed to be one after another).
+      consecutive_chars =
+        tin[..-2]
+          .chars
+          .group_by(&:itself)
+          .select { |_, chars| chars.size > 1 }
+
+      return false if consecutive_chars.size != 1
+      return false if consecutive_chars.first.last.size > 3
+
+      tin[-1].to_i == check_v2
+    end
+    # rubocop:enable Metrics/AbcSize
+
+    def check_v2
+      # 1. Initialize the variable X to 10.
+      y = tin[..-2].chars.inject(10) do |x, char|
+        # 2. Take C1 + X modulo 10. If result is 0, result is 10;
+        result = (char.to_i + x) % 10
+        result = 10 if result == 0
+
+        # 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;
+        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;
+        x
+      end
+
+      # 9. 11 - Y = check digit. If check digit = 10, replace it by 0.
+      check = 11 - y
+      check == 10 ? 0 : check
+    end
+  end
+end

data/lib/tin_valid/greece_tin.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module TinValid
+  class GreeceTin < Data.define(:tin)
+    def valid?
+      /\A[0-9]{9}\z/.match?(tin)
+    end
+  end
+end

data/lib/tin_valid/hungary_tin.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module TinValid
+  class HungaryTin < Data.define(:tin)
+    def valid?
+      return false unless /\A8[0-9]{9}\z/.match?(tin)
+
+      tin[-1].to_i == check
+    end
+
+    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 }
+
+      # 3. Get modulo 11 of the result of the previous addition;
+      # 4. Check digit = remainder.
+      result % 11
+    end
+  end
+end

data/lib/tin_valid/ireland_tin.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module TinValid
+  class IrelandTin < Data.define(:tin)
+    def valid?
+      /\A[0-9]{7}[A-W][A-IW]?\z/.match?(tin) &&
+        tin.chars[7] == check
+    end
+
+    private
+
+    # rubocop:disable Metrics/AbcSize
+    def check
+      # 1. In reverse order, each digit is multiplied by a weight started at 2:
+      weights = 8.downto(2)
+      digits = weights.with_index.map { |weight, i| weight * tin.chars[i].to_i }
+
+      # 2. LetterToNumber(C9) is based on the following mapping:
+      # “A”=1, “B”=2, “C”=3, “D”=4, “E”=5, “F”=6, “G”=7, “H”=8, “I”=9
+      # A “W” or absence of character in position 9 is allocated a numeric
+      # value of 0.
+      digits.push letter_to_number(tin.chars[9 - 1]) * 9
+
+      # 3. Add up each result;
+      sum = digits.sum
+
+      # 4. The remainder of the modulo 23 indicates the character position on
+      # the alphabet according to the following mapping:
+      # 0=”W”, 1=”A”, 2=”B”, 3=”C”… 22=”V”
+      number_to_letter(sum % 23)
+    end
+    # rubocop:enable Metrics/AbcSize
+
+    def letter_to_number(letter)
+      return 0 if letter.nil?
+
+      case letter
+      in "W" then 0
+      in "A".."I" then letter.ord - 64
+      end
+    end
+
+    def number_to_letter(number)
+      case number
+      in 0 then "W"
+      in 1..22 then (number + 64).chr
+      end
+    end
+  end
+end

data/lib/tin_valid/version.rb

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

data/lib/tin_valid.rb

@@ -10,9 +10,10 @@ require_relative "tin_valid/cyprus_tin"
 require_relative "tin_valid/czechia_tin"
 require_relative "tin_valid/denmark_tin"
 require_relative "tin_valid/estonia_tin"
+require_relative "tin_valid/germany_tin"
+require_relative "tin_valid/greece_tin"
+require_relative "tin_valid/hungary_tin"
+require_relative "tin_valid/ireland_tin"
 require_relative "tin_valid/sweden_tin"
 
-module TinValid
-  class Error < StandardError; end
-  # Your code goes here...
-end
+module TinValid; end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tin_valid
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Sunny Ripert
 bindir: exe
 cert_chain: []
-date: 2025-04-14 00:00:00.000000000 Z
+date: 2025-04-15 00:00:00.000000000 Z
 dependencies: []
 email:
 - sunny@sunfox.org
@@ -31,6 +31,10 @@ files:
 - lib/tin_valid/czechia_tin.rb
 - lib/tin_valid/denmark_tin.rb
 - lib/tin_valid/estonia_tin.rb
+- lib/tin_valid/germany_tin.rb
+- lib/tin_valid/greece_tin.rb
+- lib/tin_valid/hungary_tin.rb
+- lib/tin_valid/ireland_tin.rb
 - lib/tin_valid/sweden_tin.rb
 - lib/tin_valid/version.rb
 - sig/tin_valid.rbs