rss-opds 0.0.2 → 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '09d755c74c4f44e54bd8a8c4edb7109f2afde6cb15678dc4d5150e24209def54'
+  data.tar.gz: aa8f11cc5bdb0f6146c2f77af3197f0bdde028f0b8fbae9cb5b17be43d0e9dd9
+SHA512:
+  metadata.gz: 82345f798acbb3e5baa066c3c48db0679ce8ff40fffbd51423aa80d6949e1729aee996f6be058beadc53278209d32f234ed15c035672374330e9e0c56021da58
+  data.tar.gz: df102e1fa2609affe6c4be21209785fc739f6c8772bb896ef32d42f072d65c382ff8c3d50c81808bcb7500748d405b39c048ed87e9b02e56b9fb153edff702ed

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012 KITAITI Makoto
+Copyright (c) 2012, 2013 KITAITI Makoto
 
 MIT License
 

data/README.markdown

@@ -94,6 +94,18 @@ And now, this library provides utility methods which help you make OPDS navigati
     }
     puts root # => output XML including entry with 'new' sorting relation
 
+Examples
+--------
+For more examples, see files in `examples` directory.
+
+Changelog
+---------
+### 0.0.3
+* Add sample script 'examples/build-catalog-from-epub.rb' which build OPDS catalog feed using specified EPUB files
+* Add sample server 'examples/opds_server.ru' for Rack
+* Remove Money from dependencies
+* [BUG FIX]Add element component to XPath
+
 Contributing
 ------------
 

data/examples/build-catalog-from-epub.rb

@@ -0,0 +1,62 @@
+# This is an example that aggregates info from EPUB files and build OPDS catalog feed using them
+# 
+# Usage:
+#   ruby examples/build-catalog-from-epub.rb EPUBFILE
+#   ruby examples/build-catalog-from-epub.rb ~/Documents/Books/*.epub
+
+require 'rss'
+require 'rss/opds'
+require 'rss/maker/opds'
+require 'epub/parser' # You need to exec 'gem install epub-parser' if you don't have it
+
+def main
+  if ARGV.empty?
+    puts "Usage: ruby #{File.basename($0)} EPUBFILE [EPUBFILE ...]"
+    exit 1
+  end
+
+  puts make_catalog(ARGV)
+end
+
+def make_catalog(files)
+  RSS::Maker.make 'atom' do |maker|
+    maker.channel.about = 'http://example.net/'
+    maker.channel.title = 'My EPUB books'
+    maker.channel.description = 'This is an example to make OPDS catalog using RSS::OPDS library'
+    maker.channel.links.new_link do |link|
+      link.href = 'http://example.net/'
+      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/'
+      link.rel = RSS::OPDS::RELATIONS['start']
+      link.type = RSS::OPDS::TYPES['navigation']
+    end
+    maker.channel.author = `whoami`.chomp
+    maker.channel.generator = 'RSS OPDS the Ruby OPDS library'
+    maker.channel.updated = Time.now
+
+    files.sort.each do |file|
+      begin
+        make_entry(file, maker)
+      rescue => error
+        $stderr.puts error
+        $stderr.puts "skip: #{file}"
+      end
+    end
+  end
+end
+
+def make_entry(file, maker)
+  book = EPUB::Parser.parse(file)
+  maker.items.new_item do |entry|
+    entry.id = book.metadata.unique_identifier.content
+    entry.title = book.title
+    entry.summary = book.metadata.description
+    updated = book.metadata.date
+    entry.updated = updated ? updated.content : File.mtime(file)
+  end
+end
+
+main

data/examples/opds_server.ru

