every_day_irb 1.7.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cce92e8050e0eac9307235f880e754f34ec7d369
-  data.tar.gz: a8386baa8d0ee0d625f99fc3a7dbe46228ebcc5c
+  metadata.gz: 244188d18a787358db20562d891644c53daf6dc6
+  data.tar.gz: 9aa78fd37e995acf0eee2452f9cd0261221fe1e9
 SHA512:
-  metadata.gz: 45a8f01e367fab7d5dad96af24f05e3b0f8ec0635f1e0e59df5d35937458f268bc3f2f52205b2e9a207807438abf38e0d6cb9151e5616f64917eb892abf355d1
-  data.tar.gz: 96566b71de8e0ab91fe3b1b556f80ff7d6da2ebb44c735f99c7d2db46616fdff68b85619fbc95289d703947fa08b2cfef6132d9cdcea661efeb8f9dadde1793c
+  metadata.gz: 95518798918ce370df0bae9e216b68c375094b4fea251728e0dd4307015e04143985648d01b8ad5fb46d1af3311d5fc18603a1bc89554706c4ae34ce0f205f9d
+  data.tar.gz: b4c9d2df4dbaa5d99938b9b39e0eec26501466b8f672ffa5f951c47b5fc2e46da14e9ca61232ccafa4e039fb8f47217bcefeeecde76df9fb1e6fdf840228e90f

data/CHANGELOG-EVERYDAYIRB.txt

@@ -0,0 +1,5 @@
+2.0.0
+* Separate every_day_irb release cycle from irbtools release cycle
+* Move cd enhancements into cd microgem on which every_day_irb depends
+* You must extend EveryDayIrb explicitely, does not happen on require, anymore
+* Add rr for require_relative

data/{MIT-LICENSE → MIT-LICENSE.txt}

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2014 Jan Lelis
+Copyright (c) 2010-2015 Jan Lelis
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,195 @@
+# Irbtools [![version](https://badge.fury.io/rb/irbtools.svg)](http://badge.fury.io/rb/irbtools)
+
+     _ _|        |      |                  |
+       |    __|  __ \   __|   _ \    _ \   |   __|
+       |   |     |   |  |    (   |  (   |  | \__ \
+     ___| _|    _.__/  \__| \___/  \___/  _| ____/
+
+
+Improvements for Ruby's IRB console, like colored output and a lot of
+debugging and introspection methods. Unlike with PRY, you are still in your
+normal IRB. It is designed to work out-of-the-box, so there is no reason to not
+use it!
+
+## Setup
+
+    $ gem install irbtools
+
+IRB executes code in `~/.irbrc` on start-up. If the file does not exist, yet,
+just create a new one. Add the following content:
+
+    require 'irbtools'
+
+You also need to add irbtools to your project's Gemfile:
+
+    gem 'irbtools', require: 'irbtools/binding'
+
+Then start IRB (with **Irbtools** loaded) from the console or directly from your code with:
+
+    binding.irb
+
+If the `binding_of_caller` gem is available (e.g. see below), you can omit the `binding`:
+
+    irb
+
+### More Improvements
+
+Some suggested gems will not be installed to ensure wider general support. For
+the full feature set, you can add **irbtools-more** and change your
+`.irbrc` to:
+
+    require 'irbtools/more'
+
+and edit your Gemfile to
+
+    gem 'irbtools-more', require: 'irbtools/binding'
+
+
+### Included Gems and Libraries
+#### IRB Improvements
+
+*   Colored output:
+    [wirb](https://github.com/janlelis/wirb/)
+    [fanycy_irb](https://github.com/janlelis/fancy_irb)
+*   Custom views for specific objects:
+    [hirb](http://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html)
+*   **(irbtools-more)** Correction suggestions for misspelled method/constant names:
+    [did_you_mean](https://github.com/yuki24/did_you_mean)
+*   **(irbtools-more)** Better tab-completion:
+    [bond](http://tagaholic.me/bond/)
+
+#### Utils
+
+*   Useful IRB commands (see below):
+    [every_day_irb](https://github.com/janlelis/irbtools/tree/master/lib/every
+    _day_irb.rb)
+    [debugging](https:/github.com/janlelis/debugging)
+    [fileutils](http://ruby-doc.org/stdlib-2.2.1/libdoc/fileutils/rdoc/FileUtils.html)
+*   Clipboard Access:
+    [clipboard](https://github.com/janlelis/clipboard)
+*   Terminal colors:
+    [paint](https://github.com/janlelis/paint)
+*   Load an editor into your IRB session:
+    [interactive_editor](https://github.com/jberkel/interactive_editor)
+
+#### Introspection
+
+*   Displays a method's source:
+    [code](https://github.com/janlelis/code)
+*   Access to `ri` docs:
+    [ori](https://github.com/dadooda/ori)
+*   Manipulate instance variables with ease:
+    [instance](https://github.com/rubyworks/instance/)
+*   Platform information:
+    [ruby_version](https://github.com/janlelis/ruby_version)
+    [ruby_engine](https://github.com/janlelis/ruby_engine)
+    [os](https://github.com/rdp/os)
+    [ruby_info](https://github.com/janlelis/ruby_info)
+*   Improved method lookup path inspection:
+    [method_locator](https://github.com/ryanlecompte/method_locator)
+*   Finds methods that turn one value into another value:
+    [methodfinder](https://github.com/citizen428/methodfinder)
+*   **irbtools-more** Awesome lookup path inspection:
+    [looksee](https://github.com/oggy/looksee)
+
+
+### Irbtools Methods
+
+Besides improving IRB itself, you will get the following methods:
+
+Method | Arguments  | Description
+------ | ---------- | -----------
+`beep` | | Ring terminal bell.
+`cat` | path | Read file contents.
+`cd` | path = nil | Changes the directory. Can also be used in these forms: `~cd` (change to home directory), `-cd` (change to previous directory).
+`clear` | | Clear the terminal.
+`code` | object = self, method_name | Display the method source with syntax highlighting. Will also look up C methods if the **core_docs** gem is available.
+`colorize` | string | Syntax highlight a Ruby string.
+`copy` | string | Copy something to the clipboard.
+`copy_input` | | Copy session history to the clipboard.
+`copy_output` | | Copy session output history to the clipboard.
+`ed` / `emacs` / `mate` / `mvim` / `nano` / `vi` / `vim` | filename = nil | Start an editor in the session context.
+`engine` | | Show the Ruby engine.
+`g` | *args | Like `Kernel#p`, but using terminal-notifier or growl.
+`howtocall` | object = self, method_or_proc | Displays parameter names and types for a proc or method.
+`info` | | List general information about the Ruby environment.
+`ld` | file | Shortcut for `load lib.to_s + '.rb'`.
+`ls` | path = "." | List directory content.
+`mf` | object1, object2 | Find methods that turn one value into another value:w
+`mof` | object, depth = 0, grep = // | Print a method list, ordered by modules.
+`os` | | Query operating system information.
+`pa` | string, color | Print a string in the specified color.
+`page` | what, options = {} | Page long content.
+`paste` | | Paste clipboard content.
+`q` | *args | Like `Kernel#p`, but prints results on one line, with different colors.
+`ray` | path | Syntax highlight a Ruby file.
+`re` | string, regexg, groups = nil | Assists you when matching regexes againts strings.
+`reset!` | | Restart the current IRB session.
+`rq` | lib | Shortcut for `require lib.to_s`. Use it like this: `rq:prime`.
+`rrq` / `rerequire` | lib | Hack to remove a library from `$LOADED_FEATURES` and `require` it again.
+`session_history` | number_of_lines = nil | Return a string of all commands issued in the current session.
+`version` | | Show the Ruby version.
+`wp` | inspect_string | Syntax-highlight a Ruby object.
+`Object#instance` | | Proxy object to read and manipulate instance variables / run eval.
+`Object#lp` | | **irbtools-more** Supercharged method introspection in IRB
+`Object#mlp` / `Object#method_lookup_path` | | Traverse an object's method lookup path to find all places where a method may be defined.
+`Object#ri` | *args | Show ri documentation for this object or method.
+
+
+### Advanced tweaking
+
+See [CONFIGURE.md](https://github.com/janlelis/irbtools/blob/master/CONFIGURE.md).
+
+
+### Troubleshooting: ANSI colors on Windows
+
+Windows: ANSI support can be enabled via
+[ansicon](https://github.com/adoxa/ansicon) or
+[ConEmu](http://code.google.com/p/conemu-maximus5/).
+
+
+### Troubleshooting: Clipboard not working on Linux
+
+Clipboard support requires **xclip** or **xsel**. On ubuntu, do: `sudo apt-get
+install xclip`
+
+
+### Troubleshooting: Unicode causes wrong display widths
+
+If you use double-width unicode characterss, you will need to paste the
+following snippet to your `.irbrc` file.
+
+    Irbtools.replace_library_callback :fancy_irb do
+      FancyIrb.start east_asian_width: true
+    end
+
+This setting is deactivated by default, because of performance issues.
+
+
+### Hint: Debundle
+
+If you do not want to add **Irbtools** to your project's Gemfile, you will need a
+[debundle hack](https://github.com/janlelis/debundle.rb). Put it at the
+beginning of your `~/.irbrc` file and you are fine (until it breaks).
+
+
+### Hint: No ANSI / IRB extension
+
+You can use Irbtools without colors/irb extensions. To do so, put this into `~/.irbrc`:
+
+```ruby
+require 'irbtools/non_fancy'
+Irbtools.start
+```
+
+
+### Hint: Web Console
+
+**Irbtools** works well together with the amazing
+[web-console!](https://github.com/rails/web-console)
+
+
+## J-_-L
+
+Copyright (c) 2010-2015 Jan Lelis <http://janlelis.com> released under the MIT
+license.

data/every_day_irb.gemspec

@@ -1,19 +1,28 @@
 # -*- encoding: utf-8 -*-
-require File.dirname(__FILE__) + '/lib/irbtools/configure'
+require File.dirname(__FILE__) + '/lib/every_day_irb/version'
 
 Gem::Specification.new do |s|
   s.name = 'every_day_irb'
-  s.version = Irbtools::VERSION
+  s.version = EveryDayIrb::VERSION
 
+  s.homepage              = 'http://github.com/janlelis/irbtools'
   s.authors               = ["Jan Lelis"]
-  s.summary               = 'every_day_irb defines helper methods that simplify life in irb.'
-  s.description           = 'every_day_irb defines helper methods that simplify life in irb.: ls, cat, rq, rrq, ld, session_history, reset!, clear, ...'
+  s.summary               = 'EveryDayIrb simplifies daily life in IRB.'
+  s.description           = 'EveryDayIrb simplifies daily life in IRB with commands like: ls, cat, rq, rrq, ld, reset!, ...'
   s.email                 = 'mail@janlelis.de'
-  s.extra_rdoc_files      = %w[MIT-LICENSE README.rdoc]
-  s.files                 = Dir.glob(%w[lib/every_day_irb.rb every_day_irb.gemspec])
-  s.homepage              = 'http://github.com/janlelis/irbtools'
-  s.required_ruby_version = '>= 1.9.3'
+  s.files                 = %w[
+    lib/every_day_irb.rb
+    lib/every_day_irb/version.rb
+    spec/every_day_irb_spec.rb
+    every_day_irb.gemspec
+  ]
+  s.extra_rdoc_files      = %w[
+    README.md
+    CHANGELOG-EVERYDAYIRB.txt
+    MIT-LICENSE.txt
+  ]
   s.license               = 'MIT'
-  s.add_development_dependency %q<rspec>
-  s.add_development_dependency %q<rake>
+
+  s.required_ruby_version = '~> 2.0'
+  s.add_dependency 'cd', '~> 1.0'
 end

data/lib/every_day_irb.rb

@@ -1,16 +1,20 @@
-# every_day_irb defines some helper methods that might be useful in every-day irb usage
+require_relative 'every_day_irb/version'
 
-module EveryDayIrb
-  VERSION = "1.7.1"
+require 'cd'
 
+module EveryDayIrb
   extend self
   private
 
   # shows the contents of your current directory (more such commands available by FileUtils)
-  def ls(path='.')
-    Dir[ File.join( path, '*' )].map{|filename| File.basename filename }
+  def ls(path = '.')
+    Cd.cd.ls(path)
+  end
+
+  # patch cd so that it also shows the current directory and got some extras
+  def cd(path = nil)
+    Cd.cd(path)
   end
-  alias dir ls
 
   # read file contents (also see ray for ruby source files ;) )
   def cat(path)
@@ -22,6 +26,11 @@ module EveryDayIrb
     require lib.to_s
   end
 
+  # same for require relative
+  def rr(lib)
+    require_relative lib.to_s
+  end
+
   # load shortcut, not suited for non-rb
   def ld(lib)
     load lib.to_s + '.rb'
@@ -40,11 +49,16 @@ module EveryDayIrb
   end
   alias rrq rerequire
 
+  # just clear the screen
+  def clear
+    system 'clear'
+  end
+
   # restart irb
   def reset!
     # remember history...
-    reset_irb = proc{ exec$0 }
-    if defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
+    reset_irb = proc{ exec $0 }
+    if defined?(Ripl) && Ripl.started?
       Ripl.shell.write_history if Ripl.shell.respond_to? :write_history
       reset_irb.call
     else
@@ -53,15 +67,10 @@ module EveryDayIrb
     end
   end
 
-  # just clear the screen
-  def clear
-    system 'clear'
-  end
-
-  # returns the last lines, needed for some copy_ methods
+  # returns the last lines
   def session_history(number_of_lines = nil)
     if !number_of_lines
-      if defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
+      if defined?(Ripl) && Ripl.started?
         number_of_lines = Ripl.shell.line
       else
         number_of_lines = context.instance_variable_get(:@line_no)
@@ -71,6 +80,3 @@ module EveryDayIrb
   end
 end
 
-include EveryDayIrb
-
-# J-_-L

data/lib/every_day_irb/version.rb

@@ -0,0 +1,3 @@
+module EveryDayIrb
+  VERSION = "2.0.0".freeze
+end

data/spec/every_day_irb_spec.rb

@@ -0,0 +1,126 @@
+require_relative '../lib/every_day_irb'
+
+require 'fileutils'
+
+describe EveryDayIrb do
+  include EveryDayIrb
+
+  let(:filename){ __FILE__ }
+  let(:filename_without_rb){ filename.sub(/\.rb$/, '') }
+  let(:path){ File.dirname(filename) + '/..' }
+
+  describe '#ls' do
+    it 'returns an array' do
+      expect( ls ).to be_a Array
+    end
+
+    context '[no args]' do
+      it 'calls Dir["./*"] to get the list of all files in the current dir' do
+        res = Dir['./*']
+        expect( Dir ).to receive(:[]).with('./*').and_return(res)
+
+        ls
+      end
+    end
+
+    context 'one arg' do
+      it 'calls Dir["#{path}/*"] to get the list of all files of the given path' do
+        res = Dir["#{path}/*"]
+        expect( Dir ).to receive(:[]).with("#{path}/*").and_return(res)
+
+        ls(path)
+      end
+    end
+  end
+
+  describe "#cd" do
+    it 'returns an array' do
+      expect( ls ).to be_a Array
+    end
+
+    it 'requests FileUtils to change the directory' do
+      expect( FileUtils::Verbose ).to receive(:cd).with("/")
+
+      cd "/"
+    end
+  end
+
+  describe '#cat' do
+    it 'returns a String' do
+      expect( cat(filename) ).to be_a String
+    end
+
+    it 'calls File.read(path)' do
+      expect( File ).to receive(:read).with(filename)
+
+      cat(filename)
+    end
+  end
+
+  describe '#rq' do
+    it 'calls require with the arg' do
+      expect( self ).to receive(:require).with('rbconfig')
+
+      rq 'rbconfig'
+    end
+
+    it 'calls to_s on the arg' do
+      expect( self ).to receive(:require).with('rbconfig')
+
+      rq:rbconfig
+    end
+  end
+
+  describe '#rr' do
+    it 'calls require_re with the arg' do
+      expect( self ).to receive(:require_relative).with('something').and_return(nil)
+
+      rr 'something'
+    end
+
+    it 'calls to_s on the arg' do
+      expect( self ).to receive(:require_relative).with('something').and_return(nil)
+
+      rr:something
+    end
+  end
+
+  describe '#ld' do
+    it 'calls load with the arg, but appends ".rb"' do
+      expect( self ).to receive(:load).with(filename)
+
+      ld filename_without_rb
+    end
+
+    it 'calls to_s on the arg' do
+      expect( self ).to receive(:load).with(filename)
+
+      ld filename_without_rb.to_sym
+    end
+  end
+
+  describe '#rerequire' do
+    it 'requires a library a second time' do
+      first_time = require 'abbrev'
+      second_time = rerequire 'abbrev'
+
+      expect( second_time ).to be true
+    end
+  end
+
+  describe '#clear' do
+    it "calls the system's clear command" do
+      expect( self ).to receive(:system).with('clear')
+
+      clear
+    end
+  end
+
+  describe '#reset!' do
+    pending
+  end
+
+  describe '#session_history' do
+    pending
+  end
+end

metadata

@@ -1,56 +1,46 @@
 --- !ruby/object:Gem::Specification
 name: every_day_irb
 version: !ruby/object:Gem::Version
-  version: 1.7.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-24 00:00:00.000000000 Z
+date: 2015-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: cd
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '1.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-description: 'every_day_irb defines helper methods that simplify life in irb.: ls,
-  cat, rq, rrq, ld, session_history, reset!, clear, ...'
+        version: '1.0'
+description: 'EveryDayIrb simplifies daily life in IRB with commands like: ls, cat,
+  rq, rrq, ld, reset!, ...'
 email: mail@janlelis.de
 executables: []
 extensions: []
 extra_rdoc_files:
-- MIT-LICENSE
-- README.rdoc
+- README.md
+- CHANGELOG-EVERYDAYIRB.txt
+- MIT-LICENSE.txt
 files:
-- MIT-LICENSE
-- README.rdoc
+- CHANGELOG-EVERYDAYIRB.txt
+- MIT-LICENSE.txt
+- README.md
 - every_day_irb.gemspec
 - lib/every_day_irb.rb
+- lib/every_day_irb/version.rb
+- spec/every_day_irb_spec.rb
 homepage: http://github.com/janlelis/irbtools
 licenses:
 - MIT
@@ -61,9 +51,9 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -71,8 +61,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
-summary: every_day_irb defines helper methods that simplify life in irb.
+summary: EveryDayIrb simplifies daily life in IRB.
 test_files: []

data/README.rdoc

@@ -1,203 +0,0 @@
-= irbtools
-
-Improvements for Ruby's IRB console, for example, colored output, and a lot of debugging and introspection methods. Unlike with PRY, you are still in your normal IRB. It is designed to work out-of-the-box so there is no reason to not use it!
-
-
-== Setup
-
-  $ gem install irbtools
-
-
-=== Extra Requirements
-
-Linux: Clipboard support requires *xclip* or *xsel*: <tt>sudo apt-get install xclip</tt>
-
-Windows: ANSI colors can be enabled via ansicon[https://github.com/adoxa/ansicon]
-
-Mac OS: The g gem makes use of *growl*
-
-
-== Usage
-
-IRB executes code in <tt>~/.irbrc</tt> on start-up. If the file does not exist, yet, just create a new one. Add the following:
-
-  require 'irbtools'
-
-See further below, if you want to customize which libraries should be loaded on IRB start-up.
-
-
-=== With Bundler
-
-To integrate *irbtools* into a Rails console (or any project that uses bundler), add <tt>irbtools</tt> to your Gemfile:
-
-  gem 'irbtools', require: 'binding.repl'
-
-Thanks to help from the {binding.repl gem}[https://github.com/rpag/binding.repl], you can start IRB (with *irbtools*) directly from your code:
-
-  binding.repl!
-
-
-=== Debundle
-
-Another way to activate *irbtools* in bundler projects is to add a {debundle hack}[https://github.com/janlelis/debundle.rb] at the beginning of your <tt>~/.irbrc</tt> file.
-
-
-=== This is irbtools Light
-
-When installing *irbtools*, some gems will not be installed to ensure Windows OS support, for example, the bond gem for better auto-completion or the looksee gem for method/class introspection. These are packaged as {irbtools-more}[https://github.com/janlelis/irbtools-more]. To use <tt>irbtools-more</tt>, you will need to change your <tt>.irbrc</tt> to:
-
-  require 'irbtools/more'
-
-and/or edit your Gemfile to
-
-  gem 'irbtools-more', require: 'binding.repl'
-
-
-=== Included Gems and Libraries
-==== IRB Improvements
-
-* Colorization: wirb[https://github.com/janlelis/wirb/]
-* IRB tweaks: fancy_irb[https://github.com/janlelis/fancy_irb]
-* Custom views for specific objects: hirb[http://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html]
-* <b>(irbtools-more)</b> Better IRB tab-completion: bond[http://tagaholic.me/bond/]
-
-
-==== Helpful Methods
-
-* Useful IRB commands: every_day_irb[https://github.com/janlelis/irbtools/tree/master/lib/every_day_irb.rb]
-* Clipboard Access: clipboard[http://github.com/janlelis/clipboard]
-* Loads an editor into your IRB session: interactive_editor[https://github.com/jberkel/interactive_editor]
-* Print debugging helpers: debugging[https:/github.com/janlelis/debugging]
-* File-related system commands: *fileutils* (stdlib)
-
-
-==== Platform Information
-
-* Query current Ruby version: ruby_version[https://github.com/janlelis/ruby_version]
-* Query current Ruby engine: ruby_engine[https://github.com/janlelis/ruby_engine]
-* Query current operating system: os[https://github.com/rdp/os]
-* Global information by the interpreter behind one <tt>Info</tt> constant: ruby_info[https://github.com/janlelis/ruby_info]
-
-
-==== Introspection
-
-* Improved lookup path inspection: method_locator[https://github.com/ryanlecompte/method_locator]
-* Displays a method's source: method_source[https://github.com/banister/method_source]
-* Adds a +ri+ doc method to Object: [ori[https://github.com/dadooda/ori]
-* Finds the methods that turned a value into another value: methodfinder[https://github.com/citizen428/methodfinder]
-* Syntax highlighting: coderay[https://github.com/rubychan/coderay]
-* <b>irbtools-more</b> Awesome lookup path inspection: looksee[https://github.com/oggy/looksee]
-* <b>irbtools-more</b> Useful "did you mean?" suggestions in stack-traces: did_you_mean[https://github.com/yuki42/did_you_mean]
-
-
-==== Code Organization
-
-* Command/task framework similar to rake and thor: boson[http://tagaholic.me/boson/]
-* Shortcuts for your favorite methods, saved in personal yaml file: alias[http://tagaholic.me/2009/07/07/alias-quickness-in-the-ruby-console.html]
-
-
-=== Irbtools Methods
-==== From every_day_irb
-
-[ls]     Returns an array with the directory's content
-[cat]    Shortcut for <tt>File.read</tt>
-[rq]     Shortcut for <tt>require library.to_s</tt> (allows concise syntax like <tt>rq:mathn</tt>)
-[ld]     Shortcut for <tt>load library.to_s + '.rb'</tt>
-[rrq/rerequire] Little hack for rerequiring a library (it's really hack and not reliable, but works in most cases)
-[reset!] Restarts IRB
-[clear]  Clears the terminal (<tt>system "clear"</tt>)
-[session_history] Returns all issued commands as a string
-
-
-==== From irbtools in conjunction with the libraries
-
-[cd]      Improves the cd that is already provided by *fileutils* (try <tt>cd '-'</tt>)
-[version] Displays RubyVersion
-[engine]  Displays RubyEngine
-[os]      OS information
-[info]    Aggregates information about your Ruby environment
-[copy]    Shortcut for <tt>Clipboard.copy</tt>
-[paste]   Shortcut for <tt>Clipboard.paste</tt>
-[copy_input]  Copies the session_history to the clipboard
-[copy_output] Copies this session's results to the clipboard
-[mf]      Shortcut for using the *methodfinder*
-[page]    Shortcut for using the pager from *hirb*
-[colorize] Syntax highlights a ruby string using *coderay*
-[ray]      Syntax highlights a ruby file using *coderay*
-
-
-==== From the libraries (puplic Object methods, renamed/patched)
-
-[ri]     Patching the +ri+ provided by *ori* to also allow default ri syntax on toplevel
-[src]    Shortcut for displaying the method source using *method_source* and *coderay*
-[mlp]    Shortcut for the *method_locator*
-[l/lp]   Alternative method name to trigger the *looksee* gem (<b>irbtools-more</b>)
-
-
-== Advanced tweaking
-=== Customize libraries to load
-
-It is possible to modify, which libraries to load:
-
-  # Don't require 'irbtools', but:
-  require 'irbtools/configure'
-  # Here you can modify the libraries using the methods below
-  Irbtools.start
-
-If you do not want to load the default set of *irbtools* gems, you will have to use <tt>require 'irbtools/minimal'</tt> instead of <tt>configure</tt>.
-
-You can use the following methods:
-
-* <tt>Irbtools.add_library(lib, options_hash, &block)</tt>
-* <tt>Irbtools.remove_library(lib)</tt>
-
-The <tt>options_hash</tt> defines the way in which *irbtools* loads the library. The following options are possible
-[(no options)/<tt>:start</tt>] The library is required on startup before doing anything else (before displaying the prompt)
-[<tt>:thread => identifier</tt>] After loading everything else, the library is required in a thread (while continuing loading). You can choose any identifier, but if you take the same one for multiple libraries, they will be loaded in the same thread (in the order that you define)
-[<tt>:late => true</tt>] The library is required just before showing the prompt (note: loading threads might still be in process)
-[<tt>:late_thread => identifier</tt>] Same as <tt>:thread</tt>, but after loading late libraries.
-[<tt>:sub_session => true</tt>] The library is loaded every time a sub-session starts (using <tt>IRB.conf[:IRB_RC]</tt>). In ripl[https://github.com/cldwalker/ripl], <tt>ripl-after_rc</tt> is used.
-[<tt>:autoload => :Constant</tt>] Use Ruby's <tt>autoload</tt> feature. It loads the library as soon as the constant is encountered.
-
-You can pass a block as third argument, which gets executed after the library has completed loading (except for <tt>:autoload</tt>, in which case the code will be executed directly on startup). You can modify the callbacks by using <tt>Irbtools.add_library_callback</tt> and <tt>Irbtools.replace_library_callback</tt>.
-
-When adding a new library, you should firstly consider some way to load it via <tt>:autoload</tt>.
-If this is not possible, try loading via <tt>:thread</tt>. If that is not possible either, you will need to fallback to the default loading mechanism.
-
-
-== Troubleshooting: Unicode causes wrong display widths?
-
-If you use double-width unicode characterss, you will need to paste the following snippet to your <tt>.irbrc</tt> file.
-
-  Irbtools.replace_library_callback :fancy_irb do
-    FancyIrb.start east_asian_width: true
-  end
-
-This setting is deactivated by default, because of performance issues.
-
-
-== Hint: Faster start-up
-
-You can get an about a second faster start-up time by changing the loading methods for wirb and fancy_irb to <tt>:thread</tt> (drawback: the hash rocket will not be used for the first result):
-
-  require 'irbtools/configure'
-  Irbtools.remove_library :paint
-  Irbtools.remove_library :fancy_irb
-  Irbtools.add_library :paint, :late => true do Wirb.load_schema :classic_paint if defined? Wirb end
-  Irbtools.add_library :fancy_irb, :thread => -1 do FancyIrb.start end
-  Irbtools.start
-
-
-== Welcome Message
-
-The welcome message can be customized with <tt>Irbtools.welcome_message=</tt>
-
-
-== Web Console
-
-*irbtools* works well together with the amazing {web-console!}[https://github.com/rails/web-console]
-
-
-== J-_-L
-
-Copyright (c) 2010-2015 Jan Lelis <http://janlelis.com> released under the MIT license.