bookland 1.0.1 → 1.0.2

data/.travis.yml

@@ -0,0 +1,8 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby
+  - rbx
+  - rbx-2.0
+  - ree

data/Gemfile

@@ -1,3 +1,5 @@
 source 'http://rubygems.org'
 
 gemspec
+
+gem 'rake'

data/LICENSE

@@ -1,7 +1,4 @@
-Copyright (c) 2008, Keiichirou SHIKANO <k16.shikano@gmail.com> and 
-shamelessly hacked by folks at Paper Cavalier in the year of the 
-Lord 2010.
-
+Copyright (c) 2008, Keiichirou SHIKANO <k16.shikano@gmail.com>
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -1,38 +1,28 @@
-Bookland
-========
+# Bookland
 
-[Bookland](http://en.wikipedia.org/wiki/Bookland) provides an ISBN class in
-Ruby.
+[Bookland] [1] provides an ISBN class in Ruby.
 
-Usage
------
+[![travis](https://secure.travis-ci.org/hakanensari/bookland.png)](http://travis-ci.org/hakanensari/bookland)
 
-    require 'bookland'
+## Usage
 
-    isbn10 = ISBN.new('0262011530')
-    isbn10.to_isbn13
-    => "9780262011532"
-
-    isbn10.to_s(1, 3, 5)
-    => "0-262-01153-0"
+    require "bookland"
 
-    isbn13 == ISBN.new('9780262011532')
+    isbn = ISBN.new("0262011530")
+    isbn.to_isbn13
+    => "9780262011532"
+    isbn.valid?
     => true
 
-    # Does an invalid ISBN quack like an ISBN?
-    bad_isbn = ISBN.new('0262011531')
-    bad_isbn.valid?
-    => false
-    bad_isbn.to_isbn13
-    => Bookland::ISBNError: Invalid ISBN
+Bookland provides certain utility methods defined on the class level:
 
-Some utility methods defined in the class level:
-
-    ISBN.to_13('0262011530')
+    ISBN.to_13("0262011530")
     => "9780262011532"
 
-    ISBN.to_10('9780262011532')
+    ISBN.to_10("9780262011532")
     => "0262011530"
 
-    ISBN.valid?('9780262011532')
+    ISBN.valid?("9780262011532")
     => true
+
+[1]: http://en.wikipedia.org/wiki/Bookland

data/Rakefile

@@ -9,15 +9,3 @@ RSpec::Core::RakeTask.new(:spec) do |spec|
 end
 
 task :default => :spec
-
-require 'rocco/tasks'
-Rocco::make 'docs/'
-
-desc 'Build rocco docs'
-task :docs => :rocco
-directory 'docs/'
-
-desc 'Build docs and open in browser for the reading'
-task :read => :docs do
-  sh 'open docs/lib/bookland/isbn.html'
-end

data/bookland.gemspec

@@ -6,11 +6,11 @@ Gem::Specification.new do |s|
   s.name        = 'bookland'
   s.version     = Bookland::VERSION
   s.platform    = Gem::Platform::RUBY
-  s.authors     = ['Paper Cavalier']
+  s.authors     = ['Hakan Ensari']
   s.email       = 'code@papercavalier.com'
-  s.homepage    = 'https://rubygems.org/gems/bookland'
-  s.summary     = %q{An ISBN class in Ruby}
-  s.description = %q{Bookland is an ISBN class in Ruby.}
+  s.homepage    = 'https://github.com/hakanensari/bookland'
+  s.summary     = %q{An ISBN class}
+  s.description = %q{Bookland provides an ISBN class.}
 
   s.rubyforge_project = 'bookland'
 
@@ -19,6 +19,5 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ['lib']
 
-  s.add_development_dependency('rspec', '~> 2.5.0')
-  s.add_development_dependency('rocco', '~> 0.6.0')
+  s.add_development_dependency('rspec', '~> 2.6')
 end

data/lib/bookland/isbn.rb

@@ -1,32 +1,17 @@
-# encoding: UTF-8
-#
-# [Bookland][bl] is a simple ISBN class in Ruby.
+# [Bookland][bl] is an ISBN class in Ruby.
 #
 # [bl]: http://en.wikipedia.org/wiki/Bookland
 module Bookland
-
-  #### Public Interface
-  #
-  # `ISBN.new` takes an optional string. The string should look like an ISBN
-  # and may contain extra characters that are traditionally used to format
-  # ISBNs.
-  #
-  # The following are valid instantiations:
-  #
-  #     isbn13 = ISBN.new('9780826476951')
-  #     isbn10 = ISBN.new('0-8264-7695-3')
-  #
-  #     isbn10 == isbn13
-  #     => true
   class ISBN
     class << self
-
-      # Casts a specified string to a 10-digit ISBN.
+      # Converts specified string to a 10-digit ISBN and returns its
+      # string representation.
       def to_10(isbn)
         new(isbn).to_isbn10.to_s
       end
 
-      # Casts a specified string to a 13-digit ISBN.
+      # Converts specified string to a 13-digit ISBN and returns its
+      # string representation.
       def to_13(isbn)
         new(isbn).to_isbn13.to_s
       end
@@ -37,11 +22,22 @@ module Bookland
       end
     end
 
-    def initialize(seed=nil)
+    # Instantiates a new ISBN object.
+    #
+    # Takes an optional string. The string should look like an ISBN and
+    # may contain extra characters that are traditionally used to
+    # format ISBNs.
+    #
+    # The following are valid instantiations for the same ISBN:
+    #
+    #     isbn13 = ISBN.new('9780826476951')
+    #     isbn10 = ISBN.new('0-8264-7695-3')
+    #
+    def initialize(seed = nil)
       self.seed = seed
     end
 
-    # Returns `true` if the ISBN is equal to another specified ISBN.
+    # Returns +true+ if the ISBN is equal to another specified ISBN.
     def ==(other)
       to_isbn13.to_s == other.to_isbn13.to_s
     end
@@ -53,12 +49,11 @@ module Bookland
 
     # Sets the seed of the ISBN based on a specified string.
     def seed=(seed)
-      @raw = seed.gsub(/[^Xx0-9]/, '').split(//) rescue @raw = []
+      @raw = seed.gsub(/[^\dx]/i, '').split('') rescue []
     end
 
-    # Casts the ISBN to a ten-digit ISBN.
+    # Casts the ISBN to a 10-digit ISBN.
     def to_isbn10
-
       raise ISBNError unless valid?
 
       if isbn13?
@@ -80,17 +75,17 @@ module Bookland
       end
     end
 
-    # Casts ISBN to a string.
+    # Returns a string representation of the ISBN.
     #
-    # Takes an optional list of integers, which it then uses to dashify the
-    # ISBN like so:
+    # Takes an optional list of integers, which it then uses to dashify
+    # the ISBN like so:
     #
     #     isbn = ISBN.new('0826476953')
     #     isbn.to_s(1,4,4,1)
     #     => "0-8264-7695-3"
     #
     def to_s(*blocks)
-      return false unless valid?
+      return nil unless valid?
 
       raw = @raw.dup
       if blocks.any?
@@ -100,7 +95,7 @@ module Bookland
       end
     end
 
-    # Returns `true` if the ISBN is valid.
+    # Returns +true+ if the ISBN is valid.
     def valid?
       if isbn10?
         @raw[9] == check_digit_10(@raw)
@@ -142,5 +137,3 @@ module Bookland
     end
   end
 end
-
-# C'est ça.

data/lib/bookland/version.rb

@@ -1,3 +1,3 @@
 module Bookland
-  VERSION = '1.0.1'
+  VERSION = '1.0.2'
 end

data/spec/bookland/isbn_spec.rb

@@ -153,7 +153,7 @@ module Bookland
         ISBN.new('9780485113358').to_s(3, 10).should eql '978-0485113358'
       end
 
-      it "casts to string and hyphenate a ten-digit ISBN" do
+      it "casts to string and hyphenates a ten-digit ISBN" do
         ISBN.new('048511335X').to_s(1, 3, 5, 1).should eql '0-485-11335-X'
       end
 

metadata

@@ -1,69 +1,36 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: bookland
-version: !ruby/object:Gem::Version 
-  hash: 21
+version: !ruby/object:Gem::Version
+  version: 1.0.2
   prerelease: 
-  segments: 
-  - 1
-  - 0
-  - 1
-  version: 1.0.1
 platform: ruby
-authors: 
-- Paper Cavalier
+authors:
+- Hakan Ensari
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-03-17 00:00:00 +00:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-08-21 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rspec
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70172727862740 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 27
-        segments: 
-        - 2
-        - 5
-        - 0
-        version: 2.5.0
+      - !ruby/object:Gem::Version
+        version: '2.6'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rocco
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 0
-        - 6
-        - 0
-        version: 0.6.0
-  type: :development
-  version_requirements: *id002
-description: Bookland is an ISBN class in Ruby.
+  version_requirements: *70172727862740
+description: Bookland provides an ISBN class.
 email: code@papercavalier.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
-- .rspec
-- .rvmrc
+- .travis.yml
 - Gemfile
-- History.md
 - LICENSE
 - README.md
 - Rakefile
@@ -75,41 +42,37 @@ files:
 - spec/bookland_spec.rb
 - spec/fixtures/isbn
 - spec/spec_helper.rb
-has_rdoc: true
-homepage: https://rubygems.org/gems/bookland
+homepage: https://github.com/hakanensari/bookland
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: -3532017646566011220
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
+      hash: -3532017646566011220
 requirements: []
-
 rubyforge_project: bookland
-rubygems_version: 1.5.2
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
-summary: An ISBN class in Ruby
-test_files: 
+summary: An ISBN class
+test_files:
 - spec/bookland/isbn_spec.rb
 - spec/bookland_spec.rb
 - spec/fixtures/isbn

data/.rspec

@@ -1 +0,0 @@
---color --format=documentation

data/.rvmrc

@@ -1,3 +0,0 @@
-rvm_gemset_create_on_use_flag=1
-rvm wrapper ree@bookland textmate
-rvm ree@bookland

data/History.md

@@ -1,9 +0,0 @@
-# 0.1.0 / 2010-04-22
-* First public release
-
-# 0.2.0 / 2010-04-28
-* Made valid? public
-* Will raise error if invalid ISBN instance is cast as string or recast as ISBN
-
-# 0.3.0 / 2010-08-09
-* Added class methods to cast to ISBN-10 and ISBN-13