@@ -0,0 +1,81 @@
+# Usage
+#   $ DOCUMENT_ROOT=path/to/doc/root rackup examples/opds_server.ru
+#
+# If required gems are not installed, you need exec:
+#   $ gem install rack epub-parser
+require 'pathname'
+require 'rack'
+require 'epub/parser'
+require 'rss/maker/opds'
+
+class OPDSServer
+  OPTIONS = {
+    :title       => 'My EPUB Books',
+    :description => 'This is an example server that serves OPDS includeing information of EPUB files in a directory.',
+    :author      => `whoami`.chomp,
+    :generator   => self.to_s
+  }
+
+  def initialize(dir='.', options={})
+    raise "Document root not given. Usage: DOCUMENT_ROOT=path/to/docroot rackup #{__FILE__}" unless dir
+    @dir = Pathname(dir)
+    raise "Not a directory: #{dir}" unless @dir.directory?
+    @options = OPTIONS.merge(options)
+    $stderr.puts "Providing OPDS for EPUB files in #{@dir}"
+  end
+
+  def call(env)
+    @files = Pathname.glob("#{@dir}/**/*.epub")
+    @last_modified = @files.collect(&:mtime).max
+
+    @request = Rack::Request.new(env)
+    response = Rack::Response.new
+
+    if_modifed_since = env['HTTP_IF_MODIFIED_SINCE']
+    if if_modifed_since and @last_modified.to_s <= Time.httpdate(if_modifed_since).to_s
+      response.status = Rack::Utils.status_code(:not_modified)
+    elsif !@request.head?
+      response.body << make_feed.to_s
+    end
+
+    response['Content-Type'] = RSS::OPDS::TYPES['navigation']
+    response['Last-Modified'] = @last_modified.httpdate
+    response.finish
+  end
+
+  def make_feed
+    RSS::Maker.make('atom') {|maker|
+      maker.channel.about = @options[:about] || @request.url
+      OPTIONS.keys.each do |attr|
+        maker.channel.send "#{attr}=", @options[attr]
+      end
+      maker.channel.updated = @last_modified
+      @files.each do |path|
+        begin
+          book = EPUB::Parser.parse(path)
+          maker.items.new_item do |entry|
+            entry.id = book.unique_identifier.content
+            entry.title = book.title
+            entry.summary = book.description
+            uri_path = path.relative_path_from(@dir)
+            entry.links.new_link do |link|
+              link.rel  = RSS::OPDS::RELATIONS['acquisition']
+              link.href = @request.base_url + '/' + ERB::Util.url_encode(uri_path.to_path)
+              link.type = 'application/epub+zip'
+            end
+            updated = Time.parse(book.date.content) rescue nil
+            entry.updated = updated || path.mtime
+          end
+        rescue => error
+          $stderr.puts error
+          $stderr.puts "Skip: #{path}"
+        end
+      end
+    }
+  end
+end
+
+docroot = ENV['DOCUMENT_ROOT']
+run Rack::Cascade.new(
+  [Rack::File.new(docroot),
+   OPDSServer.new(docroot)])

data/lib/rss/maker/opds.rb

@@ -3,51 +3,63 @@ 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'
+    module OPDS
+      module LinkBase
+        class << self
+          def included(base)
+            super
+            base.class_eval(<<-EOC, __FILE__, __LINE__ + 1)
+              %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 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
+              def to_feed(feed, current)
+                super # AtomLink#to_feed
+                opds_prices.to_feed(feed, current.links.last)
+              end
+            EOC
+          end
+        end
 
-                class Prices < Base
-                  def_array_element 'opds_price', nil, 'Price'
+        class Prices < Base
+          def_array_element 'opds_price', nil, 'Price'
 
-                  class Price < Base
-                    %w[value currencycode].each do |attr|
-                      attr_accessor attr
-                    end
+          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
+            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
+            private
 
-                    def required_variable_names
-                      %w[currencycode]
-                    end
-                  end
-                end
+            def required_variable_names
+              %w[currencycode]
+            end
+          end
+        end
+      end
+    end
+
+    module Atom
+      class Feed < RSSBase
+        class Items < ItemsBase
+          class Item < ItemBase
+            class Links < LinksBase
+              class Link < LinkBase
+                include OPDS::LinkBase
               end
             end
           end
@@ -58,16 +70,42 @@ module RSS
             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|
+              [:id, :title, :dc_description, :updated, :rights].each do |attr|
                 val = feed.__send__(attr)
                 entry.__send__("#{attr}=", val.content) if val
               end
+              [:author, :contributor].each do |attr_name|
+                plural ||= "#{attr_name}s"
+                feed.__send__(plural).each do |val|
+                  entry.__send__(plural).__send__("new_#{attr_name}") do |attr_maker|
+                    [:name, :uri, :email].each do |elem|
+                      attr_val = val.__send__(elem)
+                      attr_maker.__send__("#{elem}=", attr_val)
+                    end
+                  end
+                end
+              end
+              feed.categories.each do |cat|
+                entry.categories.new_category do |cat_maker|
+                  [:term, :scheme, :label].each do |xml_attr|
+                    val = cat.__send__(xml_attr)
+                    cat_maker.__send__("#{xml_attr}=", val)
+                  end
+                end
+              end
+              entry.content.content ||= feed.dc_description || feed.title.content
+
               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']
+                link.title = feed.title.content
+                link.hreflang = feed.lang || feed.dc_language
+                # Skip "length" attribute because it is for "enclosure" relation and maybe feed here doesn't have it.
               end
+
+              entry
             end
           end
 

data/lib/rss/opds.rb

@@ -158,10 +158,7 @@ module RSS
       '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}"
-    }
+    RELATIONS = [REGISTERED_RELATIONS, CATALOG_RELATIONS, ENTRY_RELATIONS].reduce({}) {|merged, relations| merged.merge(relations)}
 
     class Price < Element
       include Atom::CommonModel

data/lib/rss/opds/version.rb

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

data/rss-opds.gemspec

@@ -18,8 +18,8 @@ Gem::Specification.new do |gem|
 
   gem.add_runtime_dependency 'rss-dcterms'
   gem.add_runtime_dependency 'rss-atom-feed_history'
-  gem.add_runtime_dependency 'money'
 
+  gem.add_development_dependency 'rake'
   gem.add_development_dependency 'test-unit'
   gem.add_development_dependency 'simplecov'
   gem.add_development_dependency 'yard'

data/test/fixtures/root.opds

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom"
+  xmlns:dc="http://purl.org/dc/elements/1.1/"
+  xmlns:dcterms="http://purl.org/dc/terms/"
+  xmlns:opds="http://opds-spec.org/2010/catalog">
+  <author>
+    <name>KITAITI Makoto</name>
+  </author>
+  <id>http://example.net/</id>
+  <link href="http://example.net/root.opds"
+    rel="self"
+    type="application/atom+xml;profile=opds-catalog;kind=navigation"/>
+  <link href="http://example.net/root.opds"
+    rel="start"
+    type="application/atom+xml;profile=opds-catalog;kind=navigation"/>
+  <subtitle>Sample OPDS</subtitle>
+  <title>Example Catalog Root</title>
+  <updated>2012-08-14T04:23:00+09:00</updated>
+  <entry>
+    <id>http://example.net/popular.opds</id>
+    <link href="http://example.net/popular.opds"
+      type="application/atom+xml;profile=opds-catalog;kind=acquisition"/>
+    <summary>Popular books in this site</summary>
+    <title>Example Popular Books</title>
+    <updated>2012-07-31T00:00:00+09:00</updated>
+    <dc:date>2012-07-31T00:00:00+09:00</dc:date>
+    <dcterms:date>2012-07-31T00:00:00+09:00</dcterms:date>
+  </entry>
+  <entry>
+    <id>http://example.net/new.opds</id>
+    <link href="http://example.net/new.opds"
+      type="application/atom+xml;profile=opds-catalog;kind=acquisition"/>
+    <summary>New books in this site</summary>
+    <title>Example New Books</title>
+    <updated>2012-08-14T04:23:00+09:00</updated>
+    <dc:date>2012-08-14T04:23:00+09:00</dc:date>
+    <dcterms:date>2012-08-14T04:23:00+09:00</dcterms:date>
+  </entry>
+  <dc:date>2012-08-14T04:23:00+09:00</dc:date>
+  <dcterms:date>2012-08-14T04:23:00+09:00</dcterms:date>
+</feed>

data/test/test_maker.rb

