yob-san 1.0 → 1.3

data/CHANGELOG

@@ -1,3 +1,6 @@
+v1.2 (25th November 2008)
+- Add functions for conversion to a US and UK-based GLN
+
 v1.1 (11th September 2008)
 - Fix an embarassing typo
 

data/README.rdoc

@@ -6,14 +6,14 @@ a unique global identifier used in the book and publishing industries.
   SAN.new("9013725").valid?
   => true
 
-  SAN.valid_san?("9013725")
+  SAN.valid?("9013725")
   => true
 
-  SAN.valid_san?("9013726")
+  SAN.valid?("9013726")
   => false
 
-  SAN.check_digit?("901372")
-  => 5
+  SAN.complete("901372")
+  => "9013725"
 
 = Further Reader
 

data/lib/san.rb

@@ -1,8 +1,10 @@
+require 'ean13'
+
 class SAN
 
   class Version #:nodoc:
     Major = 1
-    Minor = 1
+    Minor = 3
     Tiny  = 0
     
     String = [Major, Minor, Tiny].join('.')
@@ -16,6 +18,28 @@ class SAN
     SAN.valid? @number
   end
 
+  # convert this SAN into a US based Global Location Number.
+  #
+  # see:
+  #  - http://en.wikipedia.org/wiki/Global_Location_Number
+  #  - http://www.bisg.org/conferences/UConnnect_2007.pdf
+  #
+  def to_us_gln
+    return nil unless valid?
+    EAN13.complete("079999#{@number[0,6]}")
+  end
+
+  # convert this SAN into a UK based Global Location Number.
+  #
+  # see:
+  #  - http://en.wikipedia.org/wiki/Global_Location_Number
+  #  - http://www.bisg.org/conferences/UConnnect_2007.pdf
+  #
+  def to_uk_gln
+    return nil unless valid?
+    EAN13.complete("503067#{@number[0,6]}")
+  end
+
   def self.valid?(san)
     san = san.to_s
     san.length == 7 && san == SAN.complete(san[0,6])

data/spec/san_spec.rb

@@ -13,7 +13,7 @@ describe "The SAN class" do
     SAN.valid?(9013725).should   be_true
     SAN.valid?("902865X").should be_true
   end
-  
+
   it "should identify an invalid SAN" do
     SAN.valid?(nil).should       be_false
     SAN.valid?("902865").should  be_false
@@ -25,4 +25,21 @@ describe "The SAN class" do
     SAN.complete("901372").should eql("9013725")
     SAN.complete(901372).should  eql("9013725")
   end
+
+  it "should correctly convert to a US based GLN" do
+    # valid
+    SAN.new("9013725").to_us_gln.should eql("0799999013725")
+    SAN.new("9029761").to_us_gln.should eql("0799999029764")
+
+    # invalid
+    SAN.new("9013724").to_us_gln.should be_nil
+  end
+
+  it "should correctly convert to a UK based GLN" do
+    # valid
+    SAN.new("0159263").to_uk_gln.should eql("5030670159260")
+
+    # invalid
+    SAN.new("9013724").to_uk_gln.should be_nil
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: yob-san
 version: !ruby/object:Gem::Version 
-  version: "1.0"
+  version: "1.3"
 platform: ruby
 authors: 
 - James Healy
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-08-13 00:00:00 -07:00
+date: 2009-05-16 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -28,6 +28,7 @@ files:
 - CHANGELOG
 has_rdoc: true
 homepage: http://github.com/yob/san/tree/master
+licenses: 
 post_install_message: 
 rdoc_options: 
 - --title
@@ -50,7 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 2
 summary: a (very) small library for working with Standard Address Numbers.