Ruby require loader gem with caller tricks
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
examples
lib
spec
.gitignore
Gemfile
LICENSE
README.md
Rakefile
VERSION
files.rb
loader.gemspec

README.md

loader

Ruby module for automatic file require based on convention :)

Introduction

Okey, before you even think about use this gem, let's say this gem only for lazy ones...

the basic idea is to have an easy to use relative require system and a namespace based Constant loading logic

The fun part is , that this stuffs can be used in gems (modules), because it do not depend on the Dir.pwd or any kind of absolute path or the File expand_path tricks that based on the application position.

The end goal is to make an easy ruby file loader for apps and gems.

Examples

load relative directory (not based on Dir.pwd but the caller files position) if you pass multiple string as argument it will be joined by file separator that the OS use

Manual loading folders

    require 'loader'

    # load all ruby file that was not loaded already
    # from that relative folder
    require_relative_directory "folder_name"

    # for recursive use try the following
    require_relative_directory_r "folder_name/path/etc"

Autoload folders

  require 'loader'
  Loader.autoload

optionally you can tell the project root folder if you work with in a gem.

  require 'loader'
  Loader.autoload(File.dirname(__FILE__))

If you like the basic idea that the app should not do any kind of Eager Load and become slow, you can use the constant based autoload function

Sketch about how it works