epub-cfi 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: bdbce4ceaf9a43a511b16ea3919f1f0f028eedbf
-  data.tar.gz: fbb26bf902a5b301fa041bbe1d251bc33c840d7e
+SHA256:
+  metadata.gz: c7bd4bcf31dae58b934393de702fb036186b950bbeb72d065931d0406506c2be
+  data.tar.gz: 5820d5272ed8c29790c69e959c1e4b140eae9e567182b2c5929dbbcff41efc0e
 SHA512:
-  metadata.gz: 450c3498f4bc08da4fc5159239fb95e13ecdce20c22175a1d7be35a8390aef947097005a5a8b5bc09e3944d2c53a9f280b764e669f6b3cb3a4a8df8af690e923
-  data.tar.gz: 781bb732392cfcc3c287465d6e2489ecaa6d6ec1a779f4443bf22416e93839a0a9b54bbc8adbf67347d24f00d7c842d073f2da8d520af68900441459bbd32f58
+  metadata.gz: 83d606fc2a8321349c6b055df31610bbc384b7c42e620ee01ec6b1461b2c6a51534327c70442894a70f8faf6c0cee0a0506e84b55c5765a25a97d2ae6548ac7e
+  data.tar.gz: 8b950b018d6bde45b2c1107ab2c19048c4e05e06cc49c4cd59c4c77a5b4b706228bc2268b65eebbb91314a51104b5fa48ddf5371c202c187bda1faf023fbccab

data/.document

@@ -1,3 +1,3 @@
 - 
-ChangeLog.md
+ChangeLog.adoc
 COPYING.txt

data/.gitlab-ci.yml

@@ -1,12 +1,7 @@
 before_script:
   - ruby -v
   - which ruby
-  - gem install racc rake rubygems-tasks yard test-unit test-unit-notify pretty_backtrace simplecov
-
-test:2.2:
-  image: ruby:2.2
-  script:
-    rake test
+  - gem install --no-document racc rake rubygems-tasks yard test-unit test-unit-notify pretty_backtrace simplecov
 
 test:2.3:
   image: ruby:2.3
@@ -17,3 +12,13 @@ test:2.4:
   image: ruby:2.4
   script:
     rake test
+
+test:2.5:
+  image: ruby:2.5
+  script:
+    rake test
+
+test:2.6:
+  image: ruby:2.6
+  script:
+    rake test

data/.yardopts

@@ -1 +1 @@
---markup markdown --title "EPUB CFI Documentation" --protected
+--markup asciidoc --title "EPUB CFI Documentation" --protected

data/{ChangeLog.md → ChangeLog.adoc}

@@ -1,9 +1,14 @@
-### 0.1.1 / 2017-09-17
+=== 0.1.2 / 2019-05-19
+
+* Scan CFI string on demand to reduce memory footprint
+* Make CFI() funciton accepts CFI instance
+
+=== 0.1.1 / 2017-09-17
 
 * Add `CFI::Location.from_parent_and_subpath`
 * [BUG FIX]Consider the case subpath includes step indirection in Range.from_parent_and_start_and_end
 
-### 0.1.0 / 2017-03-12
+=== 0.1.0 / 2017-03-12
 
 * Initial release:
 

data/README.adoc

