ghtorrent 0.7.1 → 0.7.2

data/CHANGELOG

@@ -1,3 +1,6 @@
+= Version 0.7.2
+	* Support for running in standalone mode
+
 = Version 0.7
 	* Full support for issues (comments, labels etc) and pull requests
 	* Cleaned up retrieval of pull request commits

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ghtorrent (0.6)
+    ghtorrent (0.7.2)
       amqp (~> 1.0.0)
       bson_ext (~> 1.8.0)
       daemons (~> 1.1.0)
@@ -15,7 +15,7 @@ GEM
     amq-client (1.0.2)
       amq-protocol (>= 1.2.0)
       eventmachine
-    amq-protocol (1.4.0)
+    amq-protocol (1.5.0)
     amqp (1.0.2)
       amq-client (~> 1.0.2)
       amq-protocol (>= 1.3.0)

data/README.md

@@ -1,16 +1,41 @@
-ghtorrent: Mirror and process the Github event steam
-=========================================================
+##ghtorrent: Mirror and process data from the Github API 
+
+A library and a collection of scripts used to retrieve data from the Github API
+and extract metadata in an SQL database, in a modular and scalable manner. The
+scripts are distributed as a Gem (`ghtorrent`), but they can also be run by
+checking out this repository.
+
+GHTorrent can be used for a variety of purposes, such as:
+
+* Mirror the Github API event stream and follow links from events to actual data
+ to gradually build a [Github index](http://ghtorrent.org/dblite/)
+* Create a queriable metadata index for a specific repository
+* Query the Github API using intelligent caching to avoid duplicate queries
+
+GHTorrent is comprised from the following components (which can be used
+individually):
+
+* [APIClient](https://github.com/gousiosg/github-mirror/blob/master/lib/ghtorrent/api_client.rb): Knows how to query the Github API (both single entities and
+pages) and respect the API request limit. Can be configured to override the
+default IP address, in case of multihomed hosts. Uses configurable on disk [caching](https://github.com/gousiosg/github-mirror/blob/master/lib/ghtorrent/cache.rb) to avoid retrieving data that do not change.
+* [Retriever](https://github.com/gousiosg/github-mirror/blob/master/lib/ghtorrent/retriever.rb): Knows how to retrieve specific Github entities (users, repositories, watchers) by name. Uses an optional persister to avoid 
+retrieving data that have not changed.
+* [Persister](https://github.com/gousiosg/github-mirror/blob/master/lib/ghtorrent/persister.rb): A key/value store, which can be backed by a real key/value store,
+to store Github JSON replies and query them on request. The backing key/value
+store must support arbitrary queries to the stored JSON objects.
+* [GHTorrent](https://github.com/gousiosg/github-mirror/blob/master/lib/ghtorrent/ghtorrent.rb): Knows how to extract information from the data retrieved by
+the retriever in order to update an SQL database (see [schema](http://ghtorrent.org/relational.html)) with metadata.
+
+The Persister and GHTorrent components have configurable back ends:
+
+* Persister: Either uses MongoDB > 2.0 (`mongo` driver) or no persister (`noop` driver)
+* GHTorrent: GHTorrent is tested mainly with MySQL, but can theoretically be
+used with any SQL database compatible with [Sequel](http://sequel.rubyforge.org/rdoc/files/doc/opening_databases_rdoc.html). Your milaege may vary.
 
-A collection of scripts used to mirror the Github event stream, for 
-research purposes. The scripts are distributed as a Gem (`ghtorrent`),
-but they can also be run by checking out this repository.
 
-GHTorrent relies on the following software to work:
+The distributed mirroring scripts also require RabbitMQ >= 2.8 or other
 
-* MongoDB > 2.0
-* RabbitMQ >= 2.7
-* MySQL >= 5.5. GHTorrent is tested mainly with MySQL, but can theoretically be
-used with any SQL database compatible with [Sequel](http://sequel.rubyforge.org/rdoc/files/doc/opening_databases_rdoc.html). Your milaege may vary.
+#### Installing
 
 GHTorrent is written in Ruby (tested with 1.9). To install it as a Gem do:
 
@@ -19,8 +44,7 @@ sudo gem install ghtorrent
 </code>
 
 Depending on which SQL database you want to use, install the appropriate
-dependency gem. GHTorrent already installs the `mysql2` gem (if it fails,
-install the development package for `libmysql-dev` for your system).
+dependency gem.
 
 <code>
 sudo gem install mysql2 #or sqlite3-ruby #or postgres
@@ -34,74 +58,41 @@ file to a file in your home directory. All provided scripts accept the `-c`
 option, which you can use to pass the location of the configuration file as
 a parameter.
 
-Edit the MongoDB and AMQP configuration options accordingly. The scripts
-require accounts with permissions to create queues and exchanges in the AMQP
-queue, collections in MongoDB and tables in the selected SQL database,
-respectively.
-
-To prepare MongoDB:
-
-<pre>
-$ mongo admin
-> db.addUser('github', 'github')
-> use github
-> db.addUser('github', 'github')
-</pre>
-
-To prepare RabbitMQ:
-
-<pre>
-$ rabbitmqctl add_user github
-$ rabbitmqctl set_permissions -p / github ".*" ".*" ".*"
-
-# The following will enable the RabbitMQ web admin for the github user
-# Not necessary to have, but good to debug and diagnose problems
-$ rabbitmq-plugins enable rabbitmq_management
-$ rabbitmqctl set_user_tags github administrator
-</pre>
-
-To prepare MySQL:
-
-<pre>
-$ mysql -u root -p
-mysql> create user 'github'@'localhost' identified by 'github';
-mysql> create database github;
-mysql> GRANT ALL PRIVILEGES ON github.* to github@'localhost';
-mysql> flush privileges;
-</pre>
-
-You can find more information of how you can setup a cluster of machines
+You can find more information of how you can setup a mirroring cluster of machines
 to retrieve data in parallel on the [Wiki](https://github.com/gousiosg/github-mirror/wiki/Setting-up-a-mirroring-cluster).
 
 ### Running
 
-To retrieve data with GHTorrent: 
+To mirror the event stream and capture all data: 
 
 * `ght-mirror-events.rb` periodically polls Github's event
 queue (`https://api.github.com/events`), stores all new events in the
-`events` collection in MongoDB and posts them to the `github` exchange in
+configured pestister and posts them to the `github` exchange in
 RabbitMQ.
 
 * `ght-data_retrieval.rb` creates queues that route posted events to processor
 functions, which in turn use the appropriate Github API call to retrieve the
 linked contents, extract metadata to store in the SQL database and store the
-retrieved data in the appropriate collection in Mongo, to avoid further API
-calls. Data in the SQL database contain pointers (the MongoDB key) to the
-"raw" data in MongoDB.
-
-Both scripts can be run concurrently on more than one hosts, for resilience
-and performance reasons. To catch up with Github's event stream, it is
-usually enough to run `ght-mirror-events` on one host. To collect all data
-pointed by each event, one instance of `ght-data-retrieval` is not enough.
-Both scripts employ throttling mechanisms to keep API usage whithin the
-limits imposed by Github (currently 60 reqs/hr/ip). If you want the full
-5000 reqs/hr/ip, you will have to provide your Github login details 
-in the `config.yaml` file.
+retrieved data in the appropriate collection in the persister, to avoid
+duplicate API
+calls. Data in the SQL database contain pointers (the `ext_ref_id` field) to the
+"raw" data in the persister.
+
+To retrieve data for a repository or user:
+
+* `ght-retrieve-repo` retrieves all data for a specific repository
+* `ght-retrieve-user` retrieves all data for a specific user
+
+To perform maintenance:
+
+* `ght-load` loads selected events from the persister to the queue in order for
+the `ght-data-retrieval` script to reprocess them
+* `ght-get-more-commits` retrieves all commits for a specific repository
 
 #### Data
 
 You can find torrents for retrieving data on the 
-[Available Torrents](https://ghtorrent.org/downloads.html) page. You need two sets of data:
+[Available Torrents](https://ghtorrent.org/downloads.html) page. You can find two sets of data:
 
 * Raw events: Github's [event stream](https://api.github.com/events). These
 are the roots for mirroring operations. The `ght-data-retrieval` crawler starts

data/lib/ghtorrent/adapters/noop_persister.rb

@@ -3,7 +3,7 @@ module GHTorrent
   # Persister adapter that does not store any data.
   class NoopPersister < BaseAdapter
 
-    def init(settings)
+    def initialize(settings)
     end
 
     def store(entity, data = {})

data/lib/ghtorrent/api_client.rb

@@ -28,20 +28,25 @@ module GHTorrent
     def paged_api_request(url, pages = config(:mirror_history_pages_back),
         cache = true, last = nil)
 
-      url = if not url.include?("per_page")
-              if url.include?("?")
-                url + "&per_page=100"
+      url = if not url.include?('per_page')
+              if url.include?('?')
+                url + '&per_page=100'
               else
-                url + "?per_page=100"
+                url + '?per_page=100'
               end
             else
               url
             end
 
-      data = if CGI::parse(URI::parse(url).query).has_key?("page")
+      params = CGI::parse(URI::parse(url).query)
+      data = if params.has_key?('page') or (params.has_key?('last_sha'))
                api_request_raw(url, use_cache?(cache, method = :paged))
              else
-               api_request_raw(url, false)
+               if @cache_mode == :all
+                 api_request_raw(url, true)
+               else
+                 api_request_raw(url, false)
+              end
              end
 
       return [] if data.nil?
@@ -77,7 +82,7 @@ module GHTorrent
 
     # A normal request. Returns a hash or an array of hashes representing the
     # parsed JSON result.
-    def api_request(url, cache = false)
+    def api_request(url, cache = true)
       parse_request_result api_request_raw(url, use_cache?(cache))
     end
 
@@ -87,14 +92,18 @@ module GHTorrent
     # request
     def use_cache?(client_request, method = :non_paged)
       @cache_mode ||= case config(:cache_mode)
-                        when "dev"
+                        when 'dev'
                           :dev
-                        when "prod"
+                        when 'prod'
                           :prod
+                        when 'all'
+                          :all
                         else
                           raise GHTorrentException.new("Don't know cache configuration #{@cache_mode}")
                       end
       case @cache_mode
+        when :all
+          return true
         when :dev
           unless client_request
             return false
@@ -160,7 +169,7 @@ module GHTorrent
             end
 
         total = Time.now.to_ms - start_time.to_ms
-        debug "APIClient: Request: #{url} #{if from_cache then " from cache," else "(#{contents.meta['x-ratelimit-remaining']} remaining)," end} Total: #{total} ms"
+        debug "APIClient: Request: #{url} #{if from_cache then "from cache," else "(#{contents.meta['x-ratelimit-remaining']} remaining)," end} Total: #{total} ms"
 
         if not from_cache and config(:respect_api_ratelimit) and
             contents.meta['x-ratelimit-remaining'].to_i < 20
@@ -201,7 +210,7 @@ module GHTorrent
                            :http_basic_authentication => [@username, @passwd])}
       end
 
-      if @attach_ip.nil? or @attach_ip.eql? "0.0.0.0"
+      if @attach_ip.nil? or @attach_ip.eql? '0.0.0.0'
         @open_func.call(url)
       else
         attach_to(@attach_ip) do

data/lib/ghtorrent/cache.rb

@@ -33,7 +33,7 @@ module GHTorrent
           end
         end
       rescue
-        warn "Could not cache object #{file} for key #{key}"
+        warn "Cache: Could not cache object #{file} for key #{key}"
       end
     end
 
@@ -47,7 +47,7 @@ module GHTorrent
       end
 
       unless (Time.now() - File.mtime(file)) < max_life
-        debug "Cached object for key #{key} too old"
+        debug "Cache: Cached object for key #{key} too old"
         return nil
       end
 
@@ -58,7 +58,7 @@ module GHTorrent
           end
         end
       rescue
-        warn "Could not read object from cache location #{file}"
+        warn "Cache: Could not read object from cache location #{file}"
         File.delete(file)
       end
     end

data/lib/ghtorrent/ghtorrent.rb

@@ -20,6 +20,7 @@ module GHTorrent
       @settings = settings
       @ext_uniq = config(:uniq_id)
       @logger = Logger.new(STDOUT)
+      debug "GHTorrent: Using cache dir #{config(:cache_dir)}"
     end
 
     # Get a connection to the database
@@ -40,7 +41,7 @@ module GHTorrent
     end
 
     def persister
-      @persister ||= connect(:mongo, @settings)
+      @persister ||= connect(config(:mirror_persister), @settings)
       @persister
     end
 

data/lib/ghtorrent/migrations/012_add_forks_to_projects.rb

@@ -3,20 +3,21 @@ require 'sequel'
 require 'ghtorrent/migrations/mysql_defaults'
 
 Sequel.migration do
+
   up do
 
-    puts "Adding column forked_from in table projects"
+    puts 'Adding column forked_from in table projects'
     alter_table :projects do
       add_foreign_key :forked_from, :projects, :null => true
     end
 
-    puts "Migrating data from forks to project(forked_from)"
-    DB.transaction(:rollback => :reraise, :isolation => :committed) do
-      DB[:projects].each do |p|
-        fork = DB[:forks].first(:forked_project_id => p[:id])
+    puts 'Migrating data from forks to project(forked_from)'
+    self.transaction(:rollback => :reraise, :isolation => :committed) do
+      self[:projects].each do |p|
+        fork = self[:forks].first(:forked_project_id => p[:id])
         unless fork.nil?
-          source = DB[:projects].first(:id => fork[:forked_from_id])
-          DB[:projects].filter(:id => p[:id]).update(:forked_from => source[:id])
+          source = self[:projects].first(:id => fork[:forked_from_id])
+          self[:projects].filter(:id => p[:id]).update(:forked_from => source[:id])
           puts "#{p[:owner_id]}/#{p[:name]} is forked from #{source[:owner_id]}/#{source[:name]}"
         end
       end

data/lib/ghtorrent/migrations/013_add_merged_to_pullreqs.rb

@@ -10,26 +10,28 @@ Sequel.migration do
                :default => false
 
     puts "Updating pull_requests.merged"
-    DB.transaction(:rollback => :reraise, :isolation => :committed) do
-      DB << "update pull_requests pr
-      set pr.merged = true
-      where exists (select *
-          from pull_request_commits prc, project_commits pc
-          where prc.commit_id = pc.commit_id
-          and prc.pull_request_id = pr.id
-	        and pc.project_id = pr.base_repo_id
-          and pr.base_repo_id <> pr.head_repo_id)"
-      DB << "update pull_requests pr
-      set pr.merged = true
+    self.transaction(:rollback => :reraise, :isolation => :committed) do
+      self << "update pull_requests
+             set merged = '1'
+             where exists (
+              select *
+              from pull_request_commits prc, project_commits pc
+              where prc.commit_id = pc.commit_id
+                  and prc.pull_request_id = pull_requests.id
+                  and pc.project_id = pull_requests.base_repo_id
+                  and pull_requests.base_repo_id <> pull_requests.head_repo_id);"
+
+      self << "update pull_requests
+      set merged = '1'
       where exists(
         select prh.created_at
         from pull_request_history prh
-        where prh.action='merged' and prh.pull_request_id=pr.id)"
+        where prh.action='merged' and prh.pull_request_id=pull_requests.id)"
     end
 
-    puts "Correcting intra_branch field"
-    DB.transaction(:rollback => :reraise, :isolation => :committed) do
-      DB << "update pull_requests set intra_branch = true where base_repo_id = head_repo_id"
+    puts 'Correcting intra_branch field'
+    self.transaction(:rollback => :reraise, :isolation => :committed) do
+      self << "update pull_requests set intra_branch = '1' where base_repo_id = head_repo_id"
     end
   end
 

data/lib/ghtorrent/persister.rb

@@ -13,9 +13,9 @@ module GHTorrent
 
     # Factory method for retrieving persistence connections.
     # The +settings+ argument is a fully parsed YAML document
-    # passed on to adapters. The available +adapter+ are :mongo and :noop
+    # passed on to adapters. The available +adapter+ are 'mongo' and 'noop'
     def connect(adapter, settings)
-      driver = ADAPTERS[adapter]
+      driver = ADAPTERS[adapter.intern]
       driver.new(settings)
     end
 

data/lib/ghtorrent/retriever.rb

@@ -559,7 +559,7 @@ module GHTorrent
                 paged_api_request(ghurl urls)
               end
 
-      items.each do |x|
+      items = items.map do |x|
         x['repo'] = repo
         x['owner'] = user
 
@@ -589,12 +589,18 @@ module GHTorrent
             debug "Retriever: #{entity} #{user}/#{repo} -> #{x[descriminator]} exists"
           end
         end
+        # If the persistence driver does not set an ext_ref_id key, set a dummy
+        # one here
+        unless x.has_key? ext_uniq
+          x[ext_uniq] = '0'
+        end
+        x
       end
 
       if item_id.nil?
-        persister.find(entity, selector)
+        items
       else
-        repo_bound_instance(entity, selector, descriminator, item_id)
+        [items.find{|x| x[descriminator] == item_id}]
       end
     end
 

data/lib/ghtorrent/settings.rb

@@ -9,68 +9,73 @@ module GHTorrent
     include GHTorrent::Utils
 
     CONFIGKEYS = {
-        :amqp_host => "amqp.host",
-        :amqp_port => "amqp.port",
-        :amqp_username => "amqp.username",
-        :amqp_password => "amqp.password",
-        :amqp_exchange => "amqp.exchange",
-        :amqp_prefetch  => "amqp.prefetch",
+        :amqp_host => 'amqp.host',
+        :amqp_port => 'amqp.port',
+        :amqp_username => 'amqp.username',
+        :amqp_password => 'amqp.password',
+        :amqp_exchange => 'amqp.exchange',
+        :amqp_prefetch  => 'amqp.prefetch',
 
-        :sql_url => "sql.url",
+        :sql_url => 'sql.url',
 
-        :mirror_urlbase => "mirror.urlbase",
-        :mirror_pollevery => "mirror.pollevery",
-        :mirror_persister => "mirror.persister",
-        :mirror_commit_pages_new_repo => "mirror.commit_pages_new_repo",
-        :mirror_history_pages_back => "mirror.history_pages_back",
-        :uniq_id => "mirror.uniq_id",
-        :user_agent => "mirror.user_agent",
+        :mirror_urlbase => 'mirror.urlbase',
+        :mirror_pollevery => 'mirror.pollevery',
+        :mirror_persister => 'mirror.persister',
+        :mirror_commit_pages_new_repo => 'mirror.commit_pages_new_repo',
+        :mirror_history_pages_back => 'mirror.history_pages_back',
+        :uniq_id => 'mirror.uniq_id',
+        :user_agent => 'mirror.user_agent',
 
-        :cache_mode      => "mirror.cache_mode",
-        :cache_dir       => "mirror.cache_dir",
-        :cache_stale_age => "mirror.cache_stale_age",
+        :cache_mode      => 'mirror.cache_mode',
+        :cache_dir       => 'mirror.cache_dir',
+        :cache_stale_age => 'mirror.cache_stale_age',
 
-        :github_username => "mirror.username",
-        :github_passwd => "mirror.passwd",
+        :github_username => 'mirror.username',
+        :github_passwd => 'mirror.passwd',
 
-        :respect_api_ratelimit => "mirror.respect_api_ratelimit",
+        :respect_api_ratelimit => 'mirror.respect_api_ratelimit',
 
-        :attach_ip => "mirror.attach_ip"
+        :attach_ip => 'mirror.attach_ip'
     }
 
     DEFAULTS = {
-        :amqp_host => "localhost",
+        :amqp_host => 'localhost',
         :amqp_port => 5672,
-        :amqp_username => "github",
-        :amqp_password => "github",
-        :amqp_exchange => "github",
+        :amqp_username => 'github',
+        :amqp_password => 'github',
+        :amqp_exchange => 'github',
         :amqp_prefetch  => 1,
 
-        :sql_url => "sqlite://github.db",
+        :sql_url => 'sqlite://github.db',
 
-        :mirror_urlbase => "https://api.github.com/",
-        :mirror_pollevery => "mirror.pollevery",
-        :mirror_persister => "no-op",
+        :mirror_urlbase => 'https://api.github.com/',
+        :mirror_pollevery => 'mirror.pollevery',
+        :mirror_persister => 'noop',
         :mirror_commit_pages_new_repo => 3,
         :mirror_history_pages_back => 1,
-        :uniq_id => "ext_ref_id",
-        :user_agent => "ghtorrent",
+        :uniq_id => 'ext_ref_id',
+        :user_agent => 'ghtorrent',
 
-        :cache_mode      => "dev",
-        :cache_dir       => Dir::tmpdir + File::SEPARATOR + "ghtorrent",
+        :cache_mode      => 'dev',
+        :cache_dir       => Dir::tmpdir + File::SEPARATOR + 'ghtorrent',
         :cache_stale_age => 604800,
 
-        :github_username => "foo",
-        :github_passwd => "bar",
+        :github_username => 'foo',
+        :github_passwd => 'bar',
 
-        :respect_api_ratelimit => "true",
+        :respect_api_ratelimit => 'true',
 
-        :attach_ip => "0.0.0.0"
+        :attach_ip => '0.0.0.0'
     }
 
     def config(key, use_default = true)
       begin
-        read_value(settings, CONFIGKEYS[key])
+        a = read_value(settings, CONFIGKEYS[key])
+        if a.nil? && use_default
+          DEFAULTS[key]
+        else
+          a
+        end
       rescue Exception => e
         if use_default
           DEFAULTS[key]
@@ -91,7 +96,7 @@ module GHTorrent
     end
 
     def settings
-      raise Exception.new("Unimplemented")
+      raise Exception.new('Unimplemented')
     end
 
   end

data/lib/version.rb

@@ -1,5 +1,5 @@
 module GHTorrent
 
-  VERSION = '0.7.1'
+  VERSION = '0.7.2'
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ghtorrent
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.7.2
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-03 00:00:00.000000000 Z
+date: 2013-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: amqp
@@ -180,24 +180,8 @@ files:
 homepage: https://github.com/gousiosg/github-mirror
 licenses: []
 post_install_message: !binary |-
-  WxtbMzJtVmVyc2lvbiAwLjcbWzBtXSBGdWxsIHN1cHBvcnQgZm9yIGlzc3Vl
-  cyAoY29tbWVudHMsIGxhYmVscyBldGMpIGFuZCBwdWxsIHJlcXVlc3RzClsb
-  WzMybVZlcnNpb24gMC43G1swbV0gQ2xlYW5lZCB1cCByZXRyaWV2YWwgb2Yg
-  cHVsbCByZXF1ZXN0IGNvbW1pdHMKWxtbMzJtVmVyc2lvbiAwLjcbWzBtXSBD
-  bGVhbmVkIHVwIGFzc29jaWF0aW9uIG9mIGNvbW1pdHMgd2l0aCByZXBvc2l0
-  b3JpZXMuClsbWzMybVZlcnNpb24gMC43G1swbV0gUmVtb3ZlZCB0aGUgZm9y
-  a3MgdGFibGUuIEZvcmtzIGFyZSBub3cgdHJhY2tlZCBieSB0aGUgZm9ya2Vk
-  X2Zyb20gZmllbGQgaW4gcHJvamVjdHMKWxtbMzJtVmVyc2lvbiAwLjcbWzBt
-  XSBVc2UgR2l0aHViJ3MgSFRUUCBoZWFkZXJzIGZvciByZXF1ZXN0IHRocm90
-  dGxpbmcKWxtbMzJtVmVyc2lvbiAwLjcbWzBtXSBTdXBwb3J0IGZvciBzZXR0
-  aW5nIHVzZXIgYWdlbnQgaGVhZGVyIGFzIHBlciBHaXRodWIgQVBJIHJlcXVp
-  cmVtZW50cwpbG1szMm1WZXJzaW9uIDAuNxtbMG1dIFN1cHBvcnQgZm9yIG1h
-  cmtpbmcgcHJvamVjdHMgYXMgZGVsZXRlZCAocnVuIGZpeGVzL3VwZGF0ZV9k
-  ZWxldGVkLnJiKQpbG1szMm1WZXJzaW9uIDAuNxtbMG1dIE5ldyB0b29sIChn
-  aHQtcmV0cmlldmUtdXNlcikgdG8gcmV0cmlldmUgYWxsIGRhdGEgZm9yIGEg
-  c2luZ2xlIHVzZXIgClsbWzMybVZlcnNpb24gMC43G1swbV0gU3VwcG9ydCBm
-  b3IgcnVubmluZyB3aXRob3V0IGEgY29uZmlnLnlhbWwgZmlsZQpbG1szMm1W
-  ZXJzaW9uIDAuNxtbMG1dIFRlY2huaWNhbCByZXBvcnQgaW4gZG9jLwo=
+  WxtbMzJtVmVyc2lvbiAwLjcuMhtbMG1dIFN1cHBvcnQgZm9yIHJ1bm5pbmcg
+  aW4gc3RhbmRhbG9uZSBtb2RlCg==
 rdoc_options:
 - --charset=UTF-8
 require_paths: