Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



98 Commits

Repository files navigation

= brice - Extra cool IRb goodness for the masses


This documentation refers to brice version 0.4.2


Enhances your IRb experience by adding new functionality and by
providing a framework that you can utilize to add your own extensions.
It comes with a set of pre-selected features (see the files in
{lib/brice/rc}[link:../lib/brice/rc]), but is highly configurable
in that regard.

Add this to your <tt>~/.irbrc</tt> and receive the default goodness:

  require 'brice/init'  # equivalent to: require 'brice'; Brice.init

Or get some more control over the configuration:

  require 'brice'

  Brice.init { |config|

See Brice::Config for what you can configure, and how.

It will even load your own extensions that you place in your <tt>~/.brice</tt>
directory. See Brice::DSL for helpers provided.

Please note that further changes to the configuration for brice can't be
guaranteed to have any effect after <tt>Brice.init</tt> has been called.


+added_methods+:: Loads AddedMethods[]
                  if one (or both) of the following environment variables has
                  been set:

                  +WATCH_FOR_ADDED_METHODS+::    Regular expression or +true+
                  +WATCH_FOR_ADDED_METHODS_IN+:: Space- or comma-delimited list of class names
+libs+::          Loads libraries, either a set of default ones or those you
                  configure with <tt>config.libs = %w[...]</tt>.
+history+::       Configures IRb history support. See Brice::History for more
+colours+::       Configures IRb colour support. See Brice::Colours for more
+shortcuts+::     Includes convenient shortcut methods. See Brice::Shortcuts
                  and Brice::Shortcuts::ObjectShortcuts for more information.
+init+::          Does some basic initialization for IRb.
+prompt+::        Configures the IRb prompt, providing <tt>:BRICE_SIMPLE</tt>
                  and <tt>:BRICE_VERBOSE</tt> prompt modes.
+rails+::         Provides some Rails settings, such as adding the
                  <tt>:BRICE_RAILS</tt> prompt mode, setting the Rails logger
                  to +STDOUT+, and defining convenience accessors for your
+devel+::         Provides some useful settings when developing Ruby libraries.


Source code::
Travis CI::


* Jens Wille <>


Copyright (C) 2008-2020 Jens Wille

brice is free software: you can redistribute it and/or modify it under the
terms of the GNU Affero General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.

brice is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for
more details.

You should have received a copy of the GNU Affero General Public License
along with brice. If not, see <>.