@@ -0,0 +1,80 @@
+= EPUB CFI
+
+image:https://badge.fury.io/rb/epub-cfi.svg["Gem Version", link="https://badge.fury.io/rb/epub-cfi"]
+image:https://gitlab.com/KitaitiMakoto/epub-cfi/badges/master/pipeline.svg[link="https://gitlab.com/KitaitiMakoto/epub-cfi/commits/master",title="pipeline status"]
+image:https://gitlab.com/KitaitiMakoto/epub-cfi/badges/master/coverage.svg[link="https://gitlab.com/KitaitiMakoto/epub-cfi/commits/master",title="coverage report"]
+
+* https://gitlab.com/KitaitiMakoto/epub-cfi[Homepage]
+* http://rubydoc.info/gems/epub-cfi/frames[Documentation]
+* mailto:KitaitiMakoto+at+gmail.com[Email]
+
+== Description
+
+Parser and builder implementation for EPUB CFI defined at http://www.idpf.org/epub/linking/cfi/
+
+Extracted from http://www.rubydoc.info/gems/epub-parser/file/docs/Home.markdown[EPUB Parser].
+
+== Features
+
+* Parses EPUB CFI string.
+* Builds EPUB CFI(implemented but currently useless).
+* Converts EPUB CFI object to a string.
+
+== Examples
+
+----
+require 'epub/cfi'
+
+location = EPUB::CFI.parse("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
+# Or location = EPUB::CFI("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
+# => #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
+location.to_s # => "epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])"
+
+location1 = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]")
+location2 = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]")
+location1 < location2 # => true
+location1 <=> location2 # => -1
+# location1 appears earlier than location2
+
+range = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05],/2/1:1,/3:4")
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:1>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/3:4>
+range.kind_of? ::Range # => true
+range.begin
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:1>
+range.end
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/3:4>
+range.start_subpath
+# => "/2/1:1"
+range.end_subpath
+# => "/3:4"
+range.parent_path
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]>
+range.to_s # => "epubcfi(/6/4[chap01ref]!/4[body01]/10[para05],/2/1:1,/3:4)"
+
+builtin_range = location2..location1
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]>
+builtin_range.to_s
+# => "epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy])..epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y])"
+builtin_range.kind_of? ::Range # => true
+builtin_range.kind_of? EPUB::CFI::Range # => false
+cfi_range = EPUB::CFI::Range.new(location2, location1)
+# => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]>
+cfi_range.kind_of? ::Range # => true
+cfi_range.kind_of? EPUB::CFI::Range # => true
+----
+
+== Install
+
+[listing]
+$ gem install epub-cfi
+
+== See also
+
+* http://www.idpf.org/epub/linking/cfi/[EPUB Canonical Fragment Identifiers 1.1]
+* http://www.rubydoc.info/gems/epub-parser/file/docs/Home.markdown[EPUB Parser]
+
+== Copyright
+
+Copyright (c) 2017 KITAITI Makoto
+
+See {file:COPYING.txt} for details.

data/Rakefile

@@ -3,16 +3,17 @@ require 'rake'
 
 task :default => "lib/epub/cfi/parser.tab.rb"
 
-file "lib/epub/cfi/parser.tab.rb" do |target|
-  sh "racc #{target.name.sub("tab.rb", "y")}"
+desc "Build EPUB CFI parser"
+file "lib/epub/cfi/parser.tab.rb" => "lib/epub/cfi/parser.y" do |task|
+  sh "racc #{task.source}"
 end
 
 require "rake/clean"
-CLEAN.include "lib/epub/cfi/parser.tab.rb"
+CLOBBER.include "lib/epub/cfi/parser.tab.rb"
 
 require 'rubygems/tasks'
 Gem::Tasks.new
-task :build => [:clean, "lib/epub/cfi/parser.tab.rb"]
+task :build => "lib/epub/cfi/parser.tab.rb"
 
 require 'rake/testtask'
 Rake::TestTask.new do |test|
@@ -24,4 +25,3 @@ task :test => "lib/epub/cfi/parser.tab.rb"
 
 require 'yard'
 YARD::Rake::YardocTask.new
-task :doc => :yard

data/appveyor.yml

@@ -0,0 +1,21 @@
+version: 1.0.{build}-{branch}
+
+environment:
+  matrix:
+    - RUBY_VERSION: 23
+    - RUBY_VERSION: 24
+    - RUBY_VERSION: 25
+    - RUBY_VERSION: 26
+
+install:
+  - set PATH=C:\Ruby%RUBY_VERSION%\bin;%PATH%
+  - gem install --no-document racc rake rubygems-tasks yard test-unit test-unit-notify pretty_backtrace simplecov
+
+build: off
+
+before_test:
+  - ruby -v
+  - gem -v
+
+test_script:
+  - rake test

data/lib/epub/cfi.rb

@@ -6,15 +6,30 @@ module EPUB
     RE_ESCAPED_SPECIAL_CHARS = Regexp.escape(SPECIAL_CHARS)
 
     class << self
