Exclamation

A random exclamation generator. Niiiiice!

About

Exclamation is a random word generator built in Ruby that returns exclamations like "Hello", "Uh oh" and "Booyah".

Usage

Exclamations can be positive, negative, indifferent or greetings and partings.

Exclamation.positive    => 'Nice'
Exclamation.negative    => 'Drat'
Exclamation.indifferent => 'Hmm'
Exclamation.greeting    => 'Hiya'
Exclamation.parting     => 'See you'

Configuration

If you don't like the included lists you can add, remove or completely override the defaults. The config takes either an array of strings, or a path to a YAML file. Inside of some configuration file:

Exclamation.configure do |config|
  # Completely override the defaults with your own list
  config.positives = 'path/to/your/own/custom/list.yml'

  # Append the defaults
  config.include_positives = ['Shaawiing', 'Aww schuky ducky']

  # Remove anything you don't like from the defaults
  config.exclude_positives = ['Bingo', 'Woo']
end

Internationalization

Although the provided lists are in English, you can easily provide your own translations and Exclamation will be happy to use them.

I18n Configuration

Exclamation.configure do |config|
  # Set a default locale besides :en
  config.default_locale = :fr

  # Configure the lists for your locale
  config.greetings_fr = ['Bonjour', 'Salut']
end

I18n Usage

Exclamation.greeting      => 'Bonjour' # default is now French
Exclamation.greeting(:fr) => 'Salut'   # specify locale
Exclamation.greeting(:en) => 'Hello'   # provided English defaults

If no matching locale is found in the configuration, Exclamation will always fall back to English.

Note

Currently in 0.1.6 alpha for a side project. Some day soon Exclamation will graduate to a beta!