rss-opds 0.0.1 → 0.0.2

data/Gemfile

@@ -1,4 +1,2 @@
 source 'https://rubygems.org'
-
-# Specify your gem's dependencies in rss-opds.gemspec
 gemspec

data/README.markdown

@@ -2,7 +2,7 @@ RSS::OPDS
 =========
 
 [OPDS][opds] parser and maker.
-OPDS(Open Publication Distribution System) is feed
+OPDS(Open Publication Distribution System) is feed which syndicates information about ebooks.
 
 [opds]:http://opds-spec.org/specs/opds-catalog-1-1
 
@@ -26,15 +26,74 @@ Or install it yourself as:
 Usage
 -----
 
+### Parsing OPDS
+
     require 'open-uri'
     require 'rss/opds'
     
     opds = RSS::Parser.parse open(uri)
     opds.entries.each do |entry|
-     price_elem = entry.links.select {|link| link.opds_price}.first
-     puts price_elem
+      price_elem = entry.links.select {|link| link.opds_price}.first
+      puts price_elem
     end
 
+If you need performance, install [rss-nokogiri][rss-nokogiri] gem and write `require 'rss/nokogiri'`
+before calling `RSS::Parser.parse`.
+
+[rss-nokogiri]: https://rubygems.org/gems/rss-nokogiri
+
+### Making OPDS
+
+You may make OPDS feeds as well as normal Atom feeds.
+
+    require 'rss/opds'
+    
+    recent = RSS::Maker.make('atom') do |maker|
+      maker.channel.about = 'http://example.net/'
+      maker.channel.title = 'Example New Catalog'
+      maker.channel.description = 'New books in this site'
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/new.opds'
+        link.rel = 'self'
+        link.type = RSS::OPDS::TYPES['acquisition']
+      end
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/root.opds'
+        link.rel = RSS::OPDS::RELATIONS['start']
+        link.type = RSS::OPDS::TYPES['navigation']
+      end
+      maker.channel.updated = '2012-08-14T04:23:00'
+      maker.channel.author = 'KITAITI Makoto'
+    
+      new_books.each do |book|
+        maker.items.new_item do |entry|
+          entry.title = book.title
+          entry.updated = book.updated
+          entry.summary = book.summary
+          entry.link = book.link
+        end
+      end
+    end
+    puts recent # => output OPDS feed
+
+And now, this library provides utility methods which help you make OPDS navigation feeds.
+
+    root = RSS::Maker.make('atom') {|maker|
+      maker.channel.about = ...
+    
+      maker.items.add_relation recent, RSS::OPDS::RELATIONS['new']
+      # or just:
+      # maker.items.add_new recent
+      # 
+      # these are equivalent to:
+      # maker.items.new_item do |item|
+      #   item.id = recent.id
+      #   item.title = recent.title
+      #   # ...
+      # end
+    }
+    puts root # => output XML including entry with 'new' sorting relation
+
 Contributing
 ------------
 
@@ -47,10 +106,10 @@ Contributing
 Development Plan
 ----------------
 
-1. Parser for OPDS catalogs
+1. Parser for OPDS catalogs[DONE]
 2. Validation as OPDS
 3. Utility methods like, for example, `#buy`(gets `link` element with `rel="acquisition/buy"`), `#price`(`opds:price` element) and so on
-4. Maker for OPDS feeds and entries
+4. Maker for OPDS feeds and entries[DONE]
 
 References
 ----------

data/Rakefile

@@ -1,2 +1,10 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
+require 'rake/clean'
+require 'rake/testtask'
+require 'yard'
+
+task :default => :test
+
+Rake::TestTask.new
+YARD::Rake::YardocTask.new

data/examples/make-catalog.rb