@@ -48,7 +48,7 @@ class TestMaker < TestOPDS
       end
     }
     doc = REXML::Document.new(feed.to_s)
-    links = REXML::XPath.match(doc, "//[@opds:activeFacet]")
+    links = REXML::XPath.match(doc, "//*[@opds:activeFacet]")
     assert_not_empty links
     assert_equal 'true', links.first.attributes['opds:activeFacet']
   end
@@ -73,7 +73,7 @@ class TestMaker < TestOPDS
       end
     }
     doc = REXML::Document.new(feed.to_s)
-    assert_empty REXML::XPath.match(doc, "//[@opds:activeFacet]")
+    assert_empty REXML::XPath.match(doc, "//*[@opds:activeFacet]")
   end
 
   def test_navigation_feed_accepts_aqcuisition_feed_as_item
@@ -106,6 +106,35 @@ class TestMaker < TestOPDS
     assert_equal 'http://opds-spec.org/sort/popular', links[1].attributes['rel']
   end
 
+  def test_add_relation_returns_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'
+
+        entry = maker.items.add_relation recent, RSS::OPDS::RELATIONS['new']
+        entry.content.content = 'Overwritten entry content'
+      }
+    end
+    doc = REXML::Document.new(catalog_root.to_s)
+    links = REXML::XPath.match(doc, "/feed/entry/content")
+    assert_equal 'Overwritten entry content', links.first.text
+  end
+
   def test_utility_to_add_entry_relations
     pend
   end
@@ -183,6 +212,7 @@ class TestMaker < TestOPDS
   def recent
     RSS::Maker.make('atom') do |maker|
       maker.channel.about = 'http://example.net/'
+      maker.channel.language = 'en'
       maker.channel.title = 'Example New Catalog'
       maker.channel.description = 'New books in this site'
       maker.channel.links.new_link do |link|
@@ -197,6 +227,7 @@ class TestMaker < TestOPDS
       end
       maker.channel.updated = '2012-08-14T04:23:00'
       maker.channel.author = 'KITAITI Makoto'
+      maker.channel.rights = 'Copyright (c) 2012, KITAITI Makoto'
 
       new_books.each do |book|
         maker.items.new_item do |entry|

metadata

@@ -1,115 +1,141 @@
 --- !ruby/object:Gem::Specification
 name: rss-opds
 version: !ruby/object:Gem::Version
-  version: 0.0.2
-  prerelease: 
+  version: 0.0.3
 platform: ruby
 authors:
 - KITAITI Makoto
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-20 00:00:00.000000000 Z
+date: 2019-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rss-dcterms
-  requirement: &11264540 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *11264540
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rss-atom-feed_history
-  requirement: &11264060 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *11264060
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: money
-  requirement: &11263600 !ruby/object:Gem::Requirement
-    none: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
-  version_requirements: *11263600
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: test-unit
-  requirement: &11263060 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11263060
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &11262540 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11262540
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &11262100 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11262100
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
-  requirement: &11261600 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11261600
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
-  requirement: &11261140 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11261140
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-doc
-  requirement: &11260700 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *11260700
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: OPDS parser and maker
 email:
 - KitaitiMakoto@gmail.com
@@ -117,48 +143,45 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - LICENSE
 - README.markdown
 - Rakefile
+- examples/build-catalog-from-epub.rb
 - examples/make-catalog.rb
+- examples/opds_server.ru
 - lib/rss/maker/opds.rb
 - lib/rss/opds.rb
 - lib/rss/opds/version.rb
 - rss-opds.gemspec
 - setup.rb
+- test/fixtures/root.opds
 - test/helper.rb
 - test/test_maker.rb
 homepage: http://rss-ext.rubyforge.org/
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -1275098366759959895
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -1275098366759959895
 requirements: []
-rubyforge_project: http://rss-ext.rubyforge.org/
-rubygems_version: 1.8.8
+rubygems_version: 3.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: This gem extends Ruby bundled RSS library to parse and make OPDS catalogs
-test_files: []
-has_rdoc: 
+test_files:
+- test/fixtures/root.opds
+- test/helper.rb
+- test/test_maker.rb