personnummer 0.0.2

data/Changelog

@@ -0,0 +1,5 @@
+0.0.2 Released
+
+2008-08-07: Number argument can now be a Fixnum or String
+
+0.0.1 Released

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Peter Hellberg
+ 
+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.markdown

@@ -0,0 +1,14 @@
+# Personnummer
+
+Personnummer is a ruby class that handles [Swedish personal identity number](http://en.wikipedia.org/wiki/Personal_identity_number_(Sweden\)).
+
+### Getting started
+
+Install from GitHub: <pre>$ gem install c7-personnummer -s http://gems.github.com</pre>
+
+### Example usage
+<pre>&gt;&gt; p = Personnummer.new('830428-5912')
+=&gt; #&lt;Personnummer:0x301128 @number="830428-5912", @age=25, @valid=true, @region="Skaraborgs l\303\244n",
+@male=true, @born=#&lt;Date: 4890905/2,0,2299161&gt;&gt;
+&gt;&gt; p.valid?
+=&gt; true</pre>

data/demo.rb

@@ -0,0 +1,21 @@
+# Real world scripts would use:
+# require 'rubygems'
+# require 'personnummer'
+#
+# Instead of:
+require 'lib/personnummer'
+
+# Valid personnummer
+p = Personnummer.new(8304285912)
+designation = (p.male?) ? 'His' : 'Her'
+puts "#{designation} control digit is: #{p.control_digit}"
+
+if p.valid?
+  designation = (p.male?) ? 'He' : 'She'
+  puts "#{designation} was born in #{p.region} aproximately #{p.age} years ago" if p.region
+end
+
+# Incomplete personnummer
+p = Personnummer.new('870312-594')
+designation = (p.male?) ? 'His' : 'Her'
+puts "#{designation} control digit is: #{p.control_digit}"

data/lib/personnummer.rb

@@ -0,0 +1,145 @@
+require 'date'
+
+class Personnummer
+  # Public readonly attributes
+  attr_reader :age, :born, :region, :control_digit
+  
+	def initialize(number)
+	  
+	  @valid = false
+	  
+	  # Store the initial number
+    @number = number.to_s
+	  
+	  # Match the number
+	  if @number.match(/(\d{2})(\d{2})(\d{2})([\-\+]{0,1})(\d{3})(\d{0,1})/)
+	    
+	    # Calculate the control digit based on the birth date and serial number
+	    @control_digit = luhn_algorithm("#{$~[1]}#{$~[2]}#{$~[3]}#{$~[5]}")
+	    
+	    # Get the different parts of the number
+	    year     = $~[1].to_i
+	    month    = $~[2].to_i
+	    day      = $~[3].to_i
+	    divider  = $~[4]
+	    serial   = $~[5].to_i
+	    
+	    # Set default divider if not present
+	    divider ||= '-'
+	    
+	    # Make the personnummer valid if the checksum is correct
+	    @valid = true if @control_digit == $~[6].to_i && !$~[6].empty?
+	    
+	    # Get the current date	    
+	    today = Date.today
+	    
+	    # Decide which century corresponds to the number
+	    if year < (today.year-2000) && divider == '-'
+	      century = 2000
+	    elsif year < (today.year-2000) && divider == '+'
+        century = 1900
+      elsif divider == '+'
+        century = 1800
+      else
+        century = 1900
+      end
+	    
+	    # Get the date the person was born
+  	  @born   = Date.parse("#{century+year}-#{month}-#{day}")
+  	  
+  	  # Get the region name
+  	  @region = region_name(serial)
+  	  
+  	  # Naïve age calculation
+  	  @age = today.year - @born.year
+  	  
+  	  # Check if the person is female based the serial (even == female)
+  	  @female = (serial % 2 == 0)
+    else
+      raise Exception.new, "The supplied personnummer is invalid" 
+    end
+	end
+	
+	def to_s
+    @number
+  end
+	
+	def valid?
+	  @valid
+  end
+	
+	def male?
+	  !@female
+  end
+  
+  def female?
+    @female
+  end
+
+private 
+
+  def luhn_algorithm(number)
+    multiplications = []
+    
+    number.split(//).each_with_index do |digit, i|
+      if i % 2 == 0
+          multiplications << digit.to_i*2
+        else
+          multiplications << digit.to_i
+        end
+    end
+    
+    sum = 0
+    multiplications.each do |number|
+      number.to_s.each_byte do |character|
+        sum += character.chr.to_i
+      end
+    end
+
+    if sum % 10 == 0
+      control_digit = 0
+    else
+      control_digit = (sum / 10 + 1) * 10 - sum
+    end
+    
+    control_digit
+  end
+
+  def region_name(code)
+    
+    # Don't return a region name if the person was born after 1990 
+	  # (When the previous region code was changed to a serial number)
+    if @born.year > 1990
+      return ''
+    end
+    
+    case code
+      when 000..139: 'Stockholms Län'
+      when 140..159: 'Uppsala län'
+      when 160..189: 'Södermanlands län'
+      when 190..239: 'Östergötlands län'
+      when 240..269: 'Jönköpings län'
+      when 270..289: 'Kronobergs län'
+      when 290..319: 'Kalmar län'
+      when 320..329: 'Gotlands län'
+      when 330..349: 'Blekinge län'
+      when 350..389: 'Kristianstads län'
+      when 390..459: 'Malmöhus län'
+      when 460..479: 'Hallands län'
+      when 480..549: 'Göteborgs och Bohus län'
+      when 550..589: 'Älvsborgs län'
+      when 590..619: 'Skaraborgs län'
+      when 620..159: 'Värmlands län'
+      when 650..659: 'Födda utomlands'
+      when 660..689: 'Örebro län'
+      when 690..709: 'Västmanlands län'
+      when 710..739: 'Kopparbergs län'
+      when 750..779: 'Gävleborgs län'
+      when 780..819: 'Västernorrlands län'
+      when 820..849: 'Jämtlands län'
+      when 850..889: 'Västerbottens län'
+      when 890..929: 'Norrbottens län'
+      when 930..999: 'Födda utomlands eller utländska medborgare födda i Sverige'
+    end
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+name: personnummer
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Peter Hellberg
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-06 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Personnummer handles validation of Swedish personal identity numbers.
+email: peter@c7.se
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.markdown
+- Changelog
+- LICENSE
+- demo.rb
+- lib/personnummer.rb
+has_rdoc: true
+homepage: http://c7.se/code/personnummer
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Personnummer handles validation of Swedish personal identity numbers.
+test_files: []
+