pesel 0.9.0

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in pesel.gemspec
+gemspec

data/README

@@ -0,0 +1,65 @@
+Pesel
+=====
+
+This gem provides the Pesel class to check the PESEL number
+and get information about its owner.
+
+PESEL (Polish Powszechny Elektroniczny System Ewidencji Ludności,
+Universal Electronic System for Registration of the Population)
+is the national identification number used in Poland since 1979.
+
+The PESEL number is mandatory for all permanent residents of Poland
+and for temporary residents living in Poland for over 2 months.
+Applicants for Polish citizenship must request a PESEL number together
+with their passport application.
+
+[http://en.wikipedia.org/wiki/PESEL]
+
+Interesting information about PESEL (in Polish language):
+http://wipos.p.lodz.pl/zylla/ut/pesel.html
+
+If you are looking for the Pesel as a plugin:
+http://github.com/macuk/pesel-plugin
+
+Installation
+============
+
+gem install pesel
+
+Example
+=======
+
+Standalone class:
+
+  require 'pesel'
+
+  pesel = Pesel.new('75120804355')
+  pesel.valid?      # true
+  pesel.birth_date  # Date object with '1975-12-08' date
+  pesel.female?     # false
+  pesel.male?       # true
+  pesel.gender      # :male
+  pesel.number      # '75120804355'
+
+  pesel = Pesel.new('00000000000')
+  pesel.valid?      # false
+  pesel.birth_date  # raises Pesel::NumberInvalid exception
+  pesel.female?     # raises Pesel::NumberInvalid exception
+  pesel.male?       # raises Pesel::NumberInvalid exception
+  pesel.gender      # raises Pesel::NumberInvalid exception
+  pesel.number      # raises Pesel::NumberInvalid exception
+
+ActiveRecord:
+
+  class Person < ActiveRecord::Base
+    validate :check_pesel
+
+    private
+      def check_pesel
+        p = Pesel.new(pesel)
+        errors[:pesel] << 'Invalid PESEL number' unless p.valid?
+      end
+  end
+
+
+Copyright (c) 2009-2010 Piotr Macuk, released under the MIT license

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/pesel.rb

@@ -0,0 +1,103 @@
+class Pesel
+  class NumberInvalid < Exception; end
+
+  attr_reader :number
+
+  def initialize(number)
+    @number = number.to_s
+    @digits = @number.split('')
+    @valid = validate
+  end
+
+  def to_s
+    number
+  end
+
+  def valid?
+    @valid
+  end
+
+  def birth_date
+    raise NumberInvalid unless valid?
+    @birth_date
+  end
+
+  def female?
+    raise NumberInvalid unless valid?
+    @digits[9].to_i % 2 == 0
+  end
+
+  def male?
+    raise NumberInvalid unless valid?
+    @digits[9].to_i % 2 != 0
+  end
+
+  def gender
+    raise NumberInvalid unless valid?
+    female? ? :female : :male
+  end
+
+  private
+    def validate
+      has_proper_length and \
+        contains_only_digits and \
+        has_proper_date and \
+        has_proper_control_digit
+    end
+
+    def has_proper_length
+      @number.size == 11
+    end
+
+    def contains_only_digits
+      @number =~ /^\d+$/
+    end
+
+    def has_proper_date
+      y, m, d = @number[0..1], @number[2..3], @number[4..5]
+      y, m = convert_year_and_month(y, m)
+      begin
+        require 'date'
+        @birth_date = Date::parse("#{y}-#{m}-#{d}")
+      rescue ArgumentError
+        @birth_date = nil
+      end
+      not @birth_date.nil? 
+    end
+
+    def weights
+      [1, 3, 7, 9, 1, 3, 7, 9, 1, 3, 1]
+    end
+
+    def has_proper_control_digit
+      index = 0
+      sum = 0
+      @digits.each do |digit|
+        sum += digit.to_i * weights[index]
+        index += 1
+      end
+      sum % 10 == 0
+    end
+
+    def mods
+      [
+        [1800..1899, 80], 
+        [2200..2299, 60], 
+        [2100..2199, 40], 
+        [2000..2099, 20], 
+        [1900..1999, 00],
+      ]
+    end
+
+    def convert_year_and_month(year, month)
+      y, m = year.to_i, month.to_i
+      mods.each do |range, mod|
+        if m > mod
+          y += range.begin
+          m -= mod
+          break
+        end
+      end
+      [y, m]
+    end
+end

data/lib/version.rb

@@ -0,0 +1,3 @@
+class Pesel
+  VERSION = "0.9.0"
+end

data/pesel.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "version"
+
+Gem::Specification.new do |s|
+  s.name        = "pesel"
+  s.version     = Pesel::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Piotr Macuk"]
+  s.email       = ["piotr@macuk.pl"]
+  s.homepage    = "http://github.com/macuk/pesel"
+  s.summary     = %q{PESEL validation and information}
+  s.description = %q{Pesel class to check PESEL number and get information about its owner}
+
+  s.rubyforge_project = "pesel"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/test/pesel_test.rb

@@ -0,0 +1,79 @@
+require 'test/unit'
+require 'pesel'
+
+class PeselTest < Test::Unit::TestCase
+  Valid   = %w(75120804355 74082610668 02221407563)
+  Invalid = %w(75120804350 95993823492 00000000000 123)
+
+  def test_number_and_to_s_methods
+    (Valid + Invalid).each do |number|
+      p = Pesel.new(number)
+      assert number, p.number
+      assert number, p.to_s
+    end
+  end
+
+  def test_valid_method
+    Valid.each do |number|
+      p = Pesel.new(number)
+      assert p.valid?
+    end
+
+    Invalid.each do |number|
+      p = Pesel.new(number)
+      assert_equal false, p.valid?
+    end
+  end
+
+  def test_birth_date_method
+    p = Pesel.new(Valid[0])
+    assert_equal Date.parse('1975-12-08'), p.birth_date
+    p = Pesel.new(Valid[1])
+    assert_equal Date.parse('1974-08-26'), p.birth_date
+    p = Pesel.new(Valid[2])
+    assert_equal Date.parse('2002-02-14'), p.birth_date
+  end
+
+  def test_female_and_male_methods
+    p = Pesel.new(Valid[0])
+    assert_equal false, p.female?
+    assert p.male?
+
+    p = Pesel.new(Valid[1])
+    assert p.female?
+    assert_equal false, p.male?
+
+    p = Pesel.new(Valid[2])
+    assert p.female?
+    assert_equal false, p.male?
+  end
+
+  def test_gender_method
+    p = Pesel.new(Valid[0])
+    assert_equal :male, p.gender
+
+    p = Pesel.new(Valid[1])
+    assert_equal :female, p.gender
+
+    p = Pesel.new(Valid[2])
+    assert_equal :female, p.gender
+  end
+
+  def test_methods_that_raise_exception
+    Invalid.each do |number|
+      p = Pesel.new(number)
+      assert_raise Pesel::NumberInvalid do
+        p.birth_date
+      end
+      assert_raise Pesel::NumberInvalid  do
+        p.female?
+      end
+      assert_raise Pesel::NumberInvalid  do
+        p.male?
+      end
+      assert_raise Pesel::NumberInvalid  do
+        p.gender
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: pesel
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 9
+  - 0
+  version: 0.9.0
+platform: ruby
+authors: 
+- Piotr Macuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-17 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: Pesel class to check PESEL number and get information about its owner
+email: 
+- piotr@macuk.pl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- lib/pesel.rb
+- lib/version.rb
+- pesel.gemspec
+- test/pesel_test.rb
+has_rdoc: true
+homepage: http://github.com/macuk/pesel
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: pesel
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: PESEL validation and information
+test_files: []
+