@@ -0,0 +1,138 @@
+require 'rss'
+require 'rss/opds'
+require 'rss/maker/opds'
+
+Book = Struct.new 'Book',
+                  :title, :author, :summary, :updated, :link, :popularity
+
+def main
+  puts root
+  puts popular
+  puts recent
+end
+
+def root
+  RSS::Maker.make('atom') {|maker|
+    maker.channel.about = 'http://example.net/'
+    maker.channel.title = 'Example Catalog Root'
+    maker.channel.description = 'Sample OPDS'
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/root.opds'
+      link.rel = RSS::OPDS::RELATIONS['self']
+      link.type = RSS::OPDS::TYPES['navigation']
+    end
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/root.opds'
+      link.rel = RSS::OPDS::RELATIONS['start']
+      link.type = RSS::OPDS::TYPES['navigation']
+    end
+    maker.channel.updated = '2012-08-14T04:23:00'
+    maker.channel.author = 'KITAITI Makoto'
+
+    maker.items.new_item do |entry|
+      entry.links.new_link do |link|
+        link.href = 'http://example.net/popular.opds'
+        link.rel = RSS::OPDS::RELATIONS['popular']
+        link.type = RSS::OPDS::TYPES['acquisition']
+      end
+      entry.title = 'Example Popular Books'
+      entry.updated = '2012-07-31T00:00:00'
+      entry.summary = 'Popular books in this site'
+    end
+    maker.items.new_item do |entry|
+      entry.links.new_link do |link|
+        link.href = 'http://example.net/new.opds'
+        link.rel = RSS::OPDS::RELATIONS['new']
+        link.type = RSS::OPDS::TYPES['acquisition']
+      end
+      entry.title = 'Example New Books'
+      entry.updated = '2012-08-14T04:23:00'
+      entry.summary = 'New books in this site'
+    end
+  }
+end
+
+def popular
+  RSS::Maker.make('atom') do |maker|
+    maker.channel.about = 'http://example.net/'
+    maker.channel.title = 'Example Popular Catalog'
+    maker.channel.description = 'Popular books in this site'
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/popular.opds'
+      link.rel = RSS::OPDS::RELATIONS['self']
+      link.type = RSS::OPDS::TYPES['acquisition']
+    end
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/root.opds'
+      link.rel = RSS::OPDS::RELATIONS['start']
+      link.type = RSS::OPDS::TYPES['navigation']
+    end
+    maker.channel.updated = '2012-07-31T00:00:00'
+    maker.channel.author = 'KITAITI Makoto'
+
+    popular_books.each do |book|
+      maker.items.new_item do |entry|
+        entry.title = book.title
+        entry.updated = book.updated
+        entry.summary = book.summary
+        entry.link = book.link
+      end
+    end
+  end
+end
+
+def recent
+  RSS::Maker.make('atom') do |maker|
+    maker.channel.about = 'http://example.net/'
+    maker.channel.title = 'Example New Catalog'
+    maker.channel.description = 'New books in this site'
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/new.opds'
+      link.rel = 'self'
+      link.type = RSS::OPDS::TYPES['acquisition']
+    end
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/root.opds'
+      link.rel = RSS::OPDS::RELATIONS['start']
+      link.type = RSS::OPDS::TYPES['navigation']
+    end
+    maker.channel.updated = '2012-08-14T04:23:00'
+    maker.channel.author = 'KITAITI Makoto'
+
+    new_books.each do |book|
+      maker.items.new_item do |entry|
+        entry.title = book.title
+        entry.updated = book.updated
+        entry.summary = book.summary
+
+        entry.links.new_link do |link|
+          link.href = book.link
+          link.opds_prices.new_opds_price do |price|
+            price.value = 100
+            price.currencycode = 'JPY'
+          end
+        end
+      end
+    end
+  end
+end
+
+def books
+  [
+   Book.new('book1', 'author1', 'summary1', Time.gm(2012, 8, 14, 3), 'http://example.net/book/book1', 1),
+   Book.new('book2', 'author2', 'summary2', Time.gm(2012, 8, 10, 14), 'http://example.net/book/book2', 2),
+   Book.new('book3', 'author3', 'summary3', Time.gm(2012, 6, 30, 12), 'http://example.net/book/book3', 3)
+  ]
+end
+
+def popular_books
+  books.sort_by {|book| book.popularity}.reverse_each
+end
+
+def new_books
+  books.sort_by {|book| book.updated}.reverse_each
+end
+
+if $0 == __FILE__
+  main
+end

data/lib/rss/maker/opds.rb

