san 1.1.0 → 1.2.0

data/CHANGELOG

@@ -0,0 +1,8 @@
+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
+
+v1.0 (August 2008)
+- Initial Release

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 = 2
     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?
+    "079999#{@number}"
+  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,20 @@ 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")
+
+    # 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: san
 version: !ruby/object:Gem::Version 
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors: 
 - James Healy
@@ -9,10 +9,19 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-09-11 00:00:00 +10:00
+date: 2008-11-25 00:00:00 +11:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ean13
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
 description: a (very) small library for working with Standard Address Numbers.
 email: jimmy@deefa.com
 executables: []
@@ -25,6 +34,7 @@ files:
 - lib/san.rb
 - MIT-LICENSE
 - README.rdoc
+- CHANGELOG
 has_rdoc: true
 homepage: http://github.com/yob/san/tree/master
 post_install_message: 
@@ -49,7 +59,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: san
-rubygems_version: 1.2.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: a (very) small library for working with Standard Address Numbers.