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.

QUICK OVERVIEW

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|
        require(file)
      end
    

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