epubinfo_with_toc 0.4.5

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OGIwMDJiYTZmNmM5ZWY1MmYwNjk4YWY4ZmM3NzZkZTI3MTY2NTg1YQ==
+  data.tar.gz: !binary |-
+    MTcyNGFjODNlNWUzM2Q1MjY2NDQyM2FjMGViODVlNzYzNjM5YzFjZg==
+SHA512:
+  metadata.gz: !binary |-
+    YmE4Nzc2NGM2YzkwNjJjMmI0NWEwNGYxMzc0ZTc2NjhiNGIyYTVhYjhlM2Jk
+    ZWEzN2FlYjUyYzliMzcwNTljNjM4YzE4NjFkMzhhZDMzNDEwOTU1OWU4YmI5
+    YWU4MTZlOTFlMDNmOGE5MzIzYWQ1MTRhYzc4MjBjYzg1MjllZDU=
+  data.tar.gz: !binary |-
+    YTM0NDBhMjQzYmRjODQ3MWE2ZTgxYTIwOGFkOTc4MDdjODg5M2Q1NmE5NjAz
+    OGFlNGVhMmQzOWEwOGM5NDI4YTE1NDAyZjcyNGMzMWNkYmNlZGYwZGU3Mzhm
+    OWUwZTAyMjRjN2MwNWMzM2I5OGM0ZTU1YWZkMGY5Nzg2NTY5ZGQ=

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Christof Dorner
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,126 @@
+# epubinfo [![Continuous Integration](https://travis-ci.org/mehmetc/epubinfo.png?branch=table_of_contents)](http://travis-ci.org/mehmetc/epubinfo)
+Extracts metadata information from EPUB files. Supports EPUB2 and EPUB3 formats.
+
+This is a fork of epubinfo written by [![Christof Dorner](https://github.com/chdorner/epubinfo)].
+With this version you can query the Table Of Contents of an EPUB.
+
+Until this branch gets merged into the master you can install it by
+
+```
+gem install epubinfo_with_toc
+```
+
+or in your Gemfile
+
+```
+gem 'epubinfo_with_toc'
+```
+
+## Usage
+
+```ruby
+require 'epubinfo'
+book = EPUBInfo.get('path/to/epub/file.epub')
+```
+
+Which returns a `EPUBInfo::Models::Book` instance, please refer to the [API documentation](http://rubydoc.info/gems/epubinfo/frames) from here on
+
+## Resources
+
+### Querying all resource
+ ```ruby
+all_resources = book.table_of_contents.resources.to_a
+```
+
+### Querying by URI
+```ruby
+page 1 = Nokogiri::HTML(book.table_of_contents.resources['page1.html'])
+```
+
+### Querying by id
+```ruby
+page 2 = Nokogiri::HTML(book.table_of_contents.resources['page2'])
+page 3 = Nokogiri::HTML(book.table_of_contents.resources[:page3])
+```
+
+### Querying for a range
+```ruby
+pages1_4 = book.table_of_contents.resources[0..3]
+```
+
+### Querying for a list of specific resources
+```ruby
+images = book.table_of_contents.images
+fonts  = book.table_of_contents.fonts
+videos = book.table_of_contents.videos
+js     = book.table_of_contents.javascripts
+css    = book.table_of_contents.css
+```
+
+### Get a list of all the different mime-types used
+```ruby
+types = book.table_of_contents.types
+```
+
+### print SPINE text
+```ruby
+resources = {}
+book.table_of_contents.resources.spine.each do |resource|
+    puts resource[:text]
+end
+```
+
+## Changelog
+
+**0.4.4** *October 24,2013*
+
+* added table of contents
+
+**0.4.3** *September 12, 2013*
+
+* Made cover detection more robust by escaping the CSS selectors (by [versapub](https://github.com/versapub))
+
+**0.4.2** *August 16, 2013*
+
+* Improved cover detection for EPUB3 (by [takahashim](https://github.com/takahashim))
+* Improved cover detection for EPUB2 (by [cyrret](https://github.com/cyrret))
+
+**0.4.1** *February 15, 2013*
+
+* Added Book#version to get EPUB version of the file (by [takahashim](https://github.com/takahashim))
+* Added support for modified_date in Book#dates (by [takahashim](https://github.com/takahashim))
+
+**0.4.0** *July 31, 2012*
+
+* Added Book#cover method for extracting covers from epubs
+
+**0.3.6** *June 18, 2012*
+
+* Upgraded rubyzip dependency to version 0.9.9 for more robust zip handling
+
+**0.3.5** *June 17, 2012*
+
+* Reading out path of root document is more robust (removing XML namespaces)
+
+**0.3.4** *June 1, 2012*
+
+* Default value for titles (empty array)
+* Code refactorings
+
+*For older versions compare commits with git.*
+
+## Contributing to epubinfo
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2012 Christof Dorner. See LICENSE.txt for
+further details.
+

data/lib/epubinfo/models/book.rb

@@ -0,0 +1,126 @@
+module EPUBInfo
+  module Models
+    class Book
+      # Titles, array of String instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.1 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :titles
+      def titles; @titles || []; end
+
+      # Creators, array of Person instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.2 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :creators
+      def creators; @creators || []; end
+
+      # Subjects, array of String instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.3 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :subjects
+      def subjects; @subjects || []; end
+
+      # Description ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.4 EPUB2 reference})
+      # @return [String]
+      attr_accessor :description
+
+      # Publisher ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.5 EPUB2 reference})
+      # @return [String]
+      attr_accessor :publisher
+
+      # Contributors, array of Person instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.6 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :contributors
+      def contributors; @contributors || []; end
+
+      # Dates, array of Date instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.7 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :dates
+      def dates; @dates || []; end
+
+      # Identifiers, array of Identifier instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.10 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :identifiers
+      def identifiers; @identifiers || []; end
+
+      # Source ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.11 EPUB2 reference})
+      # @return [String]
+      attr_accessor :source
+
+      # Languages, array of String instances ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.12 EPUB2 reference})
+      # @return [Array]
+      attr_accessor :languages
+      def languages; @languages || []; end
+
+      # Rights ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.15 EPUB2 reference})
+      # @return [String]
+      attr_accessor :rights
+
+      # DRM protected
+      # @return [Boolean]
+      attr_accessor :drm_protected
+      def drm_protected; @drm_protected || false; end
+      alias :drm_protected? :drm_protected
+
+      # Cover
+      # @return [Cover]
+      attr_accessor :cover
+
+      #Table of Contents
+      # @return [TableOfContents]
+      attr_accessor :table_of_contents
+
+      # EPUB Version ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section1.4.1.2})
+      # @return [String]
+      attr_accessor :version
+
+      # Should never be called directly, go through EPUBInfo.get
+      def initialize(parser)
+        document = parser.metadata_document
+        return if document.nil?
+        document.remove_namespaces!
+        metadata = document.css('metadata')
+        self.version = document.css('package')[0]['version']
+        self.titles = metadata.xpath('.//title').map(&:content)
+        self.creators = metadata.xpath('.//creator').map {|c| EPUBInfo::Models::Person.new(c) }
+        self.subjects = metadata.xpath('.//subject').map(&:content)
+        self.description = metadata.xpath('.//description').first.content rescue nil
+        self.publisher = metadata.xpath('.//publisher').first.content rescue nil
+        self.contributors = metadata.xpath('.//contributor').map {|c| EPUBInfo::Models::Person.new(c) }
+        self.dates = metadata.xpath('.//date').map { |d| EPUBInfo::Models::Date.new(d) }
+        modified_date = metadata.xpath(".//meta[@property='dcterms:modified']").map do |d|
+          date = EPUBInfo::Models::Date.new(d)
+          date.event = 'modification'
+          date
+        end
+        self.dates += modified_date;
+        self.identifiers = metadata.xpath('.//identifier').map { |i| EPUBInfo::Models::Identifier.new(i) }
+        self.source = metadata.xpath('.//source').first.content rescue nil
+        self.languages = metadata.xpath('.//language').map(&:content)
+        self.rights = metadata.xpath('.//rights').first.content rescue nil
+        self.drm_protected = parser.drm_protected?
+        self.cover = EPUBInfo::Models::Cover.new(parser)
+        self.table_of_contents = EPUBInfo::Models::TableOfContents.new(parser)
+      end
+
+
+      # Returns Hash representation of the book
+      # @return [Hash]
+      def to_hash
+        {
+          :titles => @titles,
+          :creators => @creators.map(&:to_hash),
+          :subjects => @subjects,
+          :description => @description,
+          :publisher => @publisher,
+          :contributors => @contributors.map(&:to_hash),
+          :dates => @dates.map(&:to_hash),
+          :identifiers => @identifiers.map(&:to_hash),
+          :source => @source,
+          :languages => @languages,
+          :rights => @rights,
+          :drm_protected => @drm_protected,
+          :cover => @cover,
+          :table_of_contents => @table_of_contents
+        }
+      end
+    end
+  end
+end
+

data/lib/epubinfo/models/cover.rb

@@ -0,0 +1,101 @@
+module EPUBInfo
+  module Models
+    class Cover
+      def self.new(parser)
+        return nil unless EPUBInfo::Parser === parser
+
+        cover = super(parser)
+
+        if cover.exists?
+          cover
+        else
+          nil
+        end
+      end
+
+      def initialize(parser)
+        @parser = parser
+        @path   = epub_cover_file_path
+        @content_type = epub_cover_content_type
+      end
+
+      # Original name of cover file
+      # @return [String]
+      def original_file_name
+        File.basename(@path) if @path
+      end
+
+      # Content type of cover file
+      # @return [String]
+      attr_accessor :content_type
+
+      # Cover exists?
+      # @return [Boolean]
+      # @!visibility private
+      def exists?
+        !!@path && @parser.zip_file.find_entry(zip_file_path)
+      end
+
+      # Cover file
+      # @return [File]
+      # Tempfile is used to enable access to cover file
+      # If block is passed, the tempfile is passed to it
+      # and closed after the block is executed
+      #   cover.file do { |f| puts f.size }
+      # Otherwise user is responsible to unlink and close tempfile
+      #   file = book.cover.file
+      #   file.size
+      #   file.close!
+      def tempfile(&block)
+        tempfile = Tempfile.new('epubinfo')
+        tempfile.binmode
+
+        cover_file = @parser.zip_file.read(zip_file_path)
+        tempfile.write(cover_file)
+
+        if block_given?
+          yield tempfile
+          tempfile.close!
+        else
+          # user is responsible for closing file
+          tempfile
+        end
+      end
+
+      private
+
+      def epub_cover_file_path
+        epub_cover_item.attr('href') if epub_cover_item
+      end
+
+      def epub_cover_content_type
+        epub_cover_item.attr('media-type') if epub_cover_item
+      end
+
+      def epub_cover_item
+        @epub_cover_item ||= begin
+          metadata = @parser.metadata_document.css('metadata')
+          cover_id = (metadata.css('meta [name=cover]').attr('content').value rescue nil) || 'cover-image'
+
+          manifest = @parser.metadata_document.css('manifest')
+
+          (manifest.css("item [id = \"#{cover_id}\"]").first rescue nil) ||
+            (manifest.css("item [properties = \"#{cover_id}\"]").first rescue nil) ||
+            (manifest.css("item [property = \"#{cover_id}\"]").first rescue nil) ||
+            (manifest.css("item [id = img-bookcover-jpeg]").first rescue nil)
+        end
+      end
+
+      def zip_file_path
+        dir = File.dirname(@parser.metadata_path)
+        path =
+          if dir == '.'
+            @path
+          else
+            File.join(dir, @path)
+          end
+        CGI::unescape(path)
+      end
+    end
+  end
+end

data/lib/epubinfo/models/date.rb

@@ -0,0 +1,34 @@
+require 'time'
+
+module EPUBInfo
+  module Models
+    class Date
+      # Date ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.7 EPUB2 reference})
+      # @return Date
+      attr_accessor :date
+      # Date as a string ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.7 EPUB2 reference})
+      # @return String
+      attr_accessor :date_str
+      # Event ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.7 EPUB2 reference})
+      # @return String
+      attr_accessor :event
+
+      # Should never be called directly, go through EPUBInfo.get
+      def initialize(node)
+        self.date = Utils.parse_iso_8601_date(node.content) rescue nil
+        self.date_str = node.content
+        self.event = node.attribute('event').content rescue nil
+      end
+
+      # Returns Hash representation of a date
+      # @return [Hash]
+      def to_hash
+        {
+          :time => @time,
+          :event => @event
+        }
+      end
+    end
+  end
+end
+

data/lib/epubinfo/models/identifier.rb

@@ -0,0 +1,28 @@
+module EPUBInfo
+  module Models
+    class Identifier
+      # Identifier ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.1 EPUB2 reference})
+      # @return [String]
+      attr_accessor :identifier
+      # Scheme ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.1 EPUB2 reference})
+      # @return [String]
+      attr_accessor :scheme
+
+      # Should never be called directly, go through EPUBInfo.get
+      def initialize(node)
+        self.identifier = node.content
+        self.scheme = node.attribute('scheme').content rescue nil
+      end
+
+      # Returns Hash representation of an identifier
+      # @return [Hash]
+      def to_hash
+        {
+          :identifier => @identifier,
+          :scheme => @scheme
+        }
+      end
+    end
+  end
+end
+

data/lib/epubinfo/models/person.rb

@@ -0,0 +1,33 @@
+module EPUBInfo
+  module Models
+    class Person
+      # Name ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.6 EPUB2 reference})
+      # @return [String]
+      attr_accessor :name
+      # File as ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.6 EPUB2 reference})
+      # @return [String]
+      attr_accessor :file_as
+      # Role ({http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.2.6 EPUB2 reference})
+      # @return [String]
+      attr_accessor :role
+
+      # Should never be called directly, go through EPUBInfo.get
+      def initialize(node)
+        self.name = node.content
+        self.file_as = node.attribute('file-as').content rescue nil
+        self.role = node.attribute('role').content rescue nil
+      end
+
+      # Returns Hash representation of a person
+      # @return [Hash]
+      def to_hash
+        {
+          :name => @name,
+          :file_as => @file_as,
+          :role => @role
+        }
+      end
+    end
+  end
+end
+

data/lib/epubinfo/models/table_of_contents/manifest.rb

@@ -0,0 +1,7 @@
+class Manifest
+  def initialize(table_of_contents)
+    @table_of_contents = table_of_contents
+  end
+
+
+end

data/lib/epubinfo/models/table_of_contents/resource.rb

@@ -0,0 +1,120 @@
+require 'uri'
+
+class Resource
+  include Enumerable
+
+  def initialize(table_of_contents)
+    @table_of_contents = table_of_contents
+  end
+
+  def length
+    self.count
+  end
+
+  def first
+    self.to_a.first
+  end
+
+  def last
+    self.to_a.last
+  end
+
+  def [](reference)
+    if reference.is_a?(Integer)
+      return self.to_a[reference]
+    elsif reference.is_a?(Range)
+      return self.to_a[reference]
+    elsif reference.is_a?(Symbol)
+      reference = reference.to_s
+    end
+
+    if reference.is_a?(String)
+      reference_data = self.to_a.map do |r|
+        r[:uri] if r[:id].eql?(reference) || r[:uri].eql?(reference)
+      end.compact
+
+      if reference_data && !reference_data.empty?
+        return @table_of_contents.parser.zip_file.read(reference_data.first)
+      end
+    end
+
+    return self.to_a
+  end
+
+  def each
+    self.to_a.each do |resource|
+      yield resource
+    end
+  end
+
+  def keys
+    @keys ||= self.to_a.map{|r| r[:id]}
+  end
+
+  def types
+    @types ||= self.to_a.map{|r| r[:type]}.uniq
+
+  end
+
+  def spine
+    @spine ||=
+    begin
+      spine_resources = @table_of_contents.spine.first.xpath('./itemref').map { |s| s['idref'] }
+      self.to_a.select {|r| spine_resources.include?(r[:id])}
+    end
+  end
+
+  def images
+    @images ||= self.to_a.select {|r| r[:type] =~ /image/}
+  end
+
+  def videos
+    @videos ||= self.to_a.select {|r| r[:type] =~ /video/}
+  end
+
+  def fonts
+    @fonts ||= self.to_a.select {|r| r[:type] =~ /font/}
+  end
+
+  def javascripts
+    @js ||= self.to_a.select {|r| r[:type] =~ /text\/javascript/}
+  end
+
+  def css
+    @css ||= self.to_a.select {|r| r[:type] =~ /text\/css/}
+  end
+
+  def to_a
+    @resources ||=
+        begin
+          resources = []
+          @table_of_contents.manifest.xpath('//item').each do |resource|
+            if resource
+              id = resource.attr('id')
+              uri = URI.decode(resource.attr('href'))
+              mime_type = resource.attr('media-type')
+              label = ''
+              uri_ref = ''
+              order = ''
+
+              nav_point = @table_of_contents.document.xpath("//navPoint[starts-with(content/@src,'#{uri}')]").first
+              if nav_point
+                label = nav_point.at('navLabel text').content || ''
+                uri_ref = nav_point.at('content').attr('src') || ''
+                order = nav_point.attr('playOrder') || ''
+              end
+
+              #TODO:make this an OpenStruct
+              resources << {:id => id,
+                            :uri => @table_of_contents.parser.zip_file.entries.map { |p| p.name }.select { |s| s.match(uri) }.first,
+                            :uri_ref => uri_ref,
+                            :text => label,
+                            :type => mime_type,
+                            :order => order}
+            end
+          end
+
+          resources
+        end
+  end
+end

data/lib/epubinfo/models/table_of_contents.rb

@@ -0,0 +1,55 @@
+require 'epubinfo/models/table_of_contents/resource'
+
+module EPUBInfo
+  module Models
+    class TableOfContents
+      def initialize(parser)
+        document = parser.metadata_document
+        document_type = parser.metadata_type
+
+        return if document.nil? || !document_type.eql?("application/oebps-package+xml")
+        document.remove_namespaces!
+        metadata = document.css('metadata')
+        self.spine = metadata.xpath('//spine')
+        self.manifest = metadata.xpath('//manifest')
+        self.parser = parser
+      end
+
+
+      def type
+        spine.first.attr('toc')
+      end
+
+      def resources
+        @resources ||= Resource.new(self)
+      end
+
+      def document
+        @toc_document ||= load_toc_file.remove_namespaces!
+      end
+
+      def path
+        @toc_path ||= begin
+          spine_path = nil
+          if spine && !spine.empty?
+            toc_id = spine[0]['toc']
+            toc_ncx = manifest.xpath("item[@id = '#{toc_id}']").first.attr('href')
+            spine_path = parser.zip_file.entries.map { |p| p.name }.select { |s| s.match(toc_ncx) }.first
+          end
+          spine_path
+        end
+
+      end
+
+      attr_accessor :manifest
+      attr_accessor :parser
+      attr_accessor :spine
+
+      private
+      def load_toc_file
+        Nokogiri::XML(parser.zip_file.read(path))
+      end
+
+    end
+  end
+end

data/lib/epubinfo/parser.rb

@@ -0,0 +1,55 @@
+module EPUBInfo
+  class Parser
+    attr_accessor :path, :metadata_document
+
+    def self.parse(path_io)
+      epubinfo = EPUBInfo::Parser.new
+      epubinfo.path =  path_io.is_a?(IO) ? path_io.path : path_io
+      epubinfo
+    end
+
+    def metadata_document
+      @metadata_document ||= load_metadata_file
+    end
+
+    def drm_protected?
+      @drm_protected ||= !!zip_file.find_entry('META-INF/rights.xml')
+    end
+
+    def zip_file
+      begin
+        @zip_file ||= Zip::File.open(@path)
+      rescue Zip::ZipError => e
+        raise NotAnEPUBFileError.new(e)
+      end
+    end
+
+    def metadata_path
+      @metadata_path ||= begin
+        root_document.remove_namespaces!
+        root_document.css('container rootfiles rootfile:first-child').attribute('full-path').content
+      end
+    end
+
+    def metadata_type
+      @metadata_type ||= begin
+        root_document.remove_namespaces!
+        root_document.css('container rootfiles rootfile:first-child').attribute('media-type').content
+      end
+    end
+
+    private
+
+    def root_document
+      begin
+        @root_document ||= Nokogiri::XML(zip_file.read('META-INF/container.xml'))
+      rescue => e
+        raise NotAnEPUBFileError.new(e)
+      end
+    end
+
+    def load_metadata_file
+      Nokogiri::XML(zip_file.read(metadata_path))
+    end
+  end
+end

data/lib/epubinfo/utils.rb

@@ -0,0 +1,17 @@
+module EPUBInfo
+  module Utils
+    def self.parse_iso_8601_date(date_str)
+      case date_str.count('-')
+      when 0
+        Date.strptime(date_str, '%Y')
+      when 1
+        Date.strptime(date_str, '%Y-%m')
+      when 2
+        Date.strptime(date_str, '%Y-%m-%d')
+      end
+    end
+  end
+
+  class NotAnEPUBFileError < StandardError; end
+end
+

data/lib/epubinfo.rb

@@ -0,0 +1,21 @@
+require 'zip'
+require 'nokogiri'
+require 'cgi'
+
+require 'epubinfo/parser'
+require 'epubinfo/models/book'
+require 'epubinfo/models/cover'
+require 'epubinfo/models/person'
+require 'epubinfo/models/date'
+require 'epubinfo/models/identifier'
+require 'epubinfo/models/table_of_contents'
+require 'epubinfo/utils'
+
+module EPUBInfo
+  # Parses an epub file and returns a Book instance.
+  # @return [EPUBInfo::Models::Book] a model representation of the epub file
+  def self.get(path)
+    parser = EPUBInfo::Parser.parse(path)
+    EPUBInfo::Models::Book.new(parser)
+  end
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: epubinfo_with_toc
+version: !ruby/object:Gem::Version
+  version: 0.4.5
+platform: ruby
+authors:
+- Christof Dorner
+- Mehmet Celik
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.4.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Supports EPUB2 and EPUB3 formats.
+email: christof@chdorner.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- lib/epubinfo.rb
+- lib/epubinfo/models/book.rb
+- lib/epubinfo/models/cover.rb
+- lib/epubinfo/models/date.rb
+- lib/epubinfo/models/identifier.rb
+- lib/epubinfo/models/person.rb
+- lib/epubinfo/models/table_of_contents.rb
+- lib/epubinfo/models/table_of_contents/manifest.rb
+- lib/epubinfo/models/table_of_contents/resource.rb
+- lib/epubinfo/parser.rb
+- lib/epubinfo/utils.rb
+- LICENSE.txt
+- README.md
+homepage: https://github.com/mehmetc/epubinfo/tree/table_of_contents
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: Extracts metadata information from EPUB files
+test_files: []
+has_rdoc: