Finder is a straight-forward library file search tool for Ruby. It can handle RubyGems, Rolls and Ruby’s standard site locals. It is both more flexible and more robust the using Gem.find_files or searching the $LOAD_PATH manually.


To find files, simply provide a glob to the Find.path, Find.load_path or Find.data_path function, and it will return all matches found within current and/or most recent versions of libraries.

For example, a common use case for a pluggable application is to require all the files found in a specially designated subdirectory:

      require 'finder'

      Find.feature('myapp/plugins/*').each do |file|

Rather then load all files you might load them only as needed. For instance, if a command-line option selects for a special template.