taiwan_id_validator 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e27b20cfcf0bd1b75f3d5093a51b06610c63251338a7202e920ccdf88235d541
+  data.tar.gz: 61edb228f56683a8d18049ec6f139b37ca4c826b4defaa752d39bcc6e5357278
+SHA512:
+  metadata.gz: 9538506497569a6ff52de63cb55665cb7324915c0d5e49eefdf9dc16fac8733deb588ab84c046468c2d6b201b0c366c074a3354303b8dd33a2681e275a7e58dd
+  data.tar.gz: dc4e7fec03230cc0cbb9953f03e3434cca562b970a686c5bb4260097c05362e94f0407cd7f3be81d777216dfa8cbd1e3316555243d5947efa799ed2d4cf20b9a

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chen Guan-Ting
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Taiwan ID Validator (for Ruby)
+
+[![Ruby CI](https://github.com/guanting112/taiwan-id-validator-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/guanting112/taiwan-id-validator-ruby/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+`taiwan_id_validator` is a lightweight and zero-dependency Ruby gem for validating Taiwan National IDs, Alien Resident Certificates (ARC), and Unified Business Numbers (UBN).
+
+It supports:
+- **Taiwan National ID** (中華民國身分證字號)
+- **New Alien Resident Certificate** (新式外來人口統一證號) (Since 2021)
+- **Old Alien Resident Certificate** (舊式外來人口統一證號)
+- **Unified Business Number (UBN)**: Validates company tax IDs, fully supporting the latest logic (including the 7th-digit rule). (新舊格式的統一編號)
+
+## Installation
+
+```bash
+gem install taiwan_id_validator
+# or 
+bundle add taiwan_id_validator
+```
+
+## Usage
+
+```ruby
+require 'taiwan_id_validator'
+
+TaiwanIdValidator.valid?('A123456789') # true
+TaiwanIdValidator.valid?('A824285055') # true
+TaiwanIdValidator.valid?('G951582036') # true
+TaiwanIdValidator.valid?('AC01234567') # true
+TaiwanIdValidator.valid?('AC01234566') # false
+TaiwanIdValidator.valid?('A123456788') # false
+
+TaiwanIdValidator.valid_national_id?('A123456789') # true
+TaiwanIdValidator.valid_national_id?('A123456788') # false
+
+TaiwanIdValidator.valid_arc_id?('AC01234567') # true
+TaiwanIdValidator.valid_arc_id?('AC01234565') # false
+
+TaiwanIdValidator.valid_ubn?('00000000') # false
+TaiwanIdValidator.valid_ubn?('22099131') # true
+TaiwanIdValidator.valid_ubn?('84149961') # true
+```

data/lib/taiwan_id_validator.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module TaiwanIdValidator
+  UBN_WEIGHTS = [1, 2, 1, 2, 1, 2, 4, 1].freeze
+  LETTER_WEIGHTS = {
+    'A' => 10, 'B' => 11, 'C' => 12, 'D' => 13, 'E' => 14, 'F' => 15, 'G' => 16,
+    'H' => 17, 'J' => 18, 'K' => 19, 'L' => 20, 'M' => 21, 'N' => 22, 'P' => 23,
+    'Q' => 24, 'R' => 25, 'S' => 26, 'T' => 27, 'U' => 28, 'V' => 29, 'X' => 30,
+    'Y' => 31, 'W' => 32, 'Z' => 33, 'I' => 34, 'O' => 35
+  }.freeze
+
+  NATIONAL_ID_REGEX = /^[A-Z][12]\d{8}$/.freeze
+  NEW_ARC_ID_REGEX = /^[A-Z][89]\d{8}$/.freeze
+  OLD_ARC_ID_REGEX = /^[A-Z][A-Z]\d{8}$/.freeze
+  UBN_REGEX = /^\d{8}$/.freeze
+
+  module_function
+
+  # valid? checks if the given ID is a valid Taiwan National ID or Alien Resident Certificate number.
+  def valid?(id)
+    id = id.to_s.upcase
+    if NATIONAL_ID_REGEX.match?(id) || NEW_ARC_ID_REGEX.match?(id)
+      validate_modern_id_card_format(id)
+    elsif OLD_ARC_ID_REGEX.match?(id)
+      validate_old_arc_id_format(id)
+    else
+      false
+    end
+  end
+
+  # ValidateNationId checks if the given ID is a valid Taiwan National ID.
+  def valid_national_id?(id)
+    id = id.to_s.upcase
+    return false unless NATIONAL_ID_REGEX.match?(id)
+
+    validate_modern_id_card_format(id)
+  end
+
+  # valid_arc_id? checks if the given ID is a valid Taiwan Alien Resident Certificate number.
+  def valid_arc_id?(id)
+    id = id.to_s.upcase
+    if NEW_ARC_ID_REGEX.match?(id)
+      validate_modern_id_card_format(id)
+    elsif OLD_ARC_ID_REGEX.match?(id)
+      validate_old_arc_id_format(id)
+    else
+      false
+    end
+  end
+
+  # valid_ubn? checks if the given UBN is a valid Taiwan Company Tax ID.
+  def valid_ubn?(ubn)
+    ubn = ubn.to_s
+    return false unless UBN_REGEX.match?(ubn)
+    return false if ubn == "00000000"
+
+    sum1 = 0
+    sum2 = 0
+
+    UBN_WEIGHTS.each_with_index do |weight, i|
+      digit = ubn[i].to_i
+      if i == 6 && digit == 7
+        sum1 += 1
+        sum2 += 0
+      else
+        product = digit * weight
+        sum1 += (product / 10) + (product % 10)
+        sum2 += (product / 10) + (product % 10)
+      end
+    end
+
+    (sum1 % 5).zero? || (sum2 % 5).zero?
+  end
+
+  class << self
+    private
+
+    def validate_modern_id_card_format(id)
+      sum = 0
+      
+      area_char = id[0]
+      area_weight = LETTER_WEIGHTS[area_char]
+      return false unless area_weight
+
+      sum += (area_weight / 10) * 1 + (area_weight % 10) * 9
+      
+      weights = [8, 7, 6, 5, 4, 3, 2, 1]
+      
+      id[1..8].chars.each_with_index do |char, i|
+        num = char.to_i
+        sum += num * weights[i]
+      end
+
+      check_digit = id[9].to_i
+      sum += check_digit
+
+      (sum % 10).zero?
+    end
+
+    def validate_old_arc_id_format(id)
+      sum = 0
+      
+      area_char = id[0]
+      area_weight = LETTER_WEIGHTS[area_char]
+      return false unless area_weight
+
+      sum += (area_weight / 10) * 1 + (area_weight % 10) * 9
+      
+      gender_char = id[1]
+      gender_weight = LETTER_WEIGHTS[gender_char]
+      return false unless gender_weight
+      
+      sum += (gender_weight % 10) * 8
+      
+      weights = [7, 6, 5, 4, 3, 2, 1]
+      
+      id[2..8].chars.each_with_index do |char, i|
+        num = char.to_i
+        sum += num * weights[i]
+      end
+
+      check_digit = id[9].to_i
+      sum += check_digit
+
+      (sum % 10).zero?
+    end
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: taiwan_id_validator
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Guanting112
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-12-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 快速驗證台灣身分證、居留證、統一編號 / Validates Taiwan National ID (Citizen), Alien Resident
+  Certificate (ARC, both old and new formats), and Unified Business Number (UBN).
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/taiwan_id_validator.rb
+homepage: https://github.com/guanting112/taiwan-id-validator
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A validator for Taiwan National ID, ARC, and UBN (Company Tax ID)
+test_files: []