FastRI is an alternative to the ri command-line tool. It is much
also allows you to offer RI lookup services over DRb. FastRI is smarter
ri, and can find classes anywhere in the hierarchy without specifying
“full path”. Its RubyGems support is better than ri’s, and it knows
a method/class definition came from.
Additional information, tarballs… at
FastRI can be installed with RubyGems:
gem install fastri
(if you get an old version/a 404 error, please allow some time after the
release until the package propagates to the RubyForge mirrors). Please
below for an important note regarding the RubyGems packages.
Release information and change summary:
There are two parts to FastRI:
- the server: fastri-server
- the client: fri
FastRI uses a Rinda Ring to allow servers to be discovered automatically
without needing to indicate the DRb URIs manually. It can work across
machines if you make sure the ring server is bound to the correct
and the ACL permissions are correct.
$ fastri-server (creates the index on the first run, blocks)
Later, (times measured with a cold cache):
$ time ruby bin/fri -f plain Array#fetch
array.fetch(index) -> obj
real 0m0.287s (real 0m0.127s with a hot cache)
$ time ri -T -f plain Array#fetch
real 0m10.136s (real ~ 1.5s with a hot cache)
This illustrates FastRI’s ability to locate classes deep in the class
$ fri Base
ActionMailer::Base, ActionView::Base, ActionWebService::API::Base, ActionWebService::Base, ActionWebService::Client::Base, ActiveRecord::Base, MapReduce::ActiveRecord::Base, RSS::Maker::Base, Scruffy::Components::Base, Scruffy::Formatters::Base, Scruffy::Layers::Base, Scruffy::Renderers::Base, Scruffy::Themes::Base
$ fri Themes::Base
Author: Brasten S.
Date: August 14th, 2006
$ ri Themes::Base … several seconds later …
Nothing known about Themes::Base
A small note about RubyGems + FastRI.
RubyGems adds a noticeable overhead to fri, making it run slower than if
installed it directly from the tarball with setup.rb.
Compare the execution time when installed with RubyGems:
$ time fri -f plain String > /dev/null
to the time fri actually takes to run, without the overhead introduced
$ time ruby bin/fri -f plain String > /dev/null
If you care about those extra 300ms (and there are situations where they
matter, e.g. when using fri for method completion), get FastRI from the
FastRI is licensed under the same terms as Ruby. See LICENSE.
Bug reports, patches, comments… are appreciated.
You can contact the author via [email protected]. Please add “fastri” to the
subject in order to bypass the spam filters.