activepesel 0.0.2 → 0.1.1

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    activepesel (0.0.1)
-      rails (~> 3.2.9)
+    activepesel (0.1.0)
+      rails (>= 3.0.0)
 
 GEM
   remote: http://rubygems.org/

data/README.md

@@ -2,6 +2,8 @@
 
 A simple PESEL (polish personal ID number) validator and personal data extractor for Rails 3. Compatible with Ruby 1.9 (Tested with 1.9.3)
 
+![](http://dl.dropbox.com/s/27p6gra4p0c8q0m/pesel.jpg)
+
 Activepesel library is available as a gem. In your Gemfile add:
 
 ```ruby
@@ -39,6 +41,12 @@ The method returns ```Activepesel::PersonalData``` object which has the followin
 date_of_birth:Date
 sex:Integer
 ```
+See the example:
+
+```ruby
+User.find(1).dads_pesel_personal_data => Activepesel::PersonalData(...)
+```
+
 
 Sex attribute can take 3 values. 1 - for men, 2 - for women, 9 - not applicable ([ISO/IEC 5218](http://en.wikipedia.org/wiki/ISO/IEC_5218))
 
@@ -46,7 +54,7 @@ For the invalid PESEL numbers the ```date_of_birth``` attribute is set to ```nil
 
 # Saving personal data into database
 
-It is a common practise that you want to save the personal data extracted from the PESEL number to be able for example to query your records against all female persons. To do this you can use ActiveModel callbacks like in the example:
+It is a common practice that you want to save the personal data extracted from the PESEL number to be able for example to query your records against all female persons. To do this you can use ActiveModel callbacks like in the example:
 
 ```ruby
 class User < ActiveRecord::Base
@@ -81,6 +89,25 @@ pesel.personal_data => Activepesel::PersonalData(...)
 pesel.date_of_birth => Wed, 02 Jun 1982
 pesel.sex => 1
 ```  
+# Generating PESEL numbers
+
+Since version 0.1.0 you can generate valid PESEL numbers for a given date of birth and sex of a person.
+
+To generate one randomly picked PESEL number for let's say a male born on November 3rd 1975:
+
+```ruby
+# picks one random number for the given personal data
+Pesel.generate(:one, :sex => 1, :date_of_birth => Date.new(1975,11,3))
+````
+
+To generate all (5000) PESEL numbers valid for a person of a given sex and date of birth for example a female born on May 20th 2010:
+
+```ruby
+# returns all possible numbers for the given personal data in a lexicographic order
+Pesel.generate(:all, :sex => 2, :date_of_birth => "2010-05-20") # notice that you can pass a stringified date.
+```
+
+
 
 
 

data/activepesel.gemspec

@@ -18,6 +18,6 @@ Gem::Specification.new do |s|
   s.test_files    = Dir["test/**/*"]
   s.require_paths = ["lib"]
 
-  s.add_dependency "rails", "~> 3.2.9"
+  s.add_dependency "rails", ">= 3.0.0"
   s.add_development_dependency "sqlite3"
 end

data/lib/activepesel.rb

@@ -1,6 +1,7 @@
 require 'activepesel/pesel'
 require 'activepesel/pesel_attr'
 require 'activepesel/personal_data'
+require 'activepesel/pesel_generator'
 require 'active_model/validations/pesel_validator'
 
 module Activepesel

data/lib/activepesel/pesel.rb

@@ -1,12 +1,16 @@
 module Activepesel
   class Pesel
-
+    
+    class << self
+      delegate :generate, :to => "Activepesel::PeselGenerator".to_sym
+    end
+    
     DIGIT_WEIGHTS = [1, 3, 7, 9, 1, 3 ,7, 9, 1, 3, 1].freeze
-
+    
     attr_reader :number
-
-    delegate :date_of_birth, :sex,  :to => :personal_data
     
+    delegate :date_of_birth, :sex,  :to => :personal_data
+
     def initialize(number)
       @number = number 
     end
@@ -20,7 +24,7 @@ module Activepesel
     end
     
     def personal_data
-      PersonalData.new(self)
+      PersonalData.new(self) if @number
     end
 
     private

data/lib/activepesel/pesel_generator.rb

@@ -0,0 +1,72 @@
+module Activepesel
+  class PeselGenerator
+    
+    SEX_CODES = {
+      1 => [1, 3, 5, 7, 9],
+      2 => [0, 2, 4, 6, 8]
+    }.freeze
+    
+    class << self
+      
+      def generate(*args)
+        raise(::ArgumentError, "Bad argument! You can pass :all or :one") unless [:all, :one].include?(args[0])
+        options = args.extract_options!
+        raise(::ArgumentError, "Date of birth can only be from range: (1800-01-01..2299-12-31)") if !options[:date_of_birth].respond_to?(:to_date) || !(Date.new(1800,1,1)..Date.new(2299,12,31)).include?(options[:date_of_birth].to_date)
+        raise(::ArgumentError, "Sex can only be set to 1 - males and 2 - females") if !options[:sex].respond_to?(:to_i) || ![1,2].include?(options[:sex].to_i)
+        send(args.first, options)
+      end
+      
+      private
+
+      def one(options)
+        incomplete_pesel = "#{date_of_birth_code(options[:date_of_birth])}#{varying_codes[rand(998)]}#{sex_codes(options[:sex])[rand(4)]}"
+        Pesel.new("#{incomplete_pesel}#{control_digit(incomplete_pesel)}")
+      end
+
+      def all(options)
+        [].tap do |pesels|
+          varying_codes.each do |varying_code|
+            sex_codes(options[:sex]).each do |sex_code|
+              incomplete_pesel = "#{date_of_birth_code(options[:date_of_birth])}#{varying_code}#{sex_code}"
+              pesels << Pesel.new("#{incomplete_pesel}#{control_digit(incomplete_pesel)}")
+            end
+          end
+        end
+      end
+
+      def control_digit(incomplete_pesel)
+        digits = incomplete_pesel.split("").map(&:to_i)
+        (10 - Pesel::DIGIT_WEIGHTS[0..-2].each_with_index.inject(0){|sum, (factor, idx)| sum + factor * digits[idx]})%10
+      end
+      
+      def sex_codes(sex)
+        SEX_CODES[sex.to_i]
+      end
+      
+      def varying_codes
+        (0..999).to_a.map{|code| sprintf("%03d", code)}
+      end
+      
+      def date_of_birth_code(date_of_birth)
+        [year_code(date_of_birth.to_date.year), month_code(date_of_birth.to_date.year, date_of_birth.to_date.month), day_code(date_of_birth.to_date.day)].join
+      end
+      
+      def century(year)
+        year / 100
+      end
+
+      def year_code(year)
+        sprintf("%02d", year - 100 * century(year))
+      end
+
+      def month_code(year, month)
+        sprintf("%02d", month + PersonalData::DELTA[century(year)])
+      end
+
+      def day_code(day)
+        sprintf("%02d", day)
+      end
+
+    end
+  end
+end

data/lib/activepesel/version.rb

@@ -1,3 +1,3 @@
 module Activepesel
-  VERSION = "0.0.2"
+  VERSION = "0.1.1"
 end

data/test/pesel_attr_test.rb

@@ -54,4 +54,9 @@ class PeselAttrTest < ActiveSupport::TestCase
     assert_equal 2, users("22xx").mums_pesel_personal_data.sex 
   end
 
+  test "Personal data should be nil for nil Pesel attributes" do
+    user = User.create(:mums_pesel => nil)
+    assert_equal nil, user.mums_pesel_personal_data
+  end
+
 end

data/test/pesel_generator_test.rb

@@ -0,0 +1,46 @@
+require 'test_helper'
+
+class PeselGeneratorTest < ActiveSupport::TestCase
+
+  test "PeselGenerator.generate with wrong args should raise a ArgumentError" do
+    assert_raise ArgumentError, "Bad argument! You can pass :all or :one" do
+      Activepesel::PeselGenerator.generate :foo, :sex =>1, :date_of_birth => Date.new(1982,6,2)
+    end
+  end
+
+  test "PeselGenerator.generate with wrong date should raise a ArgumentError" do
+    assert_raise ArgumentError, "Date of birth can only be from range: (1800-01-01..2299-12-31)" do
+      Activepesel::PeselGenerator.generate :foo, :sex =>333, :date_of_birth => Date.new(1982,6,2)
+    end
+  end
+
+  test "PeselGenerator.generate with wrong sex should raise a ArgumentError" do
+    assert_raise ArgumentError, "Sex can only be set to 1 - males and 2 - females" do
+      Activepesel::PeselGenerator.generate :foo, :sex =>333, :date_of_birth => Date.new(1982,6,2)
+    end
+  end
+  
+  test "PeselGenerator should generate valid pesel for 18XX's" do
+    assert_equal true, Activepesel::PeselGenerator.generate(:one, :sex =>1, :date_of_birth => Date.new(1807,2,15)).valid?
+  end
+
+  test "PeselGenerator should generate valid pesel for 19XX's" do
+    assert_equal true, Activepesel::PeselGenerator.generate(:one, :sex =>1, :date_of_birth => Date.new(1907,2,15)).valid?
+  end
+
+  test "PeselGenerator should generate valid pesel for 20XX's" do
+    assert_equal true, Activepesel::PeselGenerator.generate(:one, :sex =>1, :date_of_birth => Date.new(2007,2,15)).valid?
+  end
+
+  test "PeselGenerator should generate valid pesel for 21XX's" do
+    assert_equal true, Activepesel::PeselGenerator.generate(:one, :sex =>1, :date_of_birth => Date.new(2107,2,15)).valid?
+  end
+
+  test "PeselGenerator should generate valid pesel for 22XX's" do
+    assert_equal true, Activepesel::PeselGenerator.generate(:one, :sex =>1, :date_of_birth => Date.new(2207,2,15)).valid?
+  end
+  
+
+
+  
+end

data/test/pesel_test.rb

@@ -30,5 +30,37 @@ class PeselTest < ActiveSupport::TestCase
     assert_equal 9, Activepesel::Pesel.new("123123").personal_data.sex
   end
 
+  test "Pesel.generate :all should return 5000 valid male pesel numbers" do
+    pesels = Activepesel::Pesel.generate(:all, :sex => 1, :date_of_birth => Date.new(1982,6,2))
+    assert_equal 5000, pesels.size
+    assert_equal true, !pesels.map(&:valid?).include?(false)
+    assert_equal nil,  pesels.map(&:sex).detect{|t| t!=1} 
+    assert_equal nil,  pesels.map(&:date_of_birth).detect{|t| t!=Date.new(1982,6,2)}
+  end
+
+  test "Pesel.generate :all should return 5000 valid female pesel numbers" do
+    pesels = Activepesel::Pesel.generate(:all, :sex => 2, :date_of_birth => Date.new(1982,6,2))
+    assert_equal 5000, pesels.size
+    assert_equal true, !pesels.map(&:valid?).include?(false) 
+    assert_equal nil,  pesels.map(&:sex).detect{|t| t!=2}
+    assert_equal nil,  pesels.map(&:date_of_birth).detect{|t| t!=Date.new(1982,6,2)}
+  end
+
+  test "Pesel.generate :one should return one male randomly picked from the pesel pool pesel number" do
+    pesel = Activepesel::Pesel.generate(:one, :sex => 1, :date_of_birth => Date.new(1982,6,2))
+    assert_equal true, pesel.valid?
+    assert_equal 1, pesel.sex
+    assert_equal Date.new(1982,6,2), pesel.date_of_birth
+  end
+
+  test "Pesel.generate :one should return one female randomly picked from the pesel pool pesel number" do
+    pesel = Activepesel::Pesel.generate(:one, :sex => 2, :date_of_birth => Date.new(1982,6,2))
+    assert_equal true, pesel.valid?
+    assert_equal 2, pesel.sex
+    assert_equal Date.new(1982,6,2), pesel.date_of_birth
+  end
+
+
+
   
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activepesel
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-15 00:00:00.000000000 Z
+date: 2012-12-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.2.9
+        version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.2.9
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -64,6 +64,7 @@ files:
 - lib/activepesel/personal_data.rb
 - lib/activepesel/pesel.rb
 - lib/activepesel/pesel_attr.rb
+- lib/activepesel/pesel_generator.rb
 - lib/activepesel/version.rb
 - lib/tasks/activepesel_tasks.rake
 - test/activepesel_test.rb
@@ -105,6 +106,7 @@ files:
 - test/dummy/test/fixtures/users.yml
 - test/dummy/test/unit/user_test.rb
 - test/pesel_attr_test.rb
+- test/pesel_generator_test.rb
 - test/pesel_test.rb
 - test/pesel_validator_test.rb
 - test/test_helper.rb
@@ -179,6 +181,7 @@ test_files:
 - test/dummy/test/fixtures/users.yml
 - test/dummy/test/unit/user_test.rb
 - test/pesel_attr_test.rb
+- test/pesel_generator_test.rb
 - test/pesel_test.rb
 - test/pesel_validator_test.rb
 - test/test_helper.rb