tin_valid 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57ef691e689d26ef2b254910aa99a7aee71247ebd5029187404b1fb9ae26d725
-  data.tar.gz: 81e37c9edc4a97698cdc1e264a9c794679e4f417ce01284f78a62f16b87b3a77
+  metadata.gz: 3fb98f7f433b3c6a6755c0caa0835c75ed58408fee17ee0e96a083603fd965d5
+  data.tar.gz: 2eb697ac67268456c7cd8ff346144b3cbbfcb2b4bbff8052065ad6b7789b0d15
 SHA512:
-  metadata.gz: 04d22d7d57e37bba3cd2de93f5af77883671520143e8cd15b62f3062b388e71a774b49c2c58c90970b4ef72d14d3b80a3ff9c5fb7aa1a0ba9f84561f466f75f7
-  data.tar.gz: '089d95d8d72de2f7ed52958c194112bedde0bc982b58ec3cc134db13b5eea8b72f44df2bfdffe898e6aa61f962d6976ac53b3fcfa4a3cf3e8f9a1db9da34743d'
+  metadata.gz: ea7cd37992f808250a153fa5be6728489438136701318e8397d1822512efaddfd8ed395534cdc0e62f8523f9ec225cb151f37409ea741accdcd8c233e7858e5f
+  data.tar.gz: 91eefad78dd3d3219cb7e4add5b5022cd72f62e09a7d6fa5b8b9279e60e165a7620ca2ab25fe4ccb94da5b629f6251e814aeeff0007399830b275be3b99e5ce7

data/.rubocop.yml

@@ -12,6 +12,7 @@ Layout/LineLength:
   Max: 80
   Exclude:
     - bin/rspec
+    - bin/rake
 
 Layout/MultilineMethodCallIndentation:
   # On multiline calls, indent starting from the receiver.
@@ -33,6 +34,13 @@ Metrics/BlockLength:
   Exclude:
     - spec/**/*
 
+# Security
+
+Security/Eval:
+  # Allow the use of `eval` in specs.
+  Exclude:
+    - spec/**/*
+
 # Style
 
 Style/Documentation:

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [1.2.0] - 2025-05-14
+
+Features:
+- Add generic `TinValid::Tin.new(country_code: "…", tin: "…").valid?`
+- Add `#siren?` and `#siret?` on `TinValid::FranceTin`
+
+Fixes:
+- Accept SIRET for France
+
 ## [1.1.2] - 2025-05-06
 
 Fixes:

data/README.md

@@ -54,105 +54,269 @@ gem install tin_valid
 
 ## Usage
 
+Check a TIN by providing the country code as a lowercase string.
+
+Also accepts the following optional arguments:
+
+- `birth_date`: Date
+- `kind`: `"individual"` or `"company"`
+
+```rb
+TinValid::Tin.new(country_code: "fr", tin: "3023217600053").valid?
+```
+
+You can also call countries individually:
+
+### Austria (at)
+
+```rb
+TinValid::AustriaTin.new(
+  tin: "931736581",
+).valid?
+```
+
+### Belgium (be)
+
+`birth_date` is optional
+
+```rb
+TinValid::BelgiumTin.new(
+  tin: "00012511119",
+  birth_date: Date.new(1900, 1, 25),
+).valid?
+```
+
+### Bulgaria (bg)
+
+`birth_date` is optional
+
+```rb
+TinValid::BulgariaTin.new(
+  tin: "7501010010",
+  birth_date: Date.new(1975, 1, 1),
+).valid?
+```
+
+### Croatia (hr)
+
+```rb
+TinValid::CroatiaTin.new(
+  tin: "94577403194",
+).valid?
+```
+
+### Cyprus (cy)
+
+`kind` is optional and can be `"individual"` or `"company"`
+
+```rb
+TinValid::CyprusTin.new(tin: "00123123T", kind: "individual").valid?
+```
+
+### Czechia (cz)
+
+`birth_date` is optional
+
+```rb
+TinValid::CzechiaTin.new(
+  tin: "420901999",
+  birth_date: Date.new(1942, 9, 1),
+).valid?
+```
+
+### Denmark (dk)
+
+`birth_date` is optional
+
+```rb
+TinValid::DenmarkTin.new(
+  tin: "0101111113",
+  birth_date: Date.new(1911, 1, 1),
+).valid?
+```
+
+### Estonia (ee)
+
+`birth_date` is optional
+
+```rb
+TinValid::EstoniaTin.new(
+  tin: "37102250382",
+  birth_date: Date.new(1971, 2, 25),
+).valid?
+```
+
+### Finland (fi)
+
+`birth_date` is optional
+
+```rb
+TinValid::FinlandTin.new(
+  tin: "131052-308T",
+  birth_date: Date.new(1952, 10, 13),
+).valid?
+```
+
+### France (fr)
+
+```rb
+TinValid::FranceTin.new(tin: "3023217600053").valid?
+```
+
+```rb
+TinValid::FranceTin.new(tin: "732829320").siren?
+```
+
 ```rb
-# Austria
-TinValid::AustriaTin.new(tin: "…").valid? # => true
+TinValid::FranceTin.new(tin: "73282932000074").siret?
+```
+
+### Germany (de)
+
+```rb
+TinValid::GermanyTin.new(tin: "5133081508159").valid?
+```
 
