<commit_before>[Website](http://github.com/rubyworks/loadable) /
[Report Issue](http://github.com/rubyworks/loadable/issues) /
[Source Code](http://github.com/rubyworks/loadable)
( [![Build Status](https://secure.travis-ci.org/rubyworks/loadable.png)](http://travis-ci.org/rubyworks/loadable) )

# Loadable

*Reliable load wedging for Ruby*


## 1 Description

The Loadable gem provides a more robust and convenient means of augmenting
Ruby's load system, namely the `load` and `require` methods. Rather than
alias and override these methods, Loadable keeps a list of *load hooks*
that control the routing of require and load calls.

In addition, the Loadable gem includes two pre-made load hooks that can be
used to prevent name clashes between Ruby's standard library and gem packages
(see INFRACTIONS.md for more on this). There is also a load hook for
developers to make vendored sub-projects loadable.


## 2 Features

* Safely augment Ruby's load system.
* Prevent library name clashes.
* Search load locations.


## 3 Usage

### 3.1 Installation

Installing via RubyGems follows the usual pattern.
<commit_msg>Add blank line to README. [admin]<commit_after>[Website](http://github.com/rubyworks/loadable) /
[Report Issue](http://github.com/rubyworks/loadable/issues) /
[Source Code](http://github.com/rubyworks/loadable)
( [![Build Status](https://secure.travis-ci.org/rubyworks/loadable.png)](http://travis-ci.org/rubyworks/loadable) )

# Loadable

*Reliable load wedging for Ruby*

<br/>

## 1 Description

The Loadable gem provides a more robust and convenient means of augmenting
Ruby's load system, namely the `load` and `require` methods. Rather than
alias and override these methods, Loadable keeps a list of load hooks
(also call *load wedges*) that control the routing of require and load calls.

In addition, the Loadable gem includes two pre-made load hooks that can be
used to prevent name clashes between Ruby's standard library and gem packages
(see INFRACTIONS.md for more on this). There is also a load hook for
developers to make vendored sub-projects loadable.


## 2 Features

* Safely augment Ruby's load system.
* Prevent library name clashes.
* Search load locations.


## 3 Usage

### 3.1 Installation

Installing via RubyGems follows the usual pattern.

{'fraction_non_alphanumeric': 0.09457092819614711, 'fraction_numerical': 0.0043782837127845885, 'mean_word_length': 4.614250614250614, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6140574', 'n_tokens_mistral': 687, 'n_tokens_neox': 641, 'n_words': 266}