+      # Escapes special characters in string
+      #
+      # @example
+      #   EPUB::CFI.escape("2[1]") #=> "2^[1^]"
+      #
+      # @param string [String] Component string of EPUB CFI
+      # @return [String] Escaped comonent string
       def escape(string)
         string.gsub(/([#{RE_ESCAPED_SPECIAL_CHARS}])/o, '^\1')
       end
 
+      # Unescape escaped characters in string
+      #
+      # @example
+      #   EPUB::CFI.unescape("2^[1^]") #=> "2[1]"
+      #
+      # @param string [String] Escape component string of EPUB CFI
+      # @return [String] Unescaped component string
       def unescape(string)
         string.gsub(/\^([#{RE_ESCAPED_SPECIAL_CHARS}])/o, '\1')
       end
     end
 
+    # {Location} indicates a point in an EPUB Publication.
     class Location
       include Comparable
 
@@ -141,14 +156,6 @@ module EPUB
           end
         end
       end
-
-      def each_step_with_instruction
-        yield [step, nil]
-        local_path.each_step_with_instruction do |s, instruction|
-          yield [s, instruction]
-        end
-        self
-      end
     end
 
     class Range < ::Range

data/lib/epub/cfi/parser.rb

@@ -7,12 +7,12 @@ class EPUB::CFI::Parser
   UNICODE_CHARACTER_PATTERN = Regexp.union(UNICODE_CHARACTER_EXCLUDING_SPECIAL_CHARS_AND_SPACE_AND_DOT_AND_COLON_AND_TILDE_AND_ATMARK_AND_SOLIDUS_AND_EXCLAMATION_MARK_PATTERN, Regexp.new(Regexp.escape(EPUB::CFI::SPECIAL_CHARS), / \.:~@!/))
 
   class << self
-    def parse(string, debug: false)
+    def parse(string, debug: $DEBUG)
       new(debug: debug).parse(string)
     end
   end
 
-  def initialize(debug: false)
+  def initialize(debug: $DEBUG)
     @yydebug = debug
     super()
   end
@@ -22,67 +22,92 @@ class EPUB::CFI::Parser
       string = string['epubcfi('.length .. -2]
     end
     @scanner = StringScanner.new(string, true)
-    @q = []
-    until @scanner.eos?
-      case
-      when @scanner.scan(/[1-9]/)
-        @q << [:DIGIT_NON_ZERO, @scanner[0]]
-      when @scanner.scan(/0/)
-        @q << [:ZERO, @scanner[0]]
-      when @scanner.scan(/ /)
-        @q << [:SPACE, @scanner[0]]
-      when @scanner.scan(/\^/)
-        @q << [:CIRCUMFLEX, @scanner[0]]
-      when @scanner.scan(/\[/)
-        @q << [:OPENING_SQUARE_BRACKET, @scanner[0]]
-      when @scanner.scan(/\]/)
-        @q << [:CLOSING_SQUARE_BRACKET, @scanner[0]]
-      when @scanner.scan(/\(/)
-        @q << [:OPENING_PARENTHESIS, @scanner[0]]
-      when @scanner.scan(/\)/)
-        @q << [:CLOSING_PARENTHESIS, @scanner[0]]
-      when @scanner.scan(/,/)
-        @q << [:COMMA, @scanner[0]]
-      when @scanner.scan(/;/)
-        @q << [:SEMICOLON, @scanner[0]]
-      when @scanner.scan(/=/)
-        @q << [:EQUAL, @scanner[0]]
-      when @scanner.scan(/\./)
-        @q << [:DOT, @scanner[0]]
-      when @scanner.scan(/:/)
-        @q << [:COLON, @scanner[0]]
-      when @scanner.scan(/~/)
-        @q << [:TILDE, @scanner[0]]
-      when @scanner.scan(/@/)
-        @q << [:ATMARK, @scanner[0]]
-      when @scanner.scan(/\//)
-        @q << [:SOLIDUS, @scanner[0]]
-      when @scanner.scan(/!/)
-        @q << [:EXCLAMATION_MARK, @scanner[0]]
-      when @scanner.scan(UNICODE_CHARACTER_EXCLUDING_SPECIAL_CHARS_AND_SPACE_AND_DOT_AND_COLON_AND_TILDE_AND_ATMARK_AND_SOLIDUS_AND_EXCLAMATION_MARK_PATTERN)
-        @q << [:UNICODE_CHARACTER_EXCLUDING_SPECIAL_CHARS_AND_SPACE_AND_DOT_AND_COLON_AND_TILDE_AND_ATMARK_AND_SOLIDUS_AND_EXCLAMATION_MARK, @scanner[0]]
-      else
-        raise 'unexpected character'
-      end
-    end
-    @q << [false, false]
-
     do_parse
   end
 
   def next_token
-    @q.shift
+    return [false, false] if @scanner.eos?
+
+    case
+    when @scanner.scan(/[1-9]/)
+      [:DIGIT_NON_ZERO, @scanner[0]]
+    when @scanner.scan(/0/)
+      [:ZERO, @scanner[0]]
+    when @scanner.scan(/ /)
+      [:SPACE, @scanner[0]]
+    when @scanner.scan(/\^/)
+      [:CIRCUMFLEX, @scanner[0]]
+    when @scanner.scan(/\[/)
+      [:OPENING_SQUARE_BRACKET, @scanner[0]]
+    when @scanner.scan(/\]/)
+      [:CLOSING_SQUARE_BRACKET, @scanner[0]]
+    when @scanner.scan(/\(/)
+      [:OPENING_PARENTHESIS, @scanner[0]]
+    when @scanner.scan(/\)/)
+      [:CLOSING_PARENTHESIS, @scanner[0]]
+    when @scanner.scan(/,/)
+      [:COMMA, @scanner[0]]
+    when @scanner.scan(/;/)
+      [:SEMICOLON, @scanner[0]]
+    when @scanner.scan(/=/)
+      [:EQUAL, @scanner[0]]
+    when @scanner.scan(/\./)
+      [:DOT, @scanner[0]]
+    when @scanner.scan(/:/)
+      [:COLON, @scanner[0]]
+    when @scanner.scan(/~/)
+      [:TILDE, @scanner[0]]
+    when @scanner.scan(/@/)
+      [:ATMARK, @scanner[0]]
+    when @scanner.scan(/\//)
+      [:SOLIDUS, @scanner[0]]
+    when @scanner.scan(/!/)
+      [:EXCLAMATION_MARK, @scanner[0]]
+    when @scanner.scan(UNICODE_CHARACTER_EXCLUDING_SPECIAL_CHARS_AND_SPACE_AND_DOT_AND_COLON_AND_TILDE_AND_ATMARK_AND_SOLIDUS_AND_EXCLAMATION_MARK_PATTERN)
+      [:UNICODE_CHARACTER_EXCLUDING_SPECIAL_CHARS_AND_SPACE_AND_DOT_AND_COLON_AND_TILDE_AND_ATMARK_AND_SOLIDUS_AND_EXCLAMATION_MARK, @scanner[0]]
+    else
+      raise 'unexpected character'
+    end
   end
 end
 
 module EPUB::CFI
   module_function
 
+  # Parses the given string, creates a new {CFI} object and return it.
+  #
+  # @example Parses a URI fragment string
+  #   EPUB::CFI.parse("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
+  #   #=> #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
+  #
+  # @example Parses a path string
+  #   EPUB::CFI.parse("/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]")
+  #   #=> #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
+  #
+  # @param string [String]
+  # @return [CFI]
+  # @raise [Racc::ParseError] if given string is invalid
   def parse(string)
     EPUB::CFI::Parser.parse(string)
   end
 end
 
+# Creates a new {CFI} object from the given string and return it.
+#
+# @example Creates from a URI fragment string
+#   EPUB::CFI("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
+#   #=> #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
+#
+# @example Creates from a path string
+#   EPUB::CFI("/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]")
+#   #=> #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
+#
+# @param string [String, CFI]
+# @return [CFI] CFI parsed from +string+ when +string+ is a String. +string+ itself when it's a CFI
+# @raise [Racc::ParseError] if given string is invalid
+# @see CFI.parse
 def EPUB::CFI(string)
-  EPUB::CFI.parse(string)
+  string.kind_of?(EPUB::CFI::Location) || string.kind_of?(EPUB::CFI::Range) ?
+    string :
+    EPUB::CFI.parse(string)
 end

data/lib/epub/cfi/version.rb

@@ -18,6 +18,6 @@
 module EPUB
   module CFI
     # epub-cfi version
-    VERSION = "0.1.1"
+    VERSION = "0.1.2"
   end
 end

data/test/test_cfi.rb

@@ -11,6 +11,28 @@ class TestCFI < Test::Unit::TestCase
     assert_equal '^[](),;=', EPUB::CFI.unescape('^^^[^]^(^)^,^;^=')
   end
 
+  class TestLocation < self
+    def test_copy
+      cfi = EPUB::CFI::Parser.parse('epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])')
+      cloned = cfi.clone
+      assert_equal cfi, cloned
+      assert_not_same cfi, cloned
+    end
+
+    def test_join
+      location = EPUB::CFI::Parser.parse('epubcfi(/6/14[chap05ref])')
+      other_path = EPUB::CFI::Path.new([EPUB::CFI::Path.new([
+        EPUB::CFI::Step.new(4, EPUB::CFI::IDAssertion.new('body01')),
+        EPUB::CFI::Step.new(10),
+        EPUB::CFI::Step.new(2),
+        EPUB::CFI::Step.new(1)
+      ])])
+      joined = location.join([other_path])
+
+      assert_equal 'epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1)', joined.to_s
+    end
+  end
+
   class TestPath < self
     data([
       'epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])',

data/test/test_parser.rb

@@ -53,4 +53,15 @@ class TestParserCFI < Test::Unit::TestCase
       EPUB::CFI(cfi)
     end
   end
+
+  def test_cfi_function_accepts_cfi_instance
+    cfi = EPUB::CFI::Parser.parse('epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])')
+    parsed = nil
+
+    assert_nothing_raised do
+      parsed = EPUB::CFI(cfi)
+    end
+
+    assert_equal cfi, parsed
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: epub-cfi
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - KITAITI Makoto
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-16 00:00:00.000000000 Z
+date: 2019-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: racc
@@ -133,9 +133,10 @@ files:
 - ".gitlab-ci.yml"
 - ".yardopts"
 - COPYING.txt
-- ChangeLog.md
-- README.md
+- ChangeLog.adoc
+- README.adoc
 - Rakefile
+- appveyor.yml
 - epub-cfi.gemspec
 - lib/epub/cfi.rb
 - lib/epub/cfi/parser.rb
@@ -164,8 +165,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: EPUB CFI parser and builder

data/README.md

@@ -1,85 +0,0 @@
-EPUB CFI
-========
-
-* [Homepage](https://gitlab.com/KitaitiMakoto/epub-cfi)
-* [Documentation](http://rubydoc.info/gems/epub-cfi/frames)
-* [Email](mailto:KitaitiMakoto at gmail.com)
-
-Description
------------
-
-Parser and builder implementation for EPUB CFI defined at http://www.idpf.org/epub/linking/cfi/
-
-Extracted from [EPUB Parser][].
-
-[EPUB Parser]: http://www.rubydoc.info/gems/epub-parser/file/docs/Home.markdown
-
-Features
---------
-
-* Parses EPUB CFI string.
-* Builds EPUB CFI(implemented but currently useless).
-* Converts EPUB CFI object to a string.
-
-Examples
---------
-
-    require 'epub/cfi'
-    
-    location = EPUB::CFI.parse("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
-    # Or location = EPUB::CFI("epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])")
-    # => #<EPUB::CFI::Location:/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]]>
-    location.to_s # => "epubcfi(/6/14[chap05ref]!/4[body01]/10/2/1:3[2^[1^]])"
-    
-    location1 = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]")
-    location2 = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]")
-    location1 < location2 # => true
-    location1 <=> location2 # => -1
-    # location1 appears earlier than location2
-    
-    range = EPUB::CFI("/6/4[chap01ref]!/4[body01]/10[para05],/2/1:1,/3:4")
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:1>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/3:4>
-    range.kind_of? ::Range # => true
-    range.begin
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:1>
-    range.end
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/3:4>
-    range.start_subpath
-    # => "/2/1:1"
-    range.end_subpath
-    # => "/3:4"
-    range.parent_path
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]>
-    range.to_s # => "epubcfi(/6/4[chap01ref]!/4[body01]/10[para05],/2/1:1,/3:4)"
-    
-    builtin_range = location2..location1
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]>
-    builtin_range.to_s
-    # => "epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy])..epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y])"
-    builtin_range.kind_of? ::Range # => true
-    builtin_range.kind_of? EPUB::CFI::Range # => false
-    cfi_range = EPUB::CFI::Range.new(location2, location1)
-    # => #<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/2/1:3[yyy]>..#<EPUB::CFI::Location:/6/4[chap01ref]!/4[body01]/10[para05]/1:3[xx,y]>
-    cfi_range.kind_of? ::Range # => true
-    cfi_range.kind_of? EPUB::CFI::Range # => true
-
-Install
--------
-
-    $ gem install epub-cfi
-
-See also
---------
-
-* [EPUB Canonical Fragment Identifiers 1.1][spec]
-* [EPUB Parser][]
-
-[spec]: http://www.idpf.org/epub/linking/cfi/
-[EPUB Parser]: http://www.rubydoc.info/gems/epub-parser/file/docs/Home.markdown
-
-Copyright
----------
-
-Copyright (c) 2017 KITAITI Makoto
-
-See {file:COPYING.txt} for details.