-# Belgium
-# Optional birth_date
-TinValid::BelgiumTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Greece (gr)
 
-# Bulgaria
-# Optional birth_date
-TinValid::BulgariaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+```rb
+TinValid::GreeceTin.new(tin: "999999999").valid?
+```
 
-# Croatia
-TinValid::CroatiaTin.new(tin: "…").valid?
+### Hungary (hu)
 
-# Cyprus
-# Optional kind ("individual" or "company")
-TinValid::CyprusTin.new(tin: "…", kind: "individual").valid?
+```rb
+TinValid::HungaryTin.new(tin: "8071592153").valid?
+```
 
-# Czechia
-# Optional birth_date
-TinValid::CzechiaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Ireland (ie)
 
-# Denmark
-# Optional birth_date
-TinValid::DenmarkTin.new(tin: "…", birth_date: Date.new(…)).valid?
+```rb
+TinValid::IrelandTin.new(tin: "1234567T").valid?
+```
 
-# Estonia
-# Optional birth_date
-TinValid::EstoniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Italy (it)
 
-# Finland
-# Optional birth_date
-TinValid::FinlandTin.new(tin: "…", birth_date: Date.new(…)).valid?
+`birth_date` is optional
 
-# France
-TinValid::FranceTin.new(tin: "…").valid?
+```rb
+TinValid::ItalyTin.new(
+  tin: "DMLPRY77D15H501F",
+  birth_date: Date.new(1977, 4, 15),
+).valid?
+```
 
-# Germany
-TinValid::GermanyTin.new(tin: "…").valid?
+### Latvia (lv)
 
-# Greece
-TinValid::GreeceTin.new(tin: "…").valid?
+`birth_date` is optional
 
-# Hungary
-TinValid::HungaryTin.new(tin: "…").valid?
+```rb
+TinValid::LatviaTin.new(
+  tin: "01011012345",
+  birth_date: Date.new(1910, 1, 1),
+).valid?
+```
 
-# Ireland
-TinValid::IrelandTin.new(tin: "…").valid?
+### Lithuania (lt)
 
-# Italy
-# Optional birth_date
-TinValid::ItalyTin.new(tin: "…", birth_date: Date.new(…)).valid?
+`birth_date` is optional
 
-# Latvia
-# Optional birth_date
-TinValid::LatviaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+```rb
+TinValid::LithuaniaTin.new(
+  tin: "10101010005",
+  birth_date: Date.new(2001, 1, 1),
+).valid?
+```
 
-# Lithuania
-# Optional birth_date
-TinValid::LithuaniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Luxembourg (lu)
 
-# Luxembourg
-# Optional birth_date
-TinValid::LuxembourgTin.new(tin: "…", birth_date: Date.new(…)).valid?
+`birth_date` is optional
 