@@ -0,0 +1,83 @@
+require 'rss/maker'
+require 'rss/opds'
+
+module RSS
+  module Maker
+    module Atom
+      class Feed < RSSBase
+        class Items < ItemsBase
+          class Item < ItemBase
+            class Links < LinksBase
+              class Link < LinkBase
+                %w[facetGroup activeFacet].each do |attr|
+                  def_other_element attr
+                end
+                def_classed_elements 'opds_price', 'value', 'Prices'
+
+                # @note Defined to prevent NoMethodError
+                def setup_opds_prices(feed, current)
+                end
+
+                # @note Should provide this method as the one of a module
+                def to_feed(feed, current)
+                  super # AtomLink#to_feed
+                  opds_prices.to_feed(feed, current.links.last)
+                end
+
+                class Prices < Base
+                  def_array_element 'opds_price', nil, 'Price'
+
+                  class Price < Base
+                    %w[value currencycode].each do |attr|
+                      attr_accessor attr
+                    end
+
+                    def to_feed(feed, current)
+                      price = ::RSS::OPDS::Price.new
+                      price.value = value
+                      price.currencycode = currencycode
+                      current.opds_prices << price
+                      set_parent price, current
+                      setup_other_elements(feed)
+                    end
+
+                    private
+
+                    def required_variable_names
+                      %w[currencycode]
+                    end
+                  end
+                end
+              end
+            end
+          end
+
+          def add_relation(feed, relation, href=nil)
+            self_link = maker.channel.links.find {|link| link.rel == RSS::OPDS::RELATIONS['self']}
+            is_navigation_feed = self_link && self_link.type == RSS::OPDS::TYPES['navigation']
+            raise TypeError, 'Only navigatfion feed can accept feed' unless is_navigation_feed
+            raise ArgumentError, 'Only acquisition feed can be accepted' unless feed.acquisition_feed?
+            new_item do |entry|
+              [:id, :title, :dc_description, :updated].each do |attr|
+                val = feed.__send__(attr)
+                entry.__send__("#{attr}=", val.content) if val
+              end
+              entry.links.new_link do |link|
+                href = feed.links.find {|ln| ln.rel == RSS::OPDS::RELATIONS['self']}.href unless href
+                link.href = href
+                link.rel = relation
+                link.type = RSS::OPDS::TYPES['acquisition']
+              end
+            end
+          end
+
+          ::RSS::OPDS::CATALOG_RELATIONS.each_pair do |type, uri|
+            define_method "add_#{type}" do |feed, href=nil|
+              add_relation feed, uri, href
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rss/opds.rb

@@ -5,13 +5,13 @@ require 'rss/opds/version'
 
 module RSS
   module Utils
-    module TrueOther
+    module TrueNil
       module_function
       def parse(value)
         if value === true
           value
         else
-          /\Atrue\z/i.match(value.to_s) ? true : false
+          /\Atrue\z/i.match(value.to_s) ? true : nil
         end
       end
     end
@@ -19,22 +19,23 @@ module RSS
 
   module BaseModel
     private
