Activepesel
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)
Activepesel library is available as a gem. In your Gemfile add:
gem 'activepesel'
In your model:
class User < ActiveRecord::Base
attr_accessible :dads_pesel, :mums_pesel
# this will give the access to methods:
# dads_pesel_personal_data, mums_pesel_personal_data
pesel_attr :dads_pesel, :mums_pesel
# keep in mind that pesel validator is not performing a presence test
# so you need another (standard) validation for this one
validates :dads_pesel, :presence => true
validates :dads_pesel, :pesel => true
validates :mums_pesel, :pesel => true
# pesel validator returns standard rails :invalid key error message
end
Activepesel::PersonalData object
When using attr_pesel :name_of_attr
in your model you will get new instance method available: name_of_attr_personal_data
.
The method returns Activepesel::PersonalData
object which has the following attributes:
date_of_birth:Date
sex:Integer
Sex attribute can take 3 values. 1 - for men, 2 - for women, 9 - not applicable (ISO/IEC 5218)
For the invalid PESEL numbers the date_of_birth
attribute is set to nil
and the sex
is 9 - not applicable.
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:
class User < ActiveRecord::Base
attr_accessible :pesel
pesel_attr :pesel
validates :pesel, :pesel => true
before_save :set_personal_data
private
def set_personal_data
self.date_of_birth = pesel_personal_data.date_of_birth
self.sex = pesel_personal_data.sex
end
end
Using Activepesel outside ActiveModel / ActiveRecord models
You can use it like in the given example
pesel = Activepesel::Pesel.new("82060202039")
pesel.valid? => true
pesel.personal_data => Activepesel::PersonalData(...)
# or even quicker
pesel.date_of_birth => Wed, 02 Jun 1982
pesel.sex => 1