library_stdnums 1.1.0 → 1.2.0

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+bundler_args: --without documentation
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby-19mode
+  - rbx-19mode
+  - jruby-18mode
+  - rbx-18mode

data/.yardopts

@@ -0,0 +1,11 @@
+--protected
+--no-private
+--embed-mixin ClassMethods
+--markup=markdown
+--markup-provider kramdown
+--charset utf-8
+--readme README.md
+-
+README.md
+ChangeLog.md
+LICENSE.txt

data/ChangeLog.md

@@ -0,0 +1,26 @@
+* 1.2.0 (2012.07.24)
+  * Added a bunch of tests for LCCN normalization from perl module Business::LCCN
+    (http://search.cpan.org/~anirvan/Business-LCCN/)
+  * Fix ISBN.normalize to fail if an invalid 10-digit ISBN in passed in
+  * Added ablility to normalize/validate LCCN URIs (e.g., http://lccn.loc.gov/abc89001234)
+  * Test give 100% code coverage! Yea!
+* 1.1.0 (2012.02.06)
+  * Changed the ISBN/ISSN regex to make sure string of digits/dashes is at least 6 chars long
+  * Cleaned up LCCN validation code
+* 1.0.2
+  * Made docs clearer.
+* 1.0.0
+  * Added normalization all around.
+  * Added valid? for LCCN.
+  * Cleaner code all around, and better docs.
+* 0.3.0
+  * Wow. ISBN-13 checkdigit wasn't changing '10' to '0'. Blatant error; bad coding *and* testing.
+* 0.2.2
+  * Added ISSN.valid?
+  * Fixed error in ISSN.checksum when checksum was zero (was returning integer instead of string '0')
+* 0.2.1
+  * Oops. Forgot to check to make sure there are *any* digits in the ISBN. fixed.
+* 0.2.0
+  * Added allNormalizedValues for ISBN
+* 0.1.0
+  * Initial release

data/Gemfile

@@ -0,0 +1,14 @@
+source :rubygems
+
+gemspec
+
+group :development do
+  gem 'bundler',  '~> 1.0'
+  gem 'rake',  '~> 0.8'
+  gem 'minitest'
+end
+
+group :documentation do
+  gem 'kramdown'
+  gem 'yard',  '~> 0.7'
+end

data/{LICENSE → LICENSE.txt}

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2011 Bill Dueber
+Copyright (c) 2012 Bill Dueber
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/{README.markdown → README.md}

@@ -1,91 +1,90 @@
 # library_stdnums -- simple functions to check and normalize ISSN/ISBN/LCCN
 
+[![Build Status](https://secure.travis-ci.org/billdueber/library_stdnums.png)](http://travis-ci.org/billdueber/library_stdnums)
+
 These are a set of Module functions (not classes with methods!) that perform simple checksum verification and (when applicable) normalization on strings containing common library types (currently just ISBN, ISSN, and LCCN).
 
 The code allows for some minimal crap to be in the passed string (e.g., '1234-4568 online' will work fine). All returned ISBN/ISSN values are devoid any dashes; any trailing X for an ISBN/ISSN checkdigit will be uppercase.
 
-When you're getting back just the checkdigit, it will *always be returned as a one-digit string or an uppercase X* ('1'..'9' or 'X'). 
+When you're getting back just the checkdigit, it will *always be returned as a one-digit string or an uppercase X* ('1'..'9' or 'X').
 
 
 ## ISBN
 
-````ruby
+We can deal with 10 or 13-digit ISBNs and convert between the two (when applicable).
+"Normalization" means converting to 13-digit string and then validating.
+
+~~~~~
 
       isbn = StdNum::ISBN.normalize(goodISBN)
         # => a 13-digit ISBN with no dashes/spaces
-    
+
       isbn = StdNum::ISBN.normalize(badISBN)
         # => nil (if it's not an ISBN or the checkdigit is bad)
-  
+
       tenDigit = StdNum::ISBN.convert_to_10(isbn13)
       thirteenDigit = StdNum::ISBN.convert_to_13(isbn10)
-  
+
       thirteenDigit,tenDigit = StdNum::ISBN.allNormalizedValues(issn)
-        # => array of the ten and thirteen digit isbns if valid; 
+        # => array of the ten and thirteen digit isbns if valid;
         #    an empty array if not
-  
-      digit = StdNum::ISBN.checkdigit(isbn)
+
+      digit = StdNum::ISBN.checkdigit(rawisbn)
         # => '0'..'9' (for isbn13) or '0'..'9','X' (for isbn10)
-  
-      if StdNum::ISBN.valid?(isbn)
+
+      digit = StdNum::ISBN.checkdigit(StdNum::ISBN.normalize(rawisbn))
+        # => '0'..'9', the checkdigit of the 13-digit ISBN
+
+      if StdNum::ISBN.valid?(rawisbn)
         puts "#{isbn} has a valid checkdigit"
       end
-  
-````
+
+~~~~~
 
 # ISSN
 
-````ruby
-      issn = StdNum::ISSN.normalize(issn)
+For an ISSN, normalization simply cleans up any extraneous characters,
+uppercases the final 'X' if need be, validates, and returns.
+
+~~~~~
+
+      issn = StdNum::ISSN.normalize(rawissn)
       #  => the cleaned-up issn if valid; nil if not
-  
-      digit = StdNum::ISSN.checkdigit(issn)
+
+      digit = StdNum::ISSN.checkdigit(rawissn)
       #  => '0'..'9' or 'X'
 
-      if StdNum::ISSN.valid?(issn)
+      if StdNum::ISSN.valid?(rawissn)
         puts "#{issn} has a valid checkdigit"
       end
-````
-  
+~~~~~
+
 # LCCN
 
-LCCNs are normalized according to the algorithm at http://www.loc.gov/marc/lccn-namespace.html#syntax
-
-````ruby
-
-      lccn = StdNum::LCCN.normalize(rawlccn)
-      #  => either the normalized lccn, or nil if it has bad syntax
-
-      if StdNum::LCCN.valid?(rawlccn) {
-        puts "#{rawlccn} is valid"
-      }
-
-````
-
-## CHANGES
-* 1.1.0 (2012.02.06)
-  * Changed the ISBN/ISSN regex to make sure string of digits/dashes is at least 6 chars long
-  * Cleaned up LCCN validation code
-* 1.0.2
-  * Made docs clearer.
-* 1.0.0
-  * Added normalization all around. 
-  * Added valid? for LCCN. 
-  * Cleaner code all around, and better docs.
-* 0.3.0
-  * Wow. ISBN-13 checkdigit wasn't changing '10' to '0'. Blatant error; bad coding *and* testing.
-* 0.2.2
-  * Added ISSN.valid?
-  * Fixed error in ISSN.checksum when checksum was zero (was returning integer instead of string '0')
-* 0.2.1
-  * Oops. Forgot to check to make sure there are *any* digits in the ISBN. fixed.
-* 0.2.0
-  * Added allNormalizedValues for ISBN
-* 0.1.0 
-  * Initial release
+LCCNs are normalized according to the algorithm at
+http://www.loc.gov/marc/lccn-namespace.html#syntax . Normalization involves
+that full process; validation includes checks on the syntax only since
+there's no checkdigit.
+
+rawlccn may be a standalone LCCN as found in a record, or a URI of the form
+'http://lccn.loc.gov/89001234 .
+
+~~~~~
+
+
+    lccn = StdNum::LCCN.normalize(rawlccn)
+    #  => either the normalized lccn, or nil if it has bad syntax
+
+    if StdNum::LCCN.valid?(rawlccn) {
+      puts "#{rawlccn} is valid"
+    }
+
+
+~~~~~
+
 
 ## Note on Patches/Pull Requests
- 
+
 * Fork the project.
 * Make your feature addition or bug fix.
 * Add tests for it. This is important so I don't break it in a

data/Rakefile

@@ -1,53 +1,37 @@
+# encoding: utf-8
+
 require 'rubygems'
-require 'rake'
 
 begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "library_stdnums"
-    gem.summary = %Q{Normalize and compute checkdigits for ISBN, ISSN, and LCCN}
-    gem.description = %Q{Normalization and checksum computation for ISBN (10 and 13), ISSN, and LCCN}
-    gem.email = "bill@dueber.com"
-    gem.homepage = "http://github.com/billdueber/library_stdnums"
-    gem.authors = ["Bill Dueber"]
-    gem.add_development_dependency "minitest", ">= 0" if RUBY_VERSION < "1.9"
-    gem.add_development_dependency "yard", ">= 0"
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
-end
-
-require 'rake/testtask'
-Rake::TestTask.new(:spec) do |spec|
-  spec.libs << 'lib' << 'spec'
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.verbose = true
+  require 'bundler'
+rescue LoadError => e
+  warn e.message
+  warn "Run `gem install bundler` to install Bundler."
+  exit e.status_code
 end
 
 begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |spec|
-    spec.libs << 'spec'
-    spec.pattern = 'spec/**/*_spec.rb'
-    spec.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
+  Bundler.setup(:development)
+rescue Bundler::BundlerError => e
+  warn e.message
+  warn "Run `bundle install` to install missing gems."
+  exit e.status_code
 end
 
-task :spec => :check_dependencies
+require 'rake'
 
-task :default => :spec
+require "bundler/gem_tasks"
 
-begin
-  require 'yard'
-  YARD::Rake::YardocTask.new
-rescue LoadError
-  task :yardoc do
-    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
-  end
+require 'yard'
+YARD::Rake::YardocTask.new
+task :doc => :yard
+
+require 'rake/testtask'
+Rake::TestTask.new do |test|
+  test.libs << 'spec'
+  test.pattern = 'spec/**/*_spec.rb'
+  test.verbose = true
 end
+
+task :default => :test
+task :spec => :test

data/gemspec.yml

@@ -0,0 +1,11 @@
+name: library_stdnums
+summary: "Normalize and validate ISBN / ISSN/ LCCN"
+description: "A simple set of module functions to normalize, validate, and convert common library standard numbers"
+license: MIT
+authors: Bill Dueber
+email: bill@dueber.com
+homepage: https://github.com/billdueber/library_stdnums
+
+development_dependencies:
+  bundler: ~> 1.0
+  yard: ~> 0.7

data/lib/library_stdnums.rb

@@ -9,7 +9,7 @@ module StdNum
     # Since the shortest possible string is 7 digits followed by a checksum digit
     # for an ISSN, we'll make sure they're at least that long. Still imperfect
     # (would fine "5------", for example) but should work in most cases.
-    STDNUMPAT = /^.*?(\d[\d\-]{6,}+[xX]?)/
+    STDNUMPAT = /^.*?(\d[\d\-]{6,}[xX]?)/
 
     # Extract the most likely looking number from the string. This will be the first
     # string of digits-and-hyphens-and-maybe-a-trailing-X, with the hypens removed
@@ -18,13 +18,13 @@ module StdNum
     def extractNumber str
       match = STDNUMPAT.match str
       return nil unless match
-      return match[1].gsub(/\-/, '').upcase
+      return (match[1].gsub(/\-/, '')).upcase
     end
 
     # Given any string, extract what looks like the most likely ISBN/ISSN
     # of the given size(s), or nil if nothing matches at the correct size.
     # @param [String] rawnum The raw string containing (hopefully) an ISSN/ISBN
-    # @param [Integer, Array<Integer>, nil] An integer or array of integers of valid sizes
+    # @param [Integer, Array<Integer>, nil] valid_sizes An integer or array of integers of valid sizes
     # for this type (e.g., 10 or 13 for ISBN, 8 for ISSN)
     # @return [String,nil] the reduced and verified number, or nil if there's no match at the right size
     def reduce_to_basics rawnum, valid_sizes = nil
@@ -96,13 +96,14 @@ module StdNum
     end
 
 
-    # For an ISBN normalizing it is the same as converting to ISBN 13
+    # For an ISBN, normalizing it is the same as converting to ISBN 13
     # and making sure it's valid
-    # @param [String] isbn The ISBN to normalize
+    #
+    # @param [String] rawisbn The ISBN to normalize
     # @return [String, nil] the normalized (to 13 digit) ISBN, or nil on failure
     def self.normalize rawisbn
       isbn = convert_to_13 rawisbn
-      if isbn and valid?(isbn, true)
+      if isbn
         return isbn
       else
         return nil
@@ -118,6 +119,7 @@ module StdNum
     def self.convert_to_13 isbn
       isbn = reduce_to_basics isbn, [10,13]
       return nil unless isbn
+      return nil unless valid?(isbn, true)
       return isbn if isbn.size == 13
       prefix = '978' + isbn[0..8]
       return prefix + self.checkdigit(prefix + '0', true)
@@ -191,7 +193,7 @@ module StdNum
     end
 
     # Check to see if the checkdigit is correct
-    # @param [String] isbn The ISSN (we'll try to clean it up if possible)
+    # @param [String] issn The ISSN (we'll try to clean it up if possible)
     # @param [Boolean] preprocessed Set to true if the number has already been through reduce_to_basic
     # @return [Boolean] Whether or not the checkdigit is correct
 
@@ -204,8 +206,8 @@ module StdNum
 
 
     # Make sure it's valid, remove the dashes, uppercase the X, and return
-    # @param [String] isbn The ISBN to normalize
-    # @return [String, nil] the normalized (to 13 digit) ISBN, or nil on failure
+    # @param [String] rawissn The ISSN to normalize
+    # @return [String, nil] the normalized ISSN, or nil on failure
     def self.normalize rawissn
       issn = reduce_to_basics rawissn, 8
       if issn and valid?(issn, true)
@@ -229,12 +231,13 @@ module StdNum
 
     def self.reduce_to_basic str
       rv = str.gsub(/\s/, '')  # ditch spaces
+      rv.gsub!('http://lccn.loc.gov/', '') # remove URI prefix
       rv.gsub!(/\/.*$/, '') # ditch everything after the first '/' (including the slash)
       return rv
     end
 
     # Normalize based on data at http://www.loc.gov/marc/lccn-namespace.html#syntax
-    # @param [String] str The possible LCCN to normalize
+    # @param [String] rawlccn The possible LCCN to normalize
     # @return [String, nil] the normalized LCCN, or nil if it looks malformed
     def self.normalize rawlccn
       lccn = reduce_to_basic(rawlccn)
@@ -268,6 +271,7 @@ module StdNum
 
     def self.valid? lccn, preprocessed = false
       lccn = normalize(lccn) unless preprocessed
+      return false unless lccn
       clean = lccn.gsub(/\-/, '')
       suffix = clean[-8..-1] # "the rightmost eight characters are always digits"
       return false unless suffix and suffix =~ /^\d+$/
@@ -285,10 +289,11 @@ module StdNum
       else
         return false
       end
+
+      return false
     end
 
   end
 
 end
 
-    

data/lib/library_stdnums/version.rb

@@ -0,0 +1,4 @@
+module LibraryStdnums
+  # library_stdnums version
+  VERSION = "1.2.0"
+end

data/library_stdnums.gemspec

@@ -0,0 +1,60 @@
+# encoding: utf-8
+
+require 'yaml'
+
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
+
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+                  require 'library_stdnums/version'
+                  LibraryStdnums::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+
+  glob = lambda { |patterns| gem.files & Dir[*patterns] }
+
+  gem.files = `git ls-files`.split($/)
+  gem.files = glob[gemspec['files']] if gemspec['files']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+  gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.test_files       = glob[gemspec['test_files'] || 'spec/{**/}*_spec.rb}']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = lambda { |string| string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
+    end
+  end
+
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
+  end
+end

data/spec/library_stdnums_spec.rb

@@ -85,9 +85,19 @@ describe "ISBN" do
     StdNum::ISBN.convert_to_10('978-0-306-40615-7').must_equal '0306406152'
   end
 
+  it "normalizes" do
+    StdNum::ISBN.normalize('0-306-40615-2').must_equal '9780306406157'
+    StdNum::ISBN.normalize('0-306-40615-X').must_equal nil
+    StdNum::ISBN.normalize('ISBN: 978-0-306-40615-7').must_equal '9780306406157'
+    StdNum::ISBN.normalize('ISBN: 978-0-306-40615-3').must_equal nil
+  end
+
   it "gets both normalized values" do
     a = StdNum::ISBN.allNormalizedValues('978-0-306-40615-7')
     a.sort.must_equal ['9780306406157', '0306406152' ].sort
+
+    a = StdNum::ISBN.allNormalizedValues('0-306-40615-2')
+    a.sort.must_equal ['9780306406157', '0306406152' ].sort
   end
 
 
@@ -107,7 +117,7 @@ describe 'ISSN' do
 end
 
 
-describe 'LCCN' do
+describe 'LCCN basics' do
 
   # Tests take from http://www.loc.gov/marc/lccn-namespace.html#syntax
   test = {
@@ -127,5 +137,441 @@ describe 'LCCN' do
     end
   end
 
+  it "validates correctly" do
+    StdNum::LCCN.valid?("n78-890351").must_equal true
+    StdNum::LCCN.valid?("n78-89035100444").must_equal false, "Too long"
+    StdNum::LCCN.valid?("n78").must_equal false, "Too short"
+    StdNum::LCCN.valid?("na078-890351").must_equal false, "naa78-890351 should start with three letters or digits"
+    StdNum::LCCN.valid?("n078-890351").must_equal false, "n078-890351 should start with two letters or two digits"
+    StdNum::LCCN.valid?("na078-890351").must_equal false, "na078-890351 should start with three letters or digits"
+    StdNum::LCCN.valid?("0an78-890351").must_equal false, "0an78-890351 should start with three letters or digits"
+    StdNum::LCCN.valid?("n78-89c0351").must_equal false, "n78-89c0351 has a letter after the dash"
+  end
+
 
 end
+
+
+describe "LCCN tests from Business::LCCN perl module" do
+  tests = [
+    {  :orig => 'n78-890351',
+                 :canonical => 'n  78890351 ',
+                 :normalized => 'n78890351',
+                 :prefix => 'n',
+                 :year_cataloged => 1978,
+                 :serial => '890351',
+              },
+              {  :orig => 'n 78890351 ',
+                 :canonical => 'n  78890351 ',
+                 :normalized => 'n78890351',
+                 :prefix => 'n',
+                 :year_cataloged => 1978,
+                 :serial => '890351',
+              },
+              {  :orig => ' 85000002 ',
+                 :canonical => '   85000002 ',
+                 :normalized => '85000002',
+                 :year_cataloged => 1985,
+                 :serial => '000002',
+              },
+              {  :orig => '85-2 ',
+                 :canonical => '   85000002 ',
+                 :normalized => '85000002',
+                 :year_cataloged => 1985,
+                 :serial => '000002',
+              },
+              {  :orig => '2001-000002',
+                 :canonical => '  2001000002',
+                 :normalized => '2001000002',
+                 :year_cataloged => 2001,
+                 :serial => '000002',
+              },
+              {  :orig => '75-425165//r75',
+                 :canonical => '   75425165 //r75',
+                 :normalized => '75425165',
+                 :prefix => '',
+                 :year_cataloged => nil,
+                 :serial => '425165',
+                 :revision_year => 1975,
+                 :revision_year_encoded => '75',
+                 :revision_number => nil,
+              },
+              {  :orig => ' 79139101 /AC/r932',
+                 :canonical => '   79139101 /AC/r932',
+                 :normalized => '79139101',
+                 :prefix => '',
+                 :year_cataloged => nil,
+                 :serial => '139101',
+                 :suffix_encoded => '/AC',
+                 :revision_year => 1993,
+                 :revision_year_encoded => '93',
+                 :revision_number => 2,
+              },
+              {  :orig => '89-4',
+                 :canonical => '   89000004 ',
+                 :normalized => '89000004',
+                 :year_cataloged => 1989,
+                 :serial => '000004',
+              },
+              {  :orig => '89-45',
+                 :canonical => '   89000045 ',
+                 :normalized => '89000045',
+                 :year_cataloged => 1989,
+                 :serial => '000045',
+              },
+              {  :orig => '89-456',
+                 :canonical => '   89000456 ',
+                 :normalized => '89000456',
+                 :year_cataloged => 1989,
+                 :serial => '000456',
+              },
+              {  :orig => '89-1234',
+                 :canonical => '   89001234 ',
+                 :normalized => '89001234',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => '89-001234',
+                 :canonical => '   89001234 ',
+                 :normalized => '89001234',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => '89001234',
+                 :canonical => '   89001234 ',
+                 :normalized => '89001234',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => '2002-1234',
+                 :canonical => '  2002001234',
+                 :normalized => '2002001234',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => '2002-001234',
+                 :canonical => '  2002001234',
+                 :normalized => '2002001234',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => '2002001234',
+                 :canonical => '  2002001234',
+                 :normalized => '2002001234',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => '   89001234 ',
+                 :canonical => '   89001234 ',
+                 :normalized => '89001234',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => '  2002001234',
+                 :canonical => '  2002001234',
+                 :normalized => '2002001234',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'a89-1234',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'a89-001234',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'a89001234',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'a2002-1234',
+                 :canonical => 'a 2002001234',
+                 :normalized => 'a2002001234',
+                 :prefix => 'a',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'a2002-001234',
+                 :canonical => 'a 2002001234',
+                 :normalized => 'a2002001234',
+                 :prefix => 'a',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'a2002001234',
+                 :canonical => 'a 2002001234',
+                 :normalized => 'a2002001234',
+                 :prefix => 'a',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'a 89001234 ',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'a 89-001234 ',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'a 2002001234',
+                 :canonical => 'a 2002001234',
+                 :normalized => 'a2002001234',
+                 :prefix => 'a',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab89-1234',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab89-001234',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab89001234',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab2002-1234',
+                 :canonical => 'ab2002001234',
+                 :normalized => 'ab2002001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab2002-001234',
+                 :canonical => 'ab2002001234',
+                 :normalized => 'ab2002001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab2002001234',
+                 :canonical => 'ab2002001234',
+                 :normalized => 'ab2002001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab 89001234 ',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab 2002001234',
+                 :canonical => 'ab2002001234',
+                 :normalized => 'ab2002001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'ab 89-1234',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'abc89-1234',
+                 :canonical => 'abc89001234 ',
+                 :normalized => 'abc89001234',
+                 :prefix => 'abc',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'abc89-001234',
+                 :canonical => 'abc89001234 ',
+                 :normalized => 'abc89001234',
+                 :prefix => 'abc',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'abc89001234',
+                 :canonical => 'abc89001234 ',
+                 :normalized => 'abc89001234',
+                 :prefix => 'abc',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'abc89001234 ',
+                 :canonical => 'abc89001234 ',
+                 :normalized => 'abc89001234',
+                 :prefix => 'abc',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/89001234',
+                 :canonical => '   89001234 ',
+                 :normalized => '89001234',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/a89001234',
+                 :canonical => 'a  89001234 ',
+                 :normalized => 'a89001234',
+                 :serial => '001234',
+                 :prefix => 'a',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/ab89001234',
+                 :canonical => 'ab 89001234 ',
+                 :normalized => 'ab89001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/abc89001234',
+                 :canonical => 'abc89001234 ',
+                 :normalized => 'abc89001234',
+                 :prefix => 'abc',
+                 :year_cataloged => 1989,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/2002001234',
+                 :canonical => '  2002001234',
+                 :normalized => '2002001234',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/a2002001234',
+                 :canonical => 'a 2002001234',
+                 :normalized => 'a2002001234',
+                 :prefix => 'a',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => 'http://lccn.loc.gov/ab2002001234',
+                 :canonical => 'ab2002001234',
+                 :normalized => 'ab2002001234',
+                 :prefix => 'ab',
+                 :year_cataloged => 2002,
+                 :serial => '001234',
+              },
+              {  :orig => '00-21595',
+                 :canonical => '   00021595 ',
+                 :normalized => '00021595',
+                 :year_cataloged => 2000,
+                 :serial => '021595',
+              },
+              {  :orig => '2001001599',
+                 :canonical => '  2001001599',
+                 :normalized => '2001001599',
+                 :year_cataloged => 2001,
+                 :serial => '001599',
+              },
+              {  :orig => '99-18233',
+                 :canonical => '   99018233 ',
+                 :normalized => '99018233',
+                 :year_cataloged => 1999,
+                 :serial => '018233',
+              },
+              {  :orig => '98000595',
+                 :canonical => '   98000595 ',
+                 :normalized => '98000595',
+                 :year_cataloged => 1898,
+                 :serial => '000595',
+              },
+              {  :orig => '99005074',
+                 :canonical => '   99005074 ',
+                 :normalized => '99005074',
+                 :year_cataloged => 1899,
+                 :serial => '005074',
+              },
+              {  :orig => '00003373',
+                 :canonical => '   00003373 ',
+                 :normalized => '00003373',
+                 :year_cataloged => 1900,
+                 :serial => '003373',
+              },
+              {  :orig => '01001599',
+                 :canonical => '   01001599 ',
+                 :normalized => '01001599',
+                 :year_cataloged => 1901,
+                 :serial => '001599',
+              },
+              {  :orig => '   95156543 ',
+                 :canonical => '   95156543 ',
+                 :normalized => '95156543',
+                 :year_cataloged => 1995,
+                 :serial => '156543',
+              },
+              {  :orig => '   94014580 /AC/r95',
+                 :canonical => '   94014580 /AC/r95',
+                 :normalized => '94014580',
+                 :year_cataloged => 1994,
+                 :serial => '014580',
+                 :suffix_encoded => '/AC',
+                 :revision_year_encoded => '95',
+                 :revision_year => 1995,
+              },
+              {  :orig => '   79310919 //r86',
+                 :canonical => '   79310919 //r86',
+                 :normalized => '79310919',
+                 :year_cataloged => 1979,
+                 :serial => '310919',
+                 :revision_year_encoded => '86',
+                 :revision_year => 1986,
+              },
+              {  :orig => 'gm 71005810  ',
+                 :canonical => 'gm 71005810 ',
+                 :normalized => 'gm71005810',
+                 :prefix => 'gm',
+                 :year_cataloged => 1971,
+                 :serial => '005810',
+              },
+              {  :orig => 'sn2006058112  ',
+                 :canonical => 'sn2006058112',
+                 :normalized => 'sn2006058112',
+                 :prefix => 'sn',
+                 :year_cataloged => 2006,
+                 :serial => '058112',
+              },
+              {  :orig => 'gm 71-2450',
+                 :canonical => 'gm 71002450 ',
+                 :normalized => 'gm71002450',
+                 :prefix => 'gm',
+                 :year_cataloged => 1971,
+                 :serial => '002450',
+              },
+              {  :orig => '2001-1114',
+                 :canonical => '  2001001114',
+                 :normalized => '2001001114',
+                 :year_cataloged => 2001,
+                 :serial => '001114',
+              },
+  ]
+  tests.each do |h|
+    it "normalizes #{h[:orig]}" do
+      StdNum::LCCN.normalize(h[:orig]).must_equal h[:normalized], "#{h[:orig]} doesn't normalize to #{h[:normalized]}"
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -1,9 +1,3 @@
-require 'rubygems'
-begin
-  gem 'minitest'
-rescue LoadError
-end
-
 require 'minitest/spec'
 require 'minitest/autorun'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: library_stdnums
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,38 +9,67 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-16 00:00:00.000000000 Z
+date: 2012-07-25 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2153722800 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :development
   prerelease: false
-  version_requirements: *2153722800
-description: Normalization and checksum computation for ISBN (10 and 13), ISSN, and
-  LCCN
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+description: A simple set of module functions to normalize, validate, and convert
+  common library standard numbers
 email: bill@dueber.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- LICENSE
-- README.markdown
+- ChangeLog.md
+- LICENSE.txt
+- README.md
 files:
-- .document
-- LICENSE
-- README.markdown
+- .gitignore
+- .travis.yml
+- .yardopts
+- ChangeLog.md
+- Gemfile
+- LICENSE.txt
+- README.md
 - Rakefile
-- VERSION
+- gemspec.yml
 - lib/library_stdnums.rb
+- lib/library_stdnums/version.rb
+- library_stdnums.gemspec
 - spec/library_stdnums_spec.rb
 - spec/spec_helper.rb
-homepage: http://github.com/billdueber/library_stdnums
-licenses: []
+homepage: https://github.com/billdueber/library_stdnums
+licenses:
+- MIT
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -59,8 +88,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Normalize and compute checkdigits for ISBN, ISSN, and LCCN
+summary: Normalize and validate ISBN / ISSN/ LCCN
 test_files: []
+has_rdoc: 

data/.document

@@ -1,5 +0,0 @@
-README.rdoc
-lib/**/*.rb
-bin/*
-features/**/*.feature
-LICENSE

data/VERSION

@@ -1 +0,0 @@
-1.1.0