e-id 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95f1117835526ba0fa98a96f073c540d7cca1bd83016581060ec067f0280b746
-  data.tar.gz: a866ae7a9bcba3feb047929dd983437f08dd3f052367c0b78b88b977884c4666
+  metadata.gz: 7f6d6da8667f2637e77c105d3a311bc4742a84250fc67c3d8add1ee20e4f45a6
+  data.tar.gz: e380f4ca4b67c6402d45e600f70b9daaea1cf9f13092683b8fd7ed42a9672a2c
 SHA512:
-  metadata.gz: 5ac32ed7526f059926411f54cfd64f950b554868c704246206157a77776c8a3201a6441921e1e6143b4e2804a5799abc90d2fd3bb49e8ae4de9a0b26acc6568c
-  data.tar.gz: f27d33289cebfc93546ec3d52927cd305884f400886e2d158ad5128c6bb8b83c7e1571f6ffb1fcea2a9362d487652091898cd2b05c02e7c1e660fc14481becb4
+  metadata.gz: 8976fee6f2850417ff7c987283202d3de7e03ca67867be2ced0f92d58702b4f7bbb3f1d3e079453b32285e7d6bfd2274ec11f431df151c47e334c18a4cdbc78a
+  data.tar.gz: 5b62029106040fbbe886a2ffe259091e3f5f6cfe2dd09310ab59db4d8cee40669d64ce03cf422dc8756fdbaff54bac70550b198e384ff65dc3a3612a62824649

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change log
 
+## v0.3.0
+
+* Support Latvia identity codes
+
+## v0.2.0
+
+* Support Finland and Lithuania identity codes
+
 ## v0.1.0
 
-* Initial release
+* Initial release: support Estonia identity codes

data/Gemfile

@@ -9,7 +9,7 @@ gemspec
 group :development, :test do
   gem 'rspec', '~> 3.12.0'
   gem 'rubocop', '~> 1.50.2'
-  gem 'rubocop-performance', '~> 1.16.0'
+  gem 'rubocop-performance', '~> 1.17.1'
   gem 'rubocop-rspec', '~> 2.19.0'
 end
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    e-id (0.1.0)
+    e-id (0.3.0)
 
 GEM
   remote: https://rubygems.org/
@@ -44,7 +44,7 @@ GEM
       parser (>= 3.2.1.0)
     rubocop-capybara (2.18.0)
       rubocop (~> 1.41)
-    rubocop-performance (1.16.0)
+    rubocop-performance (1.17.1)
       rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
     rubocop-rspec (2.19.0)
@@ -69,7 +69,7 @@ DEPENDENCIES
   rake (~> 13.0.6)
   rspec (~> 3.12.0)
   rubocop (~> 1.50.2)
-  rubocop-performance (~> 1.16.0)
+  rubocop-performance (~> 1.17.1)
   rubocop-rspec (~> 2.19.0)
   simplecov (~> 0.22.0)
 

data/README.md

@@ -2,21 +2,34 @@
 
 Electronic identity in Estonia and in other countries
 
+## Supported countries
+
+- [x] Estonia
+- [x] Finland
+- [ ] Sweden
+- [x] Lithuania
+- [x] Latvia
+- [ ] Denmark
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'e-id', '~> 0.1.0'
+gem 'e-id', '~> 0.3.0'
 ```
 
 And then execute:
 
-    $ bundle
+```bash
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install e-id
+```bash
+gem install e-id
+```
 
 ## Usage
 

data/TODO.md

@@ -0,0 +1,8 @@
+# Todo
+
+- [x] Estonia national identity
+- [x] Finland national identity
+- [x] Lithuania national identity
+- [x] Latvia national identity
+- [ ] easy use in rails model (like validate_identity and mixins)
+- [ ] ruby 2.4 support

data/lib/e-id.rb

@@ -2,4 +2,7 @@
 
 require 'eid/core'
 require 'eid/estonia'
+require 'eid/finland'
+require 'eid/latvia'
+require 'eid/lithuania'
 require 'eid/version'

data/lib/eid/core.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'date'
+
 module Eid
   class Core
     attr_accessor :identity
@@ -7,5 +9,13 @@ module Eid
     def initialize(identity)
       @identity = identity.to_s
     end
+
+    def gender
+      female? ? :female : :male
+    end
+
+    def age
+      Date.today.year - birth_date&.year.to_i
+    end
   end
 end

data/lib/eid/estonia.rb

@@ -3,13 +3,13 @@
 module Eid
   class Estonia < Core
     # NOTE: identity GYYMMDDSSSC
-    # G – gender
+    # G – gender (even for female, odd for male)
     # YYMMDD – date of birth
     # SSS – serial number
     # C – checksum
 
     def valid?
-      identity.size == 11 && birth_date.is_a?(Date)
+      valid_format? && birth_date.is_a?(Date)
     end
 
     def female?
@@ -20,22 +20,18 @@ module Eid
       identity[0].to_i.odd?
     end
 
-    def gender
-      female? ? :female : :male
-    end
-
     def birth_date
       Date.new((century + identity[1..2].to_i), identity[3..4].to_i, identity[5..6].to_i)
     rescue StandardError
       nil
     end
 
-    def age
-      Date.today.year - birth_date&.year.to_i
-    end
-
     private
 
+    def valid_format?
+      identity.match?(/\d{11}/) && identity.size == 11
+    end
+
     def century
       case identity[0].to_i
       when 1..2 then 1800

data/lib/eid/finland.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Eid
+  class Finland < Core
+    # NOTE: identity DDMMYYCZZZQ
+    # DDMMYY - date of birth
+    # C - century sign (+, -, U, V, W, X, Y, A, B, C, D, E, F)
+    # ZZZ - individual number (002-899 for permanent residents and Finnish citizens, 900-999 for temporary IDs)
+    # Q - control character (checksum)
+
+    VALID_CENTURY_SIGNS = %w[+ - U V W X Y A B C D E F].freeze
+    VALID_CONTROL_CHARACTERS = '0123456789ABCDEFHJKLMNPRSTUVWXY'
+
+    def valid?
+      return false unless identity.size == 11
+
+      birth_date.is_a?(Date) &&
+        VALID_CENTURY_SIGNS.include?(identity[6]) &&
+        VALID_CONTROL_CHARACTERS.include?(identity[10])
+    end
+
+    def female?
+      identity[7..9].to_i.even?
+    end
+
+    def male?
+      identity[7..9].to_i.odd?
+    end
+
+    def birth_date
+      Date.new(century + identity[4..5].to_i, identity[2..3].to_i, identity[0..1].to_i)
+    rescue StandardError
+      nil
+    end
+
+    private
+
+    def valid_format?
+      identity.size == 11
+    end
+
+    def century
+      case identity[6]
+      when '+' then 1800
+      when '-', 'U', 'V', 'W', 'X', 'Y' then 1900
+      when 'A', 'B', 'C', 'D', 'E', 'F' then 2000
+      else 2100
+      end
+    end
+  end
+end

data/lib/eid/latvia.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Eid
+  class Latvia < Core
+    # NOTE: identity DDMMYY-XNNNZ
+    # DDMYY - date of birth
+    # X - century
+    # NNN - birth serial number
+    # Z - checksum digit
+    #
+    # 32XXXX-XXXXC (updated format since 01.07.2017)
+    # 32 - updated format indicator
+    # XXXX-XXXX - random numbers
+    # C - checksum
+
+    def legacy?
+      !identity.start_with?('32')
+    end
+
+    def valid?
+      legacy? ? (valid_format? && birth_date.is_a?(Date)) : valid_format?
+    end
+
+    def female?
+      raise 'Not supported'
+    end
+
+    def male?
+      raise 'Not supported'
+    end
+
+    def gender
+      raise 'Not supported'
+    end
+
+    def birth_date
+      Date.new(century + identity[4..5].to_i, identity[2..3].to_i, identity[0..1].to_i) if legacy?
+    rescue StandardError
+      nil
+    end
+
+    private
+
+    def valid_format?
+      identity.match?(/\d{6}-\d{5}/) && identity.size == 12
+    end
+
+    def century
+      case identity[7].to_i
+      when 1 then 1900
+      when 2 then 2000
+      else 2100
+      end
+    end
+  end
+end

data/lib/eid/lithuania.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Eid
+  class Lithuania < Core
+    # NOTE: identity GYYMMDDNNNC
+    # G – gender (even for female, odd for male)
+    # YYMMDD – date of birth
+    # NNN – serial number
+    # C – checksum
+
+    def valid?
+      valid_format? && birth_date.is_a?(Date)
+    end
+
+    def female?
+      identity[0].to_i.even?
+    end
+
+    def male?
+      identity[0].to_i.odd?
+    end
+
+    def birth_date
+      Date.new((century + identity[1..2].to_i), identity[3..4].to_i, identity[5..6].to_i)
+    rescue StandardError
+      nil
+    end
+
+    private
+
+    def valid_format?
+      identity.match?(/\d{11}/) && identity.size == 11
+    end
+
+    def century
+      case identity[0].to_i
+      when 1..2 then 1800
+      when 3..4 then 1900
+      when 5..6 then 2000
+      else 2100
+      end
+    end
+  end
+end

data/lib/eid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Eid
-  VERSION = '0.1.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: e-id
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - tab
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-04-30 00:00:00.000000000 Z
+date: 2023-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -62,6 +62,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- TODO.md
 - bin/console
 - bin/setup
 - docker-compose.yaml
@@ -69,6 +70,9 @@ files:
 - lib/e-id.rb
 - lib/eid/core.rb
 - lib/eid/estonia.rb
+- lib/eid/finland.rb
+- lib/eid/latvia.rb
+- lib/eid/lithuania.rb
 - lib/eid/version.rb
 homepage: https://github.com/tab/e-id
 licenses:
@@ -78,7 +82,7 @@ metadata:
   source_code_uri: https://github.com/tab/e-id
   changelog_uri: https://github.com/tab/e-id/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -94,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.3.26
-signing_key:
+signing_key: 
 specification_version: 4
 summary: Electronic identity in Estonia and in other countries
 test_files: []