-    def true_other_attr_reader(*attrs)
+
+    def true_nil_attr_reader(*attrs)
       attrs.each do |attr|
         attr = attr.id2name if attr.kind_of?(Integer)
         module_eval(<<-EOC, __FILE__, __LINE__ + 1)
           attr_reader(:#{attr})
           def #{attr}?
-            TrueOther.parse(@#{attr})
+            TrueNil.parse(@#{attr})
           end
         EOC
       end
     end
 
-    def true_other_writer(name, disp_name=name)
+    def true_nil_writer(name, disp_name=name)
       module_eval(<<-EOC, __FILE__, __LINE__ + 1)
         def #{name}=(new_value)
-          new_value = 'true' if new_value === true
+          new_value = [true, 'true'].include?(new_value) ? 'true' : nil
           @#{name} = new_value
         end
       EOC
@@ -46,8 +47,9 @@ module RSS
       alias rss_def_corresponded_attr_writer def_corresponded_attr_writer
       def def_corresponded_attr_writer(name, type=nil, disp_name=nil)
         disp_name ||= name
-        if type == :true_other
-          true_other_writer name, disp_name
+        case type
+        when :true_nil
+          true_nil_writer name, disp_name
         else
           rss_def_corresponded_attr_writer name, type, disp_name
         end
@@ -55,8 +57,9 @@ module RSS
 
       alias rss_def_corresponded_attr_reader def_corresponded_attr_reader
       def def_corresponded_attr_reader(name, type=nil)
-        if type == :true_other
-          true_other_attr_reader name, type
+        case type
+        when :true_nil
+          true_nil_attr_reader name, type
         else
           rss_def_corresponded_attr_reader name, type
         end
@@ -71,14 +74,102 @@ module RSS
       'navigation' => 'application/atom+xml;profile=opds-catalog;kind=navigation',
       'acquisition' => 'application/atom+xml;profile=opds-catalog;kind=acquisition'
     }
+    REGISTERED_RELATIONS = %w[
+      alternate
+      appendix
+      archives
+      author
+      bookmark
+      canonical
+      chapter
+      collection
+      contents
+      copyright
+      current
+      describedby
+      disclosure
+      duplicate
+      edit
+      edit-media
+      enclosure
+      first
+      glossary
+      help
+      hosts
+      hub
+      icon
+      index
+      item
+      last
+      latest-version
+      license
+      lrdd
+      monitor
+      monitor-group
+      next
+      next-archive
+      nofollow
+      noreferrer
+      payment
+      predecessor-version
+      prefetch
+      prev
+      previous
+      prev-archive
+      related
+      replies
+      search
+      section
+      self
+      service
+      start
+      stylesheet
+      subsection
+      successor-version
+      tag
+      up
+      version-history
+      via
+      working-copy
+      working-copy-of
+    ].reduce({}) {|relations, relation|
+      relations[relation] = relation
+      relations
+    }
+    CATALOG_RELATIONS = {
+      'start'         => 'start',
+      'subsection'    => 'subsection',
+      'new'           => 'http://opds-spec.org/sort/new',
+      'popular'       => 'http://opds-spec.org/sort/popular',
+      'featured'      => 'http://opds-spec.org/featured',
+      'recommended'   => 'http://opds-spec.org/recommended',
+      'shelf'         => 'http://opds-spec.org/shelf',
+      'subscriptions' => 'http://opds-spec.org/subscriptions',
+      'facet'         => 'http://opds-spec.org/facet',
+      'crawlable'     => 'http://opds-spec.org/crawlable'
+    }
+    ENTRY_RELATIONS = {
+      'acquisition' => 'http://opds-spec.org/acquisition',
+      'open-access' => 'http://opds-spec.org/acquisition/open-access',
+      'borrow'      => 'http://opds-spec.org/acquisition/borrow',
+      'buy'         => 'http://opds-spec.org/acquisition/buy',
+      'sample'      => 'http://opds-spec.org/acquisition/sample',
+      'subscribe'   => 'http://opds-spec.org/acquisition/subscribe',
+      'image'       => 'http://opds-spec.org/image',
+      'thumbnail'   => 'http://opds-spec.org/image/thumbnail'
+    }
+    RELATIONS = Hash.new {|h, k|
+      ENTRY_RELATIONS[k] or CATALOG_RELATIONS[k] or REGISTERED_RELATIONS[k] or
+        raise KeyError, "Unsupported relation type: #{k.inspect}"
+    }
 
     class Price < Element
       include Atom::CommonModel
-      include Atom::ContentModel
 
       install_ns(PREFIX, URI)
       install_must_call_validator('opds', URI)
       install_get_attribute('currencycode', '')
+      attr_accessor :value
 
       class << self
         def required_prefix
@@ -99,9 +190,6 @@ module RSS
       def full_name
         tag_name_with_prefix(PREFIX)
       end
-
-      alias value content
-      alias value= content=
     end
 
     BaseListener.install_class_name(URI, 'price', 'Price')
@@ -121,22 +209,24 @@ module RSS
         end
       end
 
-      class Link
+      class Link < Element
         [
          ['facetGroup', nil],
-         ['activeFacet', [:true_other, :true_other]]
+         ['activeFacet', [:true_nil, :true_nil]]
         ].each do |name, type|
           disp_name = "#{OPDS::PREFIX}:#{name}"
           install_get_attribute(name, OPDS::URI, false, type, nil, disp_name)
           alias_method to_attr_name(name), name
           alias_method "#{to_attr_name(name)}=", "#{name}="
         end
+
+        Price = OPDS::Price
+        install_have_children_element 'opds_price', OPDS::URI, '*'
       end
 
       class Entry
-        class Link
-          Price = OPDS::Price
-          install_have_children_element 'price', OPDS::URI, '*', 'opds_price'
+        def price
+          links.find {|link| link.opds_price}.opds_price
         end
       end
     end

data/lib/rss/opds/version.rb

@@ -1,5 +1,5 @@
 module RSS
   module OPDS
-    VERSION = "0.0.1"
+    VERSION = "0.0.2"
   end
 end

data/rss-opds.gemspec

@@ -6,7 +6,8 @@ Gem::Specification.new do |gem|
   gem.email         = ["KitaitiMakoto@gmail.com"]
   gem.description   = %q{OPDS parser and maker}
   gem.summary       = %q{This gem extends Ruby bundled RSS library to parse and make OPDS catalogs}
-  gem.homepage      = ""
+  gem.homepage      = "http://rss-ext.rubyforge.org/"
+  gem.rubyforge_project = "http://rss-ext.rubyforge.org/"
 
   gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   gem.files         = `git ls-files`.split("\n")
@@ -15,11 +16,14 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.version       = RSS::OPDS::VERSION
 
+  gem.add_runtime_dependency 'rss-dcterms'
+  gem.add_runtime_dependency 'rss-atom-feed_history'
+  gem.add_runtime_dependency 'money'
+
   gem.add_development_dependency 'test-unit'
   gem.add_development_dependency 'simplecov'
   gem.add_development_dependency 'yard'
+  gem.add_development_dependency 'redcarpet'
   gem.add_development_dependency 'pry'
-
-  gem.add_runtime_dependency 'rss-dcterms'
-  gem.add_runtime_dependency 'rss-atom-feed_history'
+  gem.add_development_dependency 'pry-doc'
 end

data/test/helper.rb

@@ -0,0 +1,19 @@
+require 'simplecov'
+SimpleCov.start do
+  add_filter '/test|vendor/'
+end
+
+require 'rss/opds'
+require 'test/unit'
+require 'pathname'
+require 'rexml/document'
+
+class TestOPDS < Test::Unit::TestCase
+  def setup
+    @fixtures_dir = Pathname(__FILE__).dirname.expand_path + 'fixtures'
+  end
+end
+
+Book = Struct.new 'Book',
+                  :title, :author, :summary, :updated, :link, :popularity
+

data/test/test_maker.rb

@@ -0,0 +1,227 @@
+require_relative 'helper'
+require 'rss/maker/opds'
+
+class TestMaker < TestOPDS
+  def test_set_price
+    feed = RSS::Maker.make('atom') {|maker|
+      %w[id author title].each do |property|
+        maker.channel.send "#{property}=", property
+      end
+      maker.channel.updated = Time.now
+
+      maker.items.new_item do |entry|
+        entry.id = 'entry id'
+        entry.title = 'entry title'
+        entry.author = 'entry author'
+        entry.updated = Time.now
+
+        entry.links.new_link do |link|
+          link.href = 'uri/to/purchase'
+          link.opds_prices.new_opds_price do |price|
+            price.value = 100
+            price.currencycode = 'JPY'
+          end
+        end
+      end
+    }
+    doc = REXML::Document.new(feed.to_s)
+    assert_not_empty REXML::XPath.match(doc, "//*[namespace-uri()='http://opds-spec.org/2010/catalog']")
+  end
+
+  def test_set_active_facet
+    feed = RSS::Maker.make('atom') {|maker|
+      %w[id author title].each do |property|
+        maker.channel.send "#{property}=", property
+      end
+      maker.channel.updated = Time.now
+
+      maker.items.new_item do |entry|
+        entry.id = 'entry id'
+        entry.title = 'entry title'
+        entry.author = 'entry author'
+        entry.updated = Time.now
+
+        entry.links.new_link do |link|
+          link.href = 'uri/to/facet'
+          link.activeFacet = true
+        end
+      end
+    }
+    doc = REXML::Document.new(feed.to_s)
+    links = REXML::XPath.match(doc, "//[@opds:activeFacet]")
+    assert_not_empty links
+    assert_equal 'true', links.first.attributes['opds:activeFacet']
+  end
+
+  def test_set_inactive_facet
+    feed = RSS::Maker.make('atom') {|maker|
+      %w[id author title].each do |property|
+        maker.channel.send "#{property}=", property
+      end
+      maker.channel.updated = Time.now
+
+      maker.items.new_item do |entry|
+        entry.id = 'entry id'
+        entry.title = 'entry title'
+        entry.author = 'entry author'
+        entry.updated = Time.now
+
+        entry.links.new_link do |link|
+          link.href = 'uri/to/facet'
+          link.activeFacet = false
+        end
+      end
+    }
+    doc = REXML::Document.new(feed.to_s)
+    assert_empty REXML::XPath.match(doc, "//[@opds:activeFacet]")
+  end
+
+  def test_navigation_feed_accepts_aqcuisition_feed_as_item
+    catalog_root = nil
+    assert_nothing_raised do
+      catalog_root = RSS::Maker.make('atom') {|maker|
+        maker.channel.about = 'http://example.net/'
+        maker.channel.title = 'Example Catalog Root'
+        maker.channel.description = 'Sample OPDS'
+        maker.channel.links.new_link do |link|
+          link.href = 'http://example.net/root.opds'
+          link.rel = RSS::OPDS::RELATIONS['self']
+          link.type = RSS::OPDS::TYPES['navigation']
+        end
+        maker.channel.links.new_link do |link|
+          link.href = 'http://example.net/root.opds'
+          link.rel = RSS::OPDS::RELATIONS['start']
+          link.type = RSS::OPDS::TYPES['navigation']
+        end
+        maker.channel.updated = '2012-08-14T05:30:00'
+        maker.channel.author = 'KITAITI Makoto'
+
+        maker.items.add_relation recent, RSS::OPDS::RELATIONS['new']
+        maker.items.add_popular popular
+      }
+    end
+    doc = REXML::Document.new(catalog_root.to_s)
+    links = REXML::XPath.match(doc, "/feed/entry/link")
+    assert_equal 'http://opds-spec.org/sort/new', links.first.attributes['rel']
+    assert_equal 'http://opds-spec.org/sort/popular', links[1].attributes['rel']
+  end
+
+  def test_utility_to_add_entry_relations
+    pend
+  end
+
+  def root
+    RSS::Maker.make('atom') {|maker|
+      maker.channel.about = 'http://example.net/'
+      maker.channel.title = 'Example Catalog Root'
+      maker.channel.description = 'Sample OPDS'
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/root.opds'
+        link.rel = RSS::OPDS::RELATIONS['self']
+        link.type = RSS::OPDS::TYPES['navigation']
+      end
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/root.opds'
+        link.rel = RSS::OPDS::RELATIONS['start']
+        link.type = RSS::OPDS::TYPES['navigation']
+      end
+      maker.channel.updated = '2012-08-14T04:23:00'
+      maker.channel.author = 'KITAITI Makoto'
+
+      maker.items.new_item do |entry|
+        entry.links.new_link do |link|
+          link.href = 'http://example.net/popular.opds'
+          link.rel = RSS::OPDS::RELATIONS['popular']
+          link.type = RSS::OPDS::TYPES['acquisition']
+        end
+        entry.title = 'Example Popular Books'
+        entry.updated = '2012-07-31T00:00:00'
+        entry.summary = 'Popular books in this site'
+      end
+      maker.items.new_item do |entry|
+        entry.links.new_link do |link|
+          link.href = 'http://example.net/new.opds'
+          link.rel = RSS::OPDS::RELATIONS['new']
+          link.type = RSS::OPDS::TYPES['acquisition']
+        end
+        entry.title = 'Example New Books'
+        entry.updated = '2012-08-14T04:23:00'
+        entry.summary = 'New books in this site'
+      end
+    }
+  end
+
+  def popular
+    RSS::Maker.make('atom') do |maker|
+      maker.channel.about = 'http://example.net/'
+      maker.channel.title = 'Example Popular Catalog'
+      maker.channel.description = 'Popular books in this site'
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/popular.opds'
+        link.rel = RSS::OPDS::RELATIONS['self']
+        link.type = RSS::OPDS::TYPES['acquisition']
+      end
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/root.opds'
+        link.rel = RSS::OPDS::RELATIONS['start']
+        link.type = RSS::OPDS::TYPES['navigation']
+      end
+      maker.channel.updated = '2012-07-31T00:00:00'
+      maker.channel.author = 'KITAITI Makoto'
+
+      popular_books.each do |book|
+        maker.items.new_item do |entry|
+          entry.title = book.title
+          entry.updated = book.updated
+          entry.summary = book.summary
+          entry.link = book.link
+        end
+      end
+    end
+  end
+
+  def recent
+    RSS::Maker.make('atom') do |maker|
+      maker.channel.about = 'http://example.net/'
+      maker.channel.title = 'Example New Catalog'
+      maker.channel.description = 'New books in this site'
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/new.opds'
+        link.rel = 'self'
+        link.type = RSS::OPDS::TYPES['acquisition']
+      end
+      maker.channel.links.new_link do |link|
+        link.href = 'http://example.net/root.opds'
+        link.rel = RSS::OPDS::RELATIONS['start']
+        link.type = RSS::OPDS::TYPES['navigation']
+      end
+      maker.channel.updated = '2012-08-14T04:23:00'
+      maker.channel.author = 'KITAITI Makoto'
+
+      new_books.each do |book|
+        maker.items.new_item do |entry|
+          entry.title = book.title
+          entry.updated = book.updated
+          entry.summary = book.summary
+          entry.link = book.link
+        end
+      end
+    end
+  end
+
+  def books
+    [
+     Book.new('book1', 'author1', 'summary1', Time.gm(2012, 8, 14, 3), 'http://example.net/book/book1', 1),
+     Book.new('book2', 'author2', 'summary2', Time.gm(2012, 8, 10, 14), 'http://example.net/book/book2', 2),
+     Book.new('book3', 'author3', 'summary3', Time.gm(2012, 6, 30, 12), 'http://example.net/book/book3', 3)
+    ]
+  end
+
+  def popular_books
+    books.sort_by {|book| book.popularity}.reverse_each
+  end
+
+  def new_books
+    books.sort_by {|book| book.updated}.reverse_each
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rss-opds
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,44 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-06 00:00:00.000000000Z
+date: 2012-10-20 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rss-dcterms
+  requirement: &11264540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11264540
+- !ruby/object:Gem::Dependency
+  name: rss-atom-feed_history
+  requirement: &11264060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11264060
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: &11263600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11263600
 - !ruby/object:Gem::Dependency
   name: test-unit
-  requirement: &6367980 !ruby/object:Gem::Requirement
+  requirement: &11263060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *6367980
+  version_requirements: *11263060
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &6383140 !ruby/object:Gem::Requirement
+  requirement: &11262540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *6383140
+  version_requirements: *11262540
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &6382160 !ruby/object:Gem::Requirement
+  requirement: &11262100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *6382160
+  version_requirements: *11262100
 - !ruby/object:Gem::Dependency
-  name: pry
-  requirement: &6381280 !ruby/object:Gem::Requirement
+  name: redcarpet
+  requirement: &11261600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,29 +87,29 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *6381280
+  version_requirements: *11261600
 - !ruby/object:Gem::Dependency
-  name: rss-dcterms
-  requirement: &6380580 !ruby/object:Gem::Requirement
+  name: pry
+  requirement: &11261140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
-  version_requirements: *6380580
+  version_requirements: *11261140
 - !ruby/object:Gem::Dependency
-  name: rss-atom-feed_history
-  requirement: &6379920 !ruby/object:Gem::Requirement
+  name: pry-doc
+  requirement: &11260700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
-  version_requirements: *6379920
+  version_requirements: *11260700
 description: OPDS parser and maker
 email:
 - KitaitiMakoto@gmail.com
@@ -89,11 +122,15 @@ files:
 - LICENSE
 - README.markdown
 - Rakefile
+- examples/make-catalog.rb
+- lib/rss/maker/opds.rb
 - lib/rss/opds.rb
 - lib/rss/opds/version.rb
 - rss-opds.gemspec
 - setup.rb
-homepage: ''
+- test/helper.rb
+- test/test_maker.rb
+homepage: http://rss-ext.rubyforge.org/
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -107,7 +144,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2402742248161802058
+      hash: -1275098366759959895
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -116,9 +153,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2402742248161802058
+      hash: -1275098366759959895
 requirements: []
-rubyforge_project: 
+rubyforge_project: http://rss-ext.rubyforge.org/
 rubygems_version: 1.8.8
 signing_key: 
 specification_version: 3