-# Malta
-TinValid::MaltaTin.new(tin: "…").valid?
+```rb
+TinValid::LuxembourgTin.new(
+  tin: "1893120105732",
+  birth_date: Date.new(1893, 12, 1),
+).valid?
+```
 
-# Netherlands
-TinValid::NetherlandsTin.new(tin: "…").valid?
+### Malta (mt)
 
-# Poland
-# Optional birth_date
-TinValid::PolandTin.new(tin: "…", birth_date: Date.new(…)).valid?
+```rb
+TinValid::MaltaTin.new(tin: "1234567A").valid?
+```
 
-# Portugal
-TinValid::PortugalTin.new(tin: "…").valid?
+### Netherlands (nl)
 
-# Romania
-# Optional birth_date
-TinValid::RomaniaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+```rb
+TinValid::NetherlandsTin.new(tin: "174559434").valid?
+```
 
-# Slovakia
-# Optional birth_date
-TinValid::SlovakiaTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Poland (pl)
 
-# Slovenia
-TinValid::SloveniaTin.new(tin: "…").valid?
+`birth_date` is optional
 
-# Spain
-TinValid::SpainTin.new(tin: "…").valid?
+```rb
+TinValid::PolandTin.new(
+  tin: "02070803628",
+  birth_date: Date.new(1902, 7, 8),
+).valid?
+```
 
-# Sweden
-# Optional birth_date
-TinValid::SwedenTin.new(tin: "…", birth_date: Date.new(…)).valid?
+### Portugal (pt)
 
-# United Kingdom
-TinValid::UnitedKingdomTin.new(tin: "…").valid?
+```rb
+TinValid::PortugalTin.new(tin: "299999998").valid?
+```
+
+### Romania (ro)
+
+`birth_date` is optional
+
+```rb
+TinValid::RomaniaTin.new(
+  tin: "8001011234567",
+  birth_date: Date.new(2000, 10, 11),
+).valid?
+```
+
+### Slovakia (sk)
+
+`birth_date` is optional
+
+```rb
+TinValid::SlovakiaTin.new(
+  tin: "7711167420",
+  birth_date: Date.new(1977, 11, 16),
+).valid?
+```
+
+### Slovenia (si)
+
+```rb
+TinValid::SloveniaTin.new(tin: "15012557").valid?
+```
+
+### Spain (es)
+
+```rb
+TinValid::SpainTin.new(tin: "54237A").valid?
+```
+
+### Sweden (se)
+
+`birth_date` is optional
+
+```rb
+TinValid::SwedenTin.new(
+  tin: "640823-3234",
+  birth_date: Date.new(1964, 8, 23),
+).valid?
+```
+
+### United Kingdom (gb)
+
+```rb
+TinValid::UnitedKingdomTin.new(tin: "9234567890").valid?
 ```
 
 ## Development

data/lib/tin_valid/france_tin.rb

@@ -9,7 +9,23 @@ module TinValid
 
     attr_reader :tin
 
-    def valid? = valid_v1? || valid_siren?
+    def valid? = valid_v1? || siren? || siret?
+
+    # https://fr.wikipedia.org/wiki/Syst%C3%A8me_d%27identification_du_r%C3%A9pertoire_des_entreprises
+    def siren?
+      return false unless /\A[1-9][0-9]{8}\z/.match?(tin)
+      return false if tin == "123456789"
+
+      luhn_valid?
+    end
+
+    # https://fr.wikipedia.org/wiki/Syst%C3%A8me_d%27identification_du_r%C3%A9pertoire_des_%C3%A9tablissements
+    def siret?
+      return false unless /\A\d{14}\z/.match?(tin)
+      return false if tin == "00000000000000"
+
+      luhn_valid?
+    end
 
     private
 
@@ -17,22 +33,24 @@ module TinValid
       return false unless /\A[0-3][0-9]{12}\z/.match?(tin)
       return false if tin == "0000000000000"
 
-      tin[-3..].to_i == check
+      tin[-3..].to_i == v1_check
     end
 
-    # https://annuaire-entreprises.data.gouv.fr/definitions/numero-siren
-    def valid_siren?
-      return false if tin == "123456789"
-
-      /\A[1-9][0-9]{8}\z/.match?(tin)
-    end
-
-    def check
+    def v1_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
+
+    # https://en.wikipedia.org/wiki/Luhn_algorithm
+    def luhn_valid?
+      check = tin.chars.reverse.each_slice(2).sum do |a, b|
+        a.to_i + (b.to_i * 2).to_s.chars.sum(&:to_i)
+      end
+
+      check % 10 == 0
+    end
   end
 end

data/lib/tin_valid/tin.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module TinValid
+  class Tin
+    def initialize(country_code:, tin:, birth_date: nil, kind: nil)
+      @country_code = country_code
+      @tin = tin
+      @birth_date = birth_date
+      @kind = kind
+    end
+
+    attr_reader :country_code, :tin, :birth_date, :kind
+
+    # rubocop:disable Metrics/AbcSize
+    # rubocop:disable Metrics/CyclomaticComplexity
+    # rubocop:disable Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength
+    def valid?
+      case country_code
+      in "at" then AustriaTin.new(tin:).valid?
+      in "be" then BelgiumTin.new(tin:, birth_date:).valid?
+      in "bg" then BulgariaTin.new(tin:, birth_date:).valid?
+      in "cy" then CyprusTin.new(tin:, kind:).valid?
+      in "cz" then CzechiaTin.new(tin:, birth_date:).valid?
+      in "de" then GermanyTin.new(tin:).valid?
+      in "dk" then DenmarkTin.new(tin:, birth_date:).valid?
+      in "ee" then EstoniaTin.new(tin:, birth_date:).valid?
+      in "es" then SpainTin.new(tin:).valid?
+      in "fi" then FinlandTin.new(tin:).valid?
+      in "fr" then FranceTin.new(tin:).valid?
+      in "gb" then UnitedKingdomTin.new(tin:).valid?
+      in "gr" then GreeceTin.new(tin:).valid?
+      in "hr" then CroatiaTin.new(tin:).valid?
+      in "hu" then HungaryTin.new(tin:).valid?
+      in "ie" then IrelandTin.new(tin:).valid?
+      in "it" then ItalyTin.new(tin:, birth_date:).valid?
+      in "lt" then LithuaniaTin.new(tin:, birth_date:).valid?
+      in "lu" then LuxembourgTin.new(tin:, birth_date:).valid?
+      in "lv" then LatviaTin.new(tin:, birth_date:).valid?
+      in "mt" then MaltaTin.new(tin:).valid?
+      in "nl" then NetherlandsTin.new(tin:).valid?
+      in "pl" then PolandTin.new(tin:, birth_date:).valid?
+      in "pt" then PortugalTin.new(tin:).valid?
+      in "ro" then RomaniaTin.new(tin:, birth_date:).valid?
+      in "se" then SwedenTin.new(tin:, birth_date:).valid?
+      in "si" then SloveniaTin.new(tin:).valid?
+      in "sk" then SlovakiaTin.new(tin:).valid?
+      end
+    end
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/CyclomaticComplexity
+    # rubocop:enable Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength
+  end
+end

data/lib/tin_valid/version.rb

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

data/lib/tin_valid.rb

@@ -3,6 +3,7 @@
 require "date"
 require_relative "tin_valid/version"
 require_relative "tin_valid/helpers"
+require_relative "tin_valid/tin"
 require_relative "tin_valid/austria_tin"
 require_relative "tin_valid/belgium_tin"
 require_relative "tin_valid/bulgaria_tin"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tin_valid
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Sunny Ripert
 bindir: exe
 cert_chain: []
-date: 2025-05-06 00:00:00.000000000 Z
+date: 2025-05-14 00:00:00.000000000 Z
 dependencies: []
 email:
 - sunny@sunfox.org
@@ -51,6 +51,7 @@ files:
 - lib/tin_valid/slovenia_tin.rb
 - lib/tin_valid/spain_tin.rb
 - lib/tin_valid/sweden_tin.rb
+- lib/tin_valid/tin.rb
 - lib/tin_valid/united_kingdom_tin.rb
 - lib/tin_valid/version.rb
 - sig/tin_valid.rbs