irbtools 0.8.8 → 1.0.0

data/CHANGELOG

@@ -1,3 +1,11 @@
+1.0.0
+* gemify general helpers/rvm stuff ("every_day_irb", "rvm_loader")
+* 6 different loading schemas: start, thread, autoload, sub_session, late, late_thread
+  * load almost every feature via threads
+* don't use zucker/alias_for, autload zucker/env (except zucker/os) for performance reasons
+* add irbtools/minimal mode for starting Irbtools without the default set of libraries
+* replace RV and RE with rv and re
+
 0.8.8
 * fix 0.8.7 file permissions
 * add methodfinder gem

data/README.rdoc

@@ -1,20 +1,17 @@
 = irbtools
-
-This is a meta gem which installs some useful irb gems and configures your irb.
+This is a meta gem that installs useful irb gems and configures your irb. It has a modular structure and supports multiple library-loading mechanisms, e.g. via <tt>autoload</tt> or threads.
 
 == Setup
-
   gem install irbtools
   
-* On Linux, you also need +xclip+: sudo <tt>apt-get install xclip</tt>
-* On Windows, you need ansicon[https://github.com/adoxa/ansicon]
+* On Linux, you need +xclip+ or +xsel+ to use the clipboard: sudo <tt>apt-get install xclip</tt>
+* On Windows, you need ansicon[https://github.com/adoxa/ansicon] to enjoy all the colors
 * On MacOS, you will need growl, if you want to use the +g+ gem.
 
 === Wrong display widths?
 When using double-width unicode chars, you should need to pass the <tt>:east_asian_width = true</tt> when starting <tt>FancyIrb</tt>. It is deactivated because of performance issues.
 
 == Usage
-
 To use it, put the following in your <tt>~/.irbrc</tt> file (this file is loaded every time you start an irb):
 
   require 'rubygems' unless defined? Gem # rubygems is only needed in 1.8
@@ -27,36 +24,52 @@ It's possible to modify, which libraries get loaded:
   # don't require 'irbtools'
   require 'irbtools/configure'
   # here you can modify which libraries get loaded (see below)
-  Irbtools.init
+  Irbtools.start
+
+You can also deactivate the loading of the complete default set of irbtools libraries by using <tt>require 'irbtools/minimal'</tt> instead of <tt>configure</tt>. You need to use the below methods for adding libraries in this case, or it won't modify anything of your irb ;).
 
 === Rails notes
+To use irbtools within the rails console, you will have to add irbtools to your Gemfile <b>in this way:</b> (or there will be some bundler double require issues..)
 
-To use irbtools within the rails console, you will have to add irbtools to your Gemfile.
+  gem 'irbtools', :require => 'irbtools/configure'
 
 You can put Rails specific configuration in a <tt>~/.railsrc</tt> file which gets loaded only in Rails environments.
 
 === How to load more or less libraries
-
 You have the following ways:
-* <tt>Irbtools.add_library(lib, in_proc = false, &block)</tt>
+* <tt>Irbtools.add_library(lib, options_hash, &block)</tt>
 * <tt>Irbtools.remove_library(lib)</tt>
-* <tt>Irbtools.add_package(pkg)</tt>
-* <tt>Irbtools.remove_package(pkg)</tt>
 
-You can edit the <tt>Irbtools.libraries</tt> or <tt>Irbtools.libraries_in_proc</tt> directly, but when using the <tt>add_library</tt> method, you can apply a block which gets executed after the library is loaded.
+The <tt>options_hash</tt> defines the way in which Irbtools loads the library. 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 also apply a block that gets executed after the library is loaded (except for autoload, the code will executed on startup in this case).
+
+When adding a new library, you should consider adding it via autoload, try loading it via thread if autoload is not suitable and fallback to some other method, if not via thread is not possible.
+
+See the <tt>Irbtools.libraries</tt> hash for the current Irbtools configuration that actually will be used when calling <tt>Irbtools.start</tt>.
 
 ==== Packages
-<tt>Irbtools.packages</tt> are extension packs for Irbtools, e.g. {irbtools-more}[https://github.com/janlelis/irbtools-more].
+There are irbtools extension packages, which can be modified via:
+* <tt>Irbtools.add_package(pkg)</tt>
+* <tt>Irbtools.remove_package(pkg)</tt>
 
-== Features
+These packages add/modify the libraries to be loaded. For an example, see {irbtools-more}[https://github.com/janlelis/irbtools-more].
 
+== Features
 See http://rbjl.net/40-irbtools-release-the-power-of-irb or read the commented source files.
 
 === Included gems and libraries
-
 * wirb[https://github.com/janlelis/wirb/]      colorize output
 * hirb[http://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html]     (active record) tables and custom views for specific objects
 * fancy_irb[https://github.com/janlelis/fancy_irb]   put result as comment and more colorization
+* every_day_irb[https://github.com/janlelis/irbtools/tree/master/lib/every_day_irb.rb]   helper methods that might be useful in every-day irb usage, e.g.: ls, cat, rq, rrq, ld, session_history, reset!, clear, dbg
 * clipboard[http://github.com/janlelis/clipboard]     easy clipboard access (copy & paste)
 * interactive_editor[https://github.com/jberkel/interactive_editor]    lets you open vim, hack something, and it gets loaded into the current session, also possible: yaml object editing
 * sketches[http://sketches.rubyforge.org/]   another, more flexible "start editor and it gets loaded into your irb session" plugin
@@ -71,31 +84,24 @@ See http://rbjl.net/40-irbtools-release-the-power-of-irb or read the commented s
 
 * guessmethod[http://guessmethod.rubyforge.org/]    automatically corrects typos (method_missing hook)
 
-=== Helper methods
-
-See the source for a description. These methods are defined directly by irbtools. Each gem may add its own helper methods.
-
-*General*: <tt>ls, cat, rq, rrq/rerequire, ld, session_history, reset!, clear, use_ruby/use, rubies, use_gemset/gemset, gemsets, dbg</tt>
-
-*Clipboard*: <tt>copy, paste, copy_input, copy_output</tt>
-
-*CodeRay*: <tt>colorize, ray</tt>
-
 ==== RVM
-
 If you have RVM installed, you can switch your gemset or ruby with <tt>gemset</tt> and <tt>use</tt> (use <tt>gemsets</tt> and <tt>rubies</tt> to get a list). The gemset can be changed within the session, while changing ruby starts a new one. Please also note that you need to have installed irbtools for that ruby version. I recommend installing it in the <tt>global</tt> gemset.
 
-== Welcome message
+== Hint: Faster start-up
 
-You can customize the welcome message with <tt>Irbtools.welcome_message=</tt>
+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):
 
-== Planned features for 0.9.0 (next main version - probably coming in may 2011)
+  require 'irbtools/configure'
+  Irbtools.remove_library :wirb
+  Irbtools.remove_library :fancy_irb
+  Irbtools.add_library :wirb, :thread => -1 do Wirb.start end
+  Irbtools.add_library :fancy_irb, :thread => -1 do FancyIrb.start end
+  Irbtools.start
 
-* define flexibly, whether library should be loaded on start/on subsession or via autoload
-* faster loading
+== Welcome message
+The welcome message can be customized with <tt>Irbtools.welcome_message=</tt>
 
 == Copyright
-
 Copyright (c) 2010-2011 Jan Lelis, http://rbjl.net, released under the MIT license.
 
 J-_-L

data/Rakefile

@@ -2,37 +2,37 @@ require 'rake'
 require 'rake/rdoctask'
 require 'fileutils'
 
-def gemspec
-  @gemspec ||= eval(File.read('irbtools.gemspec'), binding, 'irbtools.gemspec')
+def gemspec1
+  @gemspec1 ||= eval(File.read('irbtools.gemspec'), binding, 'irbtools.gemspec')
+end
+
+def gemspec2
+  @gemspec2 ||= eval(File.read('every_day_irb.gemspec'), binding, 'every_day_irb.gemspec')
 end
 
 desc "Build the gem"
 task :gem => :gemspec do
   sh "gem build irbtools.gemspec"
+  sh "gem build every_day_irb.gemspec"
   FileUtils.mkdir_p 'pkg'
-  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", 'pkg'
+  FileUtils.mv "#{gemspec1.name}-#{gemspec1.version}.gem", 'pkg'
+  FileUtils.mv "#{gemspec2.name}-#{gemspec2.version}.gem", 'pkg'
 end
 
 desc "Install the gem locally (without docs)"
 task :install => :gem do
-  sh %{gem install pkg/#{gemspec.name}-#{gemspec.version} --no-rdoc --no-ri}
+  sh %{gem install pkg/#{gemspec2.name}-#{gemspec2.version} --no-rdoc --no-ri}
+  sh %{gem install pkg/#{gemspec1.name}-#{gemspec1.version} --no-rdoc --no-ri}
 end
 
 desc "Generate the gemspec"
 task :generate do
-  puts gemspec.to_ruby
+  puts gemspec1.to_ruby
+  puts gemspec2.to_ruby
 end
 
 desc "Validate the gemspec"
 task :gemspec do
-  gemspec.validate
-end
-
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION').chomp : ""
-
-  rdoc.rdoc_dir = 'doc'
-  rdoc.title = "irbtools #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
+  gemspec1.validate
+  gemspec2.validate
 end

data/VERSION

@@ -1 +1 @@
-0.8.8
+1.0.0

data/irbtools.gemspec

@@ -6,26 +6,27 @@ Gem::Specification.new do |s|
   s.version = File.read('VERSION').chomp
 
   s.authors               = ["Jan Lelis"]
-  s.date                  = %q{2011-03-28}
-  s.summary               = %q{irbtools is a meta gem which installs some useful irb gems and configures your irb.}
-  s.description           = %q{irbtools is a meta gem which installs some useful irb gems and configures your irb. Simply put a require 'irbtools' in the .irbrc file in your home directory.}
-  s.email                 = %q{mail@janlelis.de}
+  s.summary               = 'irbtools is a meta gem that installs useful irb gems and configures your irb.'
+  s.description           = 'irbtools is a meta gem that installs useful irb gems and configures your irb. Simply put a require "irbtools" in the .irbrc file in your home directory.'
+  s.email                 = 'mail@janlelis.de'
   s.extra_rdoc_files      = %w[LICENSE README.rdoc]
-  s.files                 = Dir.glob(%w[lib/**/*.rb ]) + %w{VERSION CHANGELOG Rakefile irbtools.gemspec}
-  s.homepage              = %q{http://github.com/janlelis/irbtools}
+  s.files                 = %w[lib/irbtools.rb lib/irbtools/configure.rb lib/irbtools/libraries.rb lib/irbtools/minimal.rb VERSION CHANGELOG Rakefile irbtools.gemspec]
+  s.homepage              = 'http://github.com/janlelis/irbtools'
   s.required_ruby_version = '>= 1.8.7'
 
   s.add_dependency %q<fancy_irb>,     ">= 0.6.5"
-  s.add_dependency %q<zucker>,        ">= 9"
-  s.add_dependency %q<hirb>,          "~> 0.4.3"
-  s.add_dependency %q<awesome_print>, "~> 0.3.2"
-  s.add_dependency %q<clipboard>,     ">= 0.9.7"
+  s.add_dependency %q<zucker>,        ">= 10"
+  s.add_dependency %q<hirb>,          "~> 0.4.5"
+  s.add_dependency %q<awesome_print>, "~> 0.4.0"
+  s.add_dependency %q<clipboard>,     ">= 0.9.8"
   s.add_dependency %q<coderay>,       "~> 0.9"
   s.add_dependency %q<boson>,         ">= 0.3.3"
-  s.add_dependency %q<wirb>,          ">= 0.2.4"
+  s.add_dependency %q<wirb>,          ">= 0.2.6"
   s.add_dependency %q<interactive_editor>, ">= 0.0.8"
   s.add_dependency %q<ori>,           "~> 0.1.0"
   s.add_dependency %q<sketches>,      ">= 0"
   s.add_dependency %q<g>,             ">= 0"
-  s.add_dependency %q<methodfinder>,  ">= 1.2.1"
+  s.add_dependency %q<methodfinder>,  ">= 1.2.3"
+  s.add_dependency %q<rvm_loader>,    ">= 1.0.0"
+  s.add_dependency %q<every_day_irb>, ">= #{ s.version }"
 end

data/lib/irbtools.rb

@@ -18,9 +18,7 @@ if defined?(IRB) || defined?(Ripl)
   }
 
   # # # # #
-  # load libraries
-
-  # load helper proc
+  # loading helper proc
   load_libraries_proc = proc{ |libs|
     remember_verbose_and_debug = $VERBOSE, $DEBUG
     $VERBOSE = $DEBUG = false
@@ -28,9 +26,7 @@ if defined?(IRB) || defined?(Ripl)
     libs.each{ |lib|
       begin
         require lib.to_s
-
         Irbtools.send :library_loaded, lib
-
       rescue LoadError => err
         warn "Couldn't load an irb library: #{err}"
       end
@@ -38,24 +34,21 @@ if defined?(IRB) || defined?(Ripl)
     $VERBOSE, $DEBUG = remember_verbose_and_debug
   }
 
-  # load them :)
-  load_libraries_proc[ Irbtools.libraries ]
-
-  # load these each time a new sub irb starts (only if supported)
-  original_irbrc_proc = IRB.conf[:IRB_RC]
-  IRB.conf[:IRB_RC] = proc{
-    load_libraries_proc[ Irbtools.libraries_in_proc ]
-    original_irbrc_proc[ ]  if original_irbrc_proc
-  }
-
+  # # # # #
+  # load: start
+  load_libraries_proc[ Irbtools.libraries[:start] ]
 
   # # # # #
-  # general shortcuts & helper methods
-  require File.expand_path('irbtools/general', File.dirname(__FILE__) )
+  # load: autoload
+  Irbtools.libraries[:autoload].each{ |constant, lib_name, gem_name|
+    gem gem_name
+    autoload constant, lib_name
+    Irbtools.send :library_loaded, lib_name
+  }
 
   # # # # #
   # irb options
-  unless defined? Ripl
+  unless defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
     IRB.conf[:AUTO_INDENT]  = true                 # simple auto indent
     IRB.conf[:EVAL_HISTORY] = 42424242424242424242 # creates the special __ variable
     IRB.conf[:SAVE_HISTORY] = 2000                 # how many lines will go to ~/.irb_history
@@ -74,16 +67,11 @@ if defined?(IRB) || defined?(Ripl)
   end
 
   # # # # #
-  # misc
-
-  # add current directory to the load path
-  $: << '.'  if RubyVersion.is.at_least? '1.9.2'
-
-  # shorter ruby info constants
-  Object.const_set :RV, RubyVersion  rescue nil
-  Object.const_set :RE, RubyEngine   rescue nil
+  # misc: add current directory to the load path
+  $: << '.'  if RUBY_VERSION >= '1.9.2'
 
-  # load rails.rc
+  # # # # #
+  # load: rails.rc
   begin
     if  ( ENV['RAILS_ENV'] || defined? Rails ) && Irbtools.railsrc &&
         File.exist?( File.expand_path(Irbtools.railsrc) )
@@ -92,6 +80,42 @@ if defined?(IRB) || defined?(Ripl)
   rescue
   end
 
+  # # # # #
+  # load: sub-session / after_rc
+  if defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
+    if defined? Ripl::AfterRc
+      Ripl.after_rcs += Irbtools.libraries[:sub_session]
+    elsif !Irbtools.libraries[:sub_session].empty?
+      warn "Couldn't load libraries in Irbtools.libraries[:sub_session]. Please install ripl-after_rc to use this feature in Ripl!"
+    end
+  else
+    original_irbrc_proc = IRB.conf[:IRB_RC]
+    IRB.conf[:IRB_RC] = proc{
+      load_libraries_proc[ Irbtools.libraries[:sub_session] ]
+      original_irbrc_proc[ ]  if original_irbrc_proc
+    }
+  end
+
+  # # # # #
+  # load: threads
+  Irbtools.libraries[:thread].each{ |_,libs|
+    Thread.new do
+      load_libraries_proc[ libs ]
+    end
+  }
+
+  # # # # #
+  # load: late
+  load_libraries_proc[ Irbtools.libraries[:late] ]
+
+  # # # # #
+  # load: late_threads
+  Irbtools.libraries[:late_thread].each{ |_,libs|
+    Thread.new do
+      load_libraries_proc[ libs ]
+    end
+  }
+
   # # # # #
   # done :)
   if msg = Irbtools.welcome_message

data/lib/irbtools/configure.rb

@@ -5,23 +5,18 @@
 # but you could also require 'irbtools/configure' and then call Irbtools.init to modify the loaded libraries
 # see the README file for more information
 
-begin
-  require 'zucker/alias_for'
-  require 'zucker/env'       # Info, OS, RubyVersion, RubyEngine
-rescue LoadError
-  raise LoadError, "Sorry, the irbtools couldn't load, because the zucker gem is not available"
-end
-
 # # # # #
 # define module methods
 module Irbtools
+  VERSION = File.read( File.dirname(__FILE__) + '/../../VERSION' ).chomp
+
+  @libraries       = { :start => [], :sub_session => [], :autoload => [], :thread => {}, :late => [], :late_thread => {} }
   @lib_hooks       = Hash.new{|h,k| h[k] = [] }
-  @libs            = []
-  @libs_in_proc    = []
   @packages        = []
   @railsrc         = '~/.railsrc'
   @shell_name      = File.split($0)[-1].upcase
   @welcome_message = "Welcome to #{ @shell_name }. You are using #{ RUBY_DESCRIPTION }. Have fun ;)"
+  @minimal         ||= false
 
   class << self
     # message to display when starting. Set to nil to disable
@@ -30,39 +25,72 @@ module Irbtools
     # shell name (usually irb), retrieved from $0
     attr_reader :shell_name
 
-    # lets you define the path to the irbrc or deactivate this feature with nil
+    # lets you define the path to the railsrc file or deactivate this feature with nil
     attr_accessor :railsrc
 
-    # an array of the libraries which get loaded at start
-    attr_accessor :libs
-    aliases_for :libs, :libraries, :gems
-    aliases_for :libs=, :libraries=, :gems=
+    # set this to true before loading this file to deactivate loading of default libraries
+    attr_accessor :minimal
 
-    # an array of the libraries which get loaded everytime a new subirb starts (IRB.conf[:IRB_RC])
-    attr_accessor :libs_in_proc
-    aliases_for :libs_in_proc, :libraries_in_proc, :gems_in_proc
-    aliases_for :libs_in_proc=, :libraries_in_proc=, :gems_in_proc=
+    # a hash of arrays of libraries that get loaded
+    # keys determine if lib is required, required on sub-session or autoloaded
+    attr_accessor :libraries
+    alias libs libraries
+    alias libs= libraries=
+    alias gems libraries
+    alias gems= libraries=
 
-    # an array of extension packages which get loaded (e.g. irbtools-more)
+    # an array of extension packages that get loaded (e.g. irbtools-more)
     attr_accessor :packages
 
     # add a library. the block gets executed, when the library was loaded.
     # if the second param is true, it's hooked in into IRB.conf[:IRB_RC] instead of the start.
-    def add_library(lib, in_proc = false, &block)
-      libs = in_proc ? @libs_in_proc : @libs
-      libs << lib.to_s unless libs.include? lib.to_s
-
-      @lib_hooks[lib.to_s] << block if block_given?
+    def add_library(lib, options = {}, &block)
+      lib = lib.to_s
+
+      if constant = options[:autoload]
+        lib_path = File.split( lib ); lib_path.delete('.')
+        gem_name = lib_path[0] # assume that first dir in load dir is the gem name
+        if constant.is_a?(Array)
+          constant.each{ |single_constant|
+            @libraries[:autoload] << [single_constant, lib, gem_name]
+          }
+        else
+          @libraries[:autoload] << [constant, lib, gem_name]
+        end
+      elsif options[:after_rc]
+        @libraries[:after_rc] << lib
+      elsif which = options[:thread]
+        @libraries[:thread][which] ||= []
+        @libraries[:thread][which] << lib
+      elsif options[:late]
+        @libraries[:late] << lib
+      elsif which = options[:late_thread]
+        @libraries[:late_thread][which] ||= []
+        @libraries[:late_thread][which] << lib
+      else
+        @libraries[:start] << lib
+      end
+
+      @lib_hooks[lib] << block if block_given?
     end
-    aliases_for :add_library, :add_lib, :add_gem
+    alias add_lib add_library
+    alias add_gem add_library
 
     # don't load a specific library
     def remove_library(lib)
-      @libs.delete lib.to_s
-      @libs_in_proc.delete lib.to_s
-      @lib_hooks.delete lib.to_s
+      lib = lib.to_s
+
+      @libraries[:start].delete lib
+      @libraries[:sub_session].delete lib
+      @libraries[:autoload].reject!{|_,e,| e == lib }
+      @libraries[:thread].each{ |_,libs| libs.delete lib }
+      @libraries[:late].delete lib
+      @libraries[:late_thread].each{ |_,libs| libs.delete lib }
+
+      @lib_hooks.delete lib
     end
-    aliases_for :remove_library, :remove_lib, :remove_gem
+    alias remove_lib remove_library
+    alias remove_gem remove_library
 
     # add extensions packages
     def add_package(pkg)
@@ -74,7 +102,6 @@ module Irbtools
       @packages.delete pkg.to_s
     end
 
-
     def library_loaded(lib) #:nodoc:
       @lib_hooks[lib.to_s].each{ |hook| hook.call }
     end
@@ -86,13 +113,11 @@ module Irbtools
     end
     alias start init
   end
-
-  VERSION = ( File.read File.expand_path( '../../VERSION', File.dirname(__FILE__)) ).chomp
 end
 
 # # # # #
 # libraries
-require File.expand_path( 'libraries.rb', File.dirname(__FILE__) )
+require File.expand_path( 'libraries.rb', File.dirname(__FILE__) ) unless Irbtools.minimal
 
 # J-_-L
 

data/lib/irbtools/libraries.rb

@@ -1,22 +1,28 @@
 # encoding: utf-8
+# default irbtools set of libraries, you can remove any you don't like via Irbtools.remove_library
 
-# # # # #
-# require 'irbtools' in your .irbrc
-# but you could also require 'irbtools/configure' and then call Irbtools.init to modify the loaded libraries
-# see the README file for more information
+# # # load via late
 
-# the order does matter
-Irbtools.add_library :wirb do # result colors
-  Wirb.start unless OS.windows?
+unless defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
+  Irbtools.add_library :wirb, :late => true do # result colors, install ripl-color_result for ripl colorization
+    Wirb.start 
+  end
+
+  Irbtools.add_library :fancy_irb, :late => true do # put result as comment instead of a new line and colorful errors/streams
+    FancyIrb.start
+  end
 end
-Irbtools.add_library 'wirb/wp' # ap alternative
 
 
-Irbtools.add_library :fancy_irb do # put result as comment instead of a new line and colorful errors/streams
-  FancyIrb.start
-end
+# # # load via late_thread
+
+Irbtools.add_library 'wirb/wp', :late_thread => 10 # ap alternative (wp)
+
 
-Irbtools.add_library :fileutils do # cd, pwd, ln_s, mv, rm, mkdir, touch ... ;)
+# # # load via thread
+#      the :stdlib thread ensures proper loading of fileutils, yaml and tempfile
+
+Irbtools.add_library :fileutils, :thread => :stdlib do # cd, pwd, ln_s, mv, rm, mkdir, touch ... ;)
   include FileUtils::Verbose
 
   # patch cd so that it also shows the current directory
@@ -30,26 +36,89 @@ Irbtools.add_library :fileutils do # cd, pwd, ln_s, mv, rm, mkdir, touch ... ;)
         return
       end
     end
-    FileUtils.cd path
+    cd path
     @last_path = new_last_path
     ls
   end
+end
+
+# tables, menus...
+Irbtools.add_library :hirb, :thread => :stdlib do
+  Hirb::View.enable
+  extend Hirb::Console
+  Hirb::View.formatter.add_view 'Object', :ancestor => true, :options => { :unicode => true } # unicode tables
+end
+
+# command framework
+Irbtools.add_library :boson, :thread => :stdlib do
+  undef install if respond_to?( :install, true )
+  undef menu    if respond_to?( :menu, true )
+  Boson.start :verbose => false
+end
+
+# ls, cat, rq, rrq, ld, session_history, reset!, clear, dbg, ...
+Irbtools.add_library 'every_day_irb', :thread => 10 
+
+# nice debug printing (q, o, c, .m, .d)
+Irbtools.add_library 'zucker/debug', :thread => 20
+
+# nice debug printing (ap)
+Irbtools.add_library 'ap', :thread => 30
+
+# nice debug printing (g)
+Irbtools.add_library 'g', :thread => 40 if RbConfig::CONFIG['host_os'] =~ /mac|darwin/
+
+# lets you open vim (or your favourite editor), hack something, save it, and it's loaded in the current irb session
+Irbtools.add_library 'interactive_editor', :thread => :stdlib
+
+# another, more flexible "start editor and it gets loaded into your irb session" plugin
+Irbtools.add_library 'sketches', :thread => :stdlib    
+
+# object oriented ri method
+Irbtools.add_library :ori, :thread => 50 do
+  class Object
+    # patch ori to also allow shell-like "Array#slice" syntax
+    def ri(*args)
+      if  args[0] &&
+          self == TOPLEVEL_BINDING.eval('self') &&
+          args[0] =~ /\A(.*)(?:#|\.)(.*)\Z/
+        begin
+          klass = Object.const_get $1
+          klass.ri $2
+        rescue
+          super
+        end
+      else
+        super
+      end
+    end
+  end
+end
+
 
+# # # load via autoload
+
+# useful information pseudo-constants
+Irbtools.add_library 'zucker/env', :autoload => [:RubyVersion, :RubyEngine, :Info, :OS] do
+  def rv() RubyVersion end unless defined? rv
+  def re() RubyEngine  end unless defined? re
 end
 
-Irbtools.add_library :coderay do
-  # syntax highlight a string
+# syntax highlight
+Irbtools.add_library :coderay, :autoload => :CodeRay do
+  # ...a string
   def colorize(string)
     puts CodeRay.scan( string, :ruby ).term
   end
 
-  # syntax highlight a file
+  # ...a file
   def ray(path)
     print CodeRay.scan( File.read(path), :ruby ).term
   end
 end
 
-Irbtools.add_library :clipboard do # access the clipboard
+# access the clipboard
+Irbtools.add_library :clipboard, :autoload => :Clipboard do
   # copies the clipboard
   def copy(str)
     Clipboard.copy(str)
@@ -75,65 +144,65 @@ Irbtools.add_library :clipboard do # access the clipboard
   alias copy_session_output copy_output
 end
 
-Irbtools.add_library 'zucker/debug' # nice debug printing (q, o, c, .m, .d)
-Irbtools.add_library 'ap'           # nice debug printing (ap)
-Irbtools.add_library 'yaml'         # nice debug printing (y)
-Irbtools.add_library 'g'            # nice debug printing (g) - MacOS only :/
-#Irbtools.add_library 'guessmethod', true   # automatically correct typos (method_missing hook)
-Irbtools.add_library 'interactive_editor'  # lets you open vim (or your favourite editor), hack something, save it, and it's loaded in the current irb session
-Irbtools.add_library 'sketches'            # another, more flexible "start editor and it gets loaded into your irb session" plugin
-
-Irbtools.add_library :boson do
-  undef :install if respond_to?( :install, true )
-  Boson.start :verbose => false
+# small-talk like method finder
+Irbtools.add_library :methodfinder, :autoload => :MethodFinder do
+  MethodFinder::INSTANCE_METHOD_BLACKLIST[:Object] += [:ri, :vi, :vim, :emacs, :nano, :mate, :mvim, :ed, :sketch]
+  
+  def mf(*args, &block)
+    args.empty? ? MethodFinder : MethodFinder.find(*args, &block)
+  end
 end
 
-Irbtools.add_library :hirb do
-  Hirb::View.enable
-  extend Hirb::Console
-  Hirb::View.formatter.add_view 'Object', :ancestor => true, :options => { :unicode => true } # unicode tables
-end
+# rvm helpers
+Irbtools.add_library 'rvm_loader', :autoload => :RVM do
+  def rubies
+    RVM.current.list_strings
+  end
 
-Irbtools.add_library :ori do
-  class Object
-    # patch ori to also allow shell-like "Array#slice" syntax
-    def ri(*args)
-      if  args[0] &&
-          self == TOPLEVEL_BINDING.eval('self') &&
-          args[0] =~ /\A(.*)(?:#|\.)(.*)\Z/
-        begin
-          klass = Object.const_get $1
-          klass.ri $2
-        rescue
-          super
+  def use(which = nil) # TODO with gemsets?
+    # show current ruby if called without options
+    if !which
+      return RVM.current.environment_name[/^.*@|.*$/].chomp('@')
+    end
+
+    # start ruby :)
+    begin
+      RVM.use! which.to_s
+    rescue RVM::IncompatibleRubyError => err
+      err.message =~ /requires (.*?) \(/
+      rubies = RVM.current.list_strings
+      if rubies.include? $1
+        # remember history...
+        run_irb = proc{ exec "#{ $1 } -S #{ $0 }" } 
+        if defined?(Ripl) && Ripl.respond_to?(:started?) && Ripl.started?
+          Ripl.shell.write_history if Ripl.shell.respond_to? :write_history
+          run_irb.call
+        else
+          at_exit(&run_irb)
+          exit
         end
       else
-        super
+        warn "Sorry, that Ruby version could not be found (see rubies)!"
       end
     end
   end
-end
+  alias use_ruby use
 
-Irbtools.add_library :methodfinder do
-  MethodFinder::INSTANCE_METHOD_BLACKLIST[:Object] += [:ri, :vi, :vim, :emacs, :nano, :mate, :mvim, :ed, :sketch]
-  
-  def mf(*args, &block)
-    args.empty? ? MethodFinder : MethodFinder.find(*args, &block)
+  def gemsets
+    RVM.current.gemset.list
   end
-end
-
-
-# remove failing/not needed libs
-if OS.windows?
-  Irbtools.libraries -= %w[coderay]
-end
-
-unless OS.mac?
-  Irbtools.libraries -= %w[g]
-end
 
-if defined? Ripl
-  Irbtools.libraries -= %w[wirb fancy_irb] # install ripl-color_result for ripl colorization ;)
+  def gemset(which = nil)
+    if which
+      if RVM.current.gemset.list.include? which.to_s
+        RVM.use! RVM.current.environment_name.gsub(/(@.*?$)|$/, "@#{ which }")
+      else
+        warn "Sorry, that gemset could not be found (see gemsets)!"
+      end
+    end
+    RVM.current.gemset_name
+  end
+  alias use_gemset gemset
 end
 
 # J-_-L

data/lib/irbtools/minimal.rb

@@ -0,0 +1,9 @@
+# require this file (instead of configure) to deactivate loading of default set of libraries
+
+module Irbtools
+  @minimal = true
+end
+
+require File.expand_path( 'configure.rb', File.dirname(__FILE__) ) 
+
+# J-_-L

metadata

@@ -2,7 +2,7 @@
 name: irbtools
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.8.8
+  version: 1.0.0
 platform: ruby
 authors: 
 - Jan Lelis
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-28 00:00:00 Z
+date: 2011-05-18 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: fancy_irb
@@ -31,7 +31,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "9"
+        version: "10"
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
@@ -42,7 +42,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.4.3
+        version: 0.4.5
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
@@ -53,7 +53,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.3.2
+        version: 0.4.0
   type: :runtime
   version_requirements: *id004
 - !ruby/object:Gem::Dependency 
@@ -64,7 +64,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.9.7
+        version: 0.9.8
   type: :runtime
   version_requirements: *id005
 - !ruby/object:Gem::Dependency 
@@ -97,7 +97,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.2.4
+        version: 0.2.6
   type: :runtime
   version_requirements: *id008
 - !ruby/object:Gem::Dependency 
@@ -152,10 +152,32 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.1
+        version: 1.2.3
   type: :runtime
   version_requirements: *id013
-description: irbtools is a meta gem which installs some useful irb gems and configures your irb. Simply put a require 'irbtools' in the .irbrc file in your home directory.
+- !ruby/object:Gem::Dependency 
+  name: rvm_loader
+  prerelease: false
+  requirement: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id014
+- !ruby/object:Gem::Dependency 
+  name: every_day_irb
+  prerelease: false
+  requirement: &id015 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id015
+description: irbtools is a meta gem that installs useful irb gems and configures your irb. Simply put a require "irbtools" in the .irbrc file in your home directory.
 email: mail@janlelis.de
 executables: []
 
@@ -166,10 +188,9 @@ extra_rdoc_files:
 - README.rdoc
 files: 
 - lib/irbtools.rb
-- lib/irbtools/libraries.rb
-- lib/irbtools/general.rb
 - lib/irbtools/configure.rb
-- lib/irbtools/rvm.rb
+- lib/irbtools/libraries.rb
+- lib/irbtools/minimal.rb
 - VERSION
 - CHANGELOG
 - Rakefile
@@ -199,9 +220,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.7.2
+rubygems_version: 1.8.1
 signing_key: 
 specification_version: 3
-summary: irbtools is a meta gem which installs some useful irb gems and configures your irb.
+summary: irbtools is a meta gem that installs useful irb gems and configures your irb.
 test_files: []
 

data/lib/irbtools/general.rb

@@ -1,125 +0,0 @@
-# shows the contents of your current directory (more such commands available by FileUtils)
-def ls(path='.')
-  Dir[ File.join( path, '*' )].map{|res| res =~ /^#{path}\/?/; $' }
-end
-alias dir ls
-
-# read file contents (also see ray for ruby source files ;) )
-def cat(path)
-  File.read path
-end
-
-# allows concise syntax like rq:mathn and reloading/requireing
-def rq(lib)
-  require lib.to_s
-end
-
-# rerequire, please note: can have non-intended side effects
-def rerequire(lib)
-  $".dup.grep(/#{lib}\.rb$/).each{ |path|
-    $".delete path.to_s
-    require path.to_s
-  }
-  require lib.to_s
-  true
-end
-alias rrq rerequire
-
-# load shortcut
-def ld(lib)
-  load lib.to_s + '.rb'
-end
-
-# returns the last lines, needed for some copy_ methods
-def session_history(number_of_lines = nil)
-  if !number_of_lines
-    if defined?(Ripl) && Ripl.instance_variable_get(:@shell) # ripl is running
-      number_of_lines = Ripl.shell.line
-    else
-      number_of_lines = context.instance_variable_get(:@line_no)
-    end
-  end
-  Readline::HISTORY.entries[-number_of_lines...-1]*"\n"
-end
-
-# restart irb
-def reset!
-  # remember history...
-  reset_irb = proc{ exec$0 } 
-  if defined?(Ripl) && Ripl.instance_variable_get(:@shell) # ripl is running
-    Ripl.shell.write_history if Ripl.shell.respond_to? :write_history
-    reset_irb.call
-  else
-    at_exit(&reset_irb)
-    exit
-  end
-end
-
-# just clear the screen
-def clear
-  system 'clear'
-end
-
-# change ruby version (requires rvm)
-autoload :RVM, 'irbtools/rvm'
-
-def rubies
-  RVM.current.list_strings
-end
-
-def use(which = nil) # TODO with gemsets?
-  # show current ruby if called without options
-  if !which
-    return RVM.current.environment_name[/^.*@|.*$/].chomp('@')
-  end
-
-  # start ruby :)
-  begin
-    RVM.use! which.to_s
-  rescue RVM::IncompatibleRubyError => err
-    err.message =~ /requires (.*?) \(/
-    rubies = RVM.current.list_strings
-    if rubies.include? $1
-      # remember history...
-      run_irb = proc{ exec "#{ $1 } -S #{ $0 }" } 
-      if defined?(Ripl) && Ripl.instance_variable_get(:@shell) # ripl is running
-        Ripl.shell.write_history if Ripl.shell.respond_to? :write_history
-        run_irb.call
-      else
-        at_exit(&run_irb)
-        exit
-      end
-    else
-      warn "Sorry, that Ruby version could not be found (see rubies)!"
-    end
-  end
-end
-alias use_ruby use
-
-def gemsets
-  RVM.current.gemset.list
-end
-
-def gemset(which = nil)
-  if which
-    if RVM.current.gemset.list.include? which.to_s
-      RVM.use! RVM.current.environment_name.gsub /(@.*?$)|$/, "@#{ which }"
-    else
-      warn "Sorry, that gemset could not be found (see gemsets)!"
-    end
-  end
-  RVM.current.gemset_name
-end
-alias use_gemset gemset
-
-# load debugger, inspired by rdp
-def dbg
-  begin
-    require 'ruby-debug'
-    debugger
-  rescue LoadError => err
-    throw "Sorry, unable to load ruby-debug gem for debugger: #{err}"
-  end
-end
-
-# J-_-L

data/lib/irbtools/rvm.rb

@@ -1,8 +0,0 @@
-# test if installed
-unless rvm_path = ENV['rvm_path']
-  raise 'Ruby Version Manager must be installed to use this command'
-end
-
-# load rvm ruby api
-$LOAD_PATH.unshift File.join(rvm_path, 'lib')
-require 'rvm'