nuggets 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5770eebf6f2e382109a635d9f45c9855158c5a31
-  data.tar.gz: 6894e3ab73e1b9c743b2af81e76f15003e6a5311
+  metadata.gz: b0b959bddb4e1b2d928bcb059f1ea972929212ba
+  data.tar.gz: 21aa2cb33d3d74c60fcc464c8be1daf8048b0d4b
 SHA512:
-  metadata.gz: 1118fc142d9093d67e5e4269f7988abfbbae0d9404d120150d30b6836b6e208517f1361b55c9e44146530a54bd1cfcc57964ae6a2cc297e5f2480ce236956583
-  data.tar.gz: 96225bab56c69d06f0701e787ae6d123d383aebd6564874d0ff8f5e094a28c83561acd759b74efb2cdee512e221e1cb5a953963026af728d2061b5755bd5fa06
+  metadata.gz: 8ecfb6dcc2afadaf74e24823fa679a54ce178a1312b3e16aad6d5149a5354ab6be1031e29683049667bf162d37b8bbe41e0ab83f79d80b4d10446b2dc3b5aa39
+  data.tar.gz: 2f24ba68b5046c446abdc1352170009ad2b15a55b116a3cdea96fb5b633d20bc41d6109f9606dc0f4b6276524d509709c1192163f30118c70bbd2d88bbc21f96

data/ChangeLog

@@ -2,6 +2,12 @@
 
 = Revision history for nuggets
 
+== 1.2.0 [2015-03-13]
+
+* Extracted Nuggets::RubyMixin from Nuggets::Ruby.
+* Added Net::SSH::Connection::Session#exec_sudo.
+* Added Hash.deproc.
+
 == 1.1.0 [2014-11-26]
 
 * Nuggets::LogParser::Rails no longer <tt>eval</tt>s the params hash; set the

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to nuggets version 1.1.0.
+This documentation refers to nuggets version 1.2.0.
 
 
 == DESCRIPTION
@@ -58,7 +58,7 @@ Travis CI::     https://travis-ci.org/blackwinter/nuggets
 
 == LICENSE AND COPYRIGHT
 
-Copyright (C) 2007-2014 Jens Wille
+Copyright (C) 2007-2015 Jens Wille
 
 nuggets is free software: you can redistribute it and/or modify it
 under the terms of the GNU Affero General Public License as published by

data/Rakefile

@@ -40,7 +40,7 @@ task 'spec:isolated' do
   }
 end
 
-if RUBY_PLATFORM == 'java'
+if RUBY_ENGINE == 'jruby'
   task spec: :enable_objspace
 
   task :enable_objspace do

data/lib/nuggets/enumerable/all_any_extended.rb

@@ -1,66 +1,5 @@
-#--
-###############################################################################
-#                                                                             #
-# nuggets -- Extending Ruby                                                   #
-#                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# nuggets 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.                                                          #
-#                                                                             #
-# nuggets 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 nuggets. If not, see <http://www.gnu.org/licenses/>.             #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/enumerable/all_any_extended_mixin'
 
-module Enumerable
-
-  alias_method :_nuggets_original_all?, :all?
-  alias_method :_nuggets_original_any?, :any?
-
-  # call-seq:
-  #   enum.all?(obj[, operator]) => +true+ or +false+
-  #   enum.all? { ... } => +true+ or +false+
-  #
-  # Adds the ability to pass an +object+ instead of a block, which will then
-  # be tested against each item in _enum_ according to +operator+, defaulting
-  # to <tt>:===</tt>.
-  def all?(object = default = true, operator = :===, &block)
-    _nuggets_original_all?(&_block_for_all_any_extended(object, default, operator, &block))
-  end
-
-  # call-seq:
-  #   enum.any?(obj[, operator]) => +true+ or +false+
-  #   enum.any? { ... } => +true+ or +false+
-  #
-  # Adds the ability to pass an +object+ instead of a block, which will then
-  # be tested against each item in _enum_ according to +operator+, defaulting
-  # to <tt>:===</tt>.
-  def any?(object = default = true, operator = :===, &block)
-    _nuggets_original_any?(&_block_for_all_any_extended(object, default, operator, &block))
-  end
-
-  private
-
-  # Common argument processing for extended versions of #all? and #any?.
-  def _block_for_all_any_extended(object, default, operator, &block)
-    unless default
-      raise ::ArgumentError, 'both block and object argument given', caller(1) if block
-      lambda { |*a| object.send(operator, *a) }
-    else
-      block
-    end
-  end
-
-end
+[Array, Hash, IO, Range].each { |klass|
+  klass.send klass.respond_to?(:prepend) ? :prepend : :include, Nuggets::Enumerable::AllAnyExtendedMixin
+}

data/lib/nuggets/enumerable/all_any_extended_mixin.rb

@@ -0,0 +1,65 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2014 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets 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.                                                          #
+#                                                                             #
+# nuggets 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 nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  module Enumerable
+    module AllAnyExtendedMixin
+
+  # call-seq:
+  #   enum.all?(obj[, operator]) => +true+ or +false+
+  #   enum.all? { ... } => +true+ or +false+
+  #
+  # Adds the ability to pass an +object+ instead of a block, which will then
+  # be tested against each item in _enum_ according to +operator+, defaulting
+  # to <tt>:===</tt>.
+  def all?(object = default = true, operator = :===, &block)
+    super(&_block_for_all_any_extended(object, default, operator, &block))
+  end
+
+  # call-seq:
+  #   enum.any?(obj[, operator]) => +true+ or +false+
+  #   enum.any? { ... } => +true+ or +false+
+  #
+  # Adds the ability to pass an +object+ instead of a block, which will then
+  # be tested against each item in _enum_ according to +operator+, defaulting
+  # to <tt>:===</tt>.
+  def any?(object = default = true, operator = :===, &block)
+    super(&_block_for_all_any_extended(object, default, operator, &block))
+  end
+
+  private
+
+  # Common argument processing for extended versions of #all? and #any?.
+  def _block_for_all_any_extended(object, default, operator, &block)
+    default ? block : begin
+      raise ::ArgumentError, 'both block and object argument given', caller(1) if block
+      lambda { |*a| object.send(operator, *a) }
+    end
+  end
+
+    end
+  end
+end

data/lib/nuggets/hash/deproc.rb

@@ -0,0 +1,5 @@
+require 'nuggets/hash/deproc_mixin'
+
+class Hash
+  include Nuggets::Hash::DeprocMixin
+end

data/lib/nuggets/hash/deproc_mixin.rb

@@ -0,0 +1,79 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2015 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets 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.                                                          #
+#                                                                             #
+# nuggets 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 nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Hash
+    module DeprocMixin
+
+  # call-seq:
+  #   hash.deproc -> aProc
+  #   hash.deproc { |proc| ... } -> anObject
+  #
+  # Removes the default proc from _hash_. If a block is given, yields the proc
+  # to the block, restores the default proc afterwards and returns the block's
+  # return value. Otherwise, returns the proc.
+  #
+  # Example:
+  #
+  #   h = Hash.new { |h, k| h[k] = [] }
+  #   h.deproc { |_h| Marshal.dump(_h) }  #=> ...dump data...
+  #   h.default_proc  #=> #<Proc:...>
+  #
+  # NOTE: Requires Ruby >= 2.0
+  def deproc
+    default_proc, self.default_proc = self.default_proc, nil
+    return default_proc unless block_given?
+
+    begin
+      yield self
+    ensure
+      self.default_proc = default_proc
+    end
+  end
+
+  # call-seq:
+  #   hash.deproc! -> _hash_ or nil
+  #
+  # Removes the default proc from _hash_, if present, and returns _hash_.
+  # Otherwise, returns +nil+.
+  #
+  # Example:
+  #
+  #   h = Hash.new { |h, k| h[k] = [] }
+  #   Marshal.dump(h.deproc!)  #=> ...dump data...
+  #   h.default_proc  #=> nil
+  #
+  # NOTE: Requires Ruby >= 2.0
+  def deproc!
+    return unless default_proc
+
+    self.default_proc = nil
+    self
+  end
+
+    end
+  end
+end

data/lib/nuggets/io/null_mixin.rb

@@ -3,7 +3,7 @@
 #                                                                             #
 # nuggets -- Extending Ruby                                                   #
 #                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
+# Copyright (C) 2007-2014 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@gmail.com>                                       #
@@ -24,11 +24,13 @@
 ###############################################################################
 #++
 
+require 'nuggets/ruby_mixin'
+
 module Nuggets
   class IO
     module NullMixin
 
-      NULL = case ::RUBY_PLATFORM
+      NULL = case RubyMixin::RUBY_PLATFORM
         when /mswin|mingw/i then 'NUL'
         when /openvms/i     then 'NL:'
         when /amiga/i       then 'NIL:'

data/lib/nuggets/module/lazy_attr_mixin.rb

@@ -31,13 +31,11 @@ module Nuggets
     module LazyAttrMixin
 
   def lazy_accessor(name, options = {}, &block)
-    attr_accessor(lazy_name(name, options))
-    lazy_reader(name, options, &block)
+    attr_writer(attr = lazy_name(name, options))
+    lazy_reader(name, options, attr, &block)
   end
 
-  def lazy_reader(name, options = {}, &block)
-    attr = lazy_name(name, options)
-
+  def lazy_reader(name, options = {}, attr = lazy_name(name, options), &block)
     define_method(name) { lazy_attr(attr,
       options.fetch(:freeze, true), &block) }
   end

data/lib/nuggets/net/ssh.rb

@@ -0,0 +1,45 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2015 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets 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.                                                          #
+#                                                                             #
+# nuggets 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 nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+require 'net/ssh'
+
+class Net::SSH::Connection::Session
+
+  def exec_sudo(command, prompt = /password/, &block)
+    block ||= lambda { |data| ask(data) { |q| q.echo = false } }
+
+    open_channel { |ch|
+      ch.request_pty
+
+      ch.exec("sudo #{command}") { ch.on_data { |_, data|
+        ch.send_data("#{block[data]}\n") if data =~ prompt
+      } }
+
+      ch.wait
+    }
+  end
+
+end

data/lib/nuggets/ruby.rb

@@ -24,199 +24,20 @@
 ###############################################################################
 #++
 
-require 'rbconfig'
+require 'nuggets/ruby_mixin'
 
 module Nuggets
-
-  # Originally based on Phusion Passenger's
-  # {PlatformInfo}[https://github.com/FooBarWidget/passenger/blob/release-3.0.2/lib/phusion_passenger/platform_info/ruby.rb]
-  # module.
-  #
-  #--
-  # Phusion Passenger - http://www.modrails.com/
-  # Copyright (c) 2010 Phusion
-  #
-  # "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
-  #
-  # Permission is hereby granted, free of charge, to any person obtaining a
-  # copy of this software and associated documentation files (the "Software"),
-  # to deal in the Software without restriction, including without limitation
-  # the rights to use, copy, modify, merge, publish, distribute, sublicense,
-  # and/or sell copies of the Software, and to permit persons to whom the
-  # Software is furnished to do so, subject to the following conditions:
-  #
-  # The above copyright notice and this permission notice shall be included in
-  # all copies or substantial portions of the Software.
-  #++
-
   module Ruby
 
+    include RubyMixin
     extend self
 
-    CONFIG = ::RbConfig::CONFIG
-
-    # Store original $GEM_HOME value so that even if the app customizes
-    # $GEM_HOME we can still work with the original value.
-    if gem_home = ::ENV['GEM_HOME']
-      gem_home = gem_home.strip.freeze
-      gem_home = nil if gem_home.empty?
-    end
-
-    GEM_HOME = gem_home
-
-    RUBY_ENGINE = defined?(::RUBY_ENGINE) ? ::RUBY_ENGINE : 'ruby'
-
-    OSX_RUBY_RE = %r{\A/System/Library/Frameworks/Ruby.framework/Versions/.*?/usr/bin/ruby\Z}
-
-    # Returns correct command for invoking the current Ruby interpreter.
-    def ruby_command
-      defined?(@ruby_command) ? @ruby_command : @ruby_command = ruby_executable
-    end
-
-    attr_writer :ruby_command
-
-    # Returns the full path to the current Ruby interpreter's executable file.
-    # This might not be the actual correct command to use for invoking the Ruby
-    # interpreter; use ruby_command instead.
-    def ruby_executable
-      @ruby_executable ||= begin
-        dir, name, ext = CONFIG.values_at(*%w[bindir RUBY_INSTALL_NAME EXEEXT])
-        ::File.join(dir, name + ext).sub(/.*\s.*/m, '"\&"')
-      end
-    end
-
-    attr_writer :ruby_executable
-
-    # Locates a Ruby tool command +name+, e.g. 'gem', 'rake', 'bundle', etc. Instead
-    # of naively looking in $PATH, this function uses a variety of search heuristics
-    # to find the command that's really associated with the current Ruby interpreter.
-    # It should never locate a command that's actually associated with a different
-    # Ruby interpreter.
-    #
-    # NOTE: The return value may not be the actual correct invocation for the tool.
-    # Use command_for_ruby_tool for that.
-    #
-    # Returns +nil+ when nothing's found.
-    def locate_ruby_tool(name, extensions = ['', CONFIG['EXEEXT']].compact.uniq)
-      # Deduce Ruby's --program-prefix and --program-suffix from its install name
-      # and transform the given input name accordingly.
-      #
-      #   "rake" => "jrake", "rake1.8", etc.
-      [name, CONFIG['RUBY_INSTALL_NAME'].sub('ruby', name)].uniq.each { |basename|
-        extensions.each { |ext|
-          result = locate_ruby_tool_by_basename(basename + ext) and return result
-        }
-      }
-
-      nil
-    end
-
-    # Returns the correct command string for invoking the +name+ executable
-    # that belongs to the current Ruby interpreter. Returns +nil+ if the
-    # command is not found.
-    #
-    # If the command executable is a Ruby program, then we need to run it
-    # in the correct Ruby interpreter just in case the command doesn't
-    # have the correct shebang line; we don't want a totally different
-    # Ruby than the current one to be invoked.
-    def command_for_ruby_tool(name)
-      filename = respond_to?(name) ? send(name) : locate_ruby_tool(name)
-      shebang_command(filename) =~ /ruby/ ? "#{ruby_command} #{filename}" : filename
-    end
-
-    def self.define_ruby_tool(name)
-      class_eval <<-EOT, __FILE__, __LINE__ + 1
-        def #{name}
-          @#{name} ||= locate_ruby_tool('#{name}')
-        end
-
-        attr_writer :#{name}
-
-        def #{name}_command
-          @#{name}_command ||= command_for_ruby_tool('#{name}')
-        end
-
-        attr_writer :#{name}_command
-      EOT
-    end
-
-    %w[gem rake rspec].each { |name| define_ruby_tool(name) }
-
-    def ruby_options_to_argv(args, ruby_command = ruby_command())
-      argv = [ruby_command]
-
-      ruby_options_from_hash(args.pop, argv) if args.last.is_a?(::Hash)
-
-      argv.concat(args.map! { |arg| arg.to_s.strip })
-    end
-
-    def ruby_options_from_hash(hash, argv = [])
-      hash.each { |key, val|
-        opt = "-#{key.to_s[0, 1]}"
-
-        if val.is_a?(::Array)
-          val.each { |v| argv << opt << v.to_s }
-        elsif opt == '-e'
-          argv << opt << val.to_s
-        elsif val != false
-          argv << "#{opt}#{val unless val == true}"
-        end
-      }
-
-      argv
-    end
-
-    private
-
-    def locate_ruby_tool_by_basename(name)
-      # On OS X we must look for Ruby binaries in /usr/bin.
-      # RubyGems puts executables (e.g. 'rake') in there, not in
-      # /System/Libraries/(...)/bin.
-      dir = ::RUBY_PLATFORM =~ /darwin/ && ruby_command =~ OSX_RUBY_RE ?
-        '/usr/bin' : ::File.dirname(ruby_command)
-
-      filename = executable_filename(dir, name) and return filename
-
-      # RubyGems might put binaries in a directory other
-      # than Ruby's bindir. Debian packaged RubyGems and
-      # DebGem packaged RubyGems are the prime examples.
-      filename = executable_filename(::Gem.bindir, name) and return filename
-
-      # Looks like it's not in the RubyGems bindir. Search in $PATH, but
-      # be very careful about this because whatever we find might belong
-      # to a different Ruby interpreter than the current one.
-      ::ENV['PATH'].split(::File::PATH_SEPARATOR).each { |path|
-        if filename = executable_filename(path, name)
-          return filename if shebang_command(filename) == ruby_command
-        end
-      }
-
-      nil
-    end
-
-    def executable_filename(dir, name)
-      filename = ::File.join(dir, name)
-      filename if ::File.file?(filename) && ::File.executable?(filename)
-    end
-
-    def shebang_command(filename)
-      ::File.foreach(filename) { |line|
-        return $1 if line =~ /\A#!\s*(\S*)/
-
-        # Allow one extra line for magic comment.
-        break if $. > 1
-      }
-
-      nil
-    end
-
   end
-
 end
 
 def File.ruby; ::Nuggets::Ruby.ruby_command; end
 
-if RUBY_PLATFORM == 'java'
+if RUBY_ENGINE == 'jruby'
   def Process.ruby(*args, &block)
     argv = ::Nuggets::Ruby.ruby_options_to_argv(args)
     ::IO.popen4(*argv, &block); $?

data/lib/nuggets/ruby_mixin.rb

@@ -0,0 +1,215 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2014 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets 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.                                                          #
+#                                                                             #
+# nuggets 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 nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+require 'rbconfig'
+
+module Nuggets
+
+  # Originally based on Phusion Passenger's
+  # {PlatformInfo}[https://github.com/FooBarWidget/passenger/blob/release-3.0.2/lib/phusion_passenger/platform_info/ruby.rb]
+  # module.
+  #
+  #--
+  # Phusion Passenger - http://www.modrails.com/
+  # Copyright (c) 2010 Phusion
+  #
+  # "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+  #
+  # Permission is hereby granted, free of charge, to any person obtaining a
+  # copy of this software and associated documentation files (the "Software"),
+  # to deal in the Software without restriction, including without limitation
+  # the rights to use, copy, modify, merge, publish, distribute, sublicense,
+  # and/or sell copies of the Software, and to permit persons to whom the
+  # Software is furnished to do so, subject to the following conditions:
+  #
+  # The above copyright notice and this permission notice shall be included in
+  # all copies or substantial portions of the Software.
+  #++
+
+  module RubyMixin
+
+    CONFIG = ::RbConfig::CONFIG
+
+    # Store original $GEM_HOME value so that even if the app customizes
+    # $GEM_HOME we can still work with the original value.
+    if gem_home = ::ENV['GEM_HOME']
+      gem_home = gem_home.strip.freeze
+      gem_home = nil if gem_home.empty?
+    end
+
+    GEM_HOME = gem_home
+
+    RUBY_ENGINE = defined?(::RUBY_ENGINE) ? ::RUBY_ENGINE : 'ruby'
+
+    RUBY_PLATFORM = ::RUBY_ENGINE == 'jruby' ? CONFIG['target_os'] : ::RUBY_PLATFORM
+
+    OSX_RUBY_RE = %r{\A/System/Library/Frameworks/Ruby.framework/Versions/.*?/usr/bin/ruby\Z}
+
+    # Returns correct command for invoking the current Ruby interpreter.
+    def ruby_command
+      defined?(@ruby_command) ? @ruby_command : @ruby_command = ruby_executable
+    end
+
+    attr_writer :ruby_command
+
+    # Returns the full path to the current Ruby interpreter's executable file.
+    # This might not be the actual correct command to use for invoking the Ruby
+    # interpreter; use ruby_command instead.
+    def ruby_executable
+      @ruby_executable ||= begin
+        dir, name, ext = CONFIG.values_at(*%w[bindir RUBY_INSTALL_NAME EXEEXT])
+        ::File.join(dir, name + ext).sub(/.*\s.*/m, '"\&"')
+      end
+    end
+
+    attr_writer :ruby_executable
+
+    # Locates a Ruby tool command +name+, e.g. 'gem', 'rake', 'bundle', etc. Instead
+    # of naively looking in $PATH, this function uses a variety of search heuristics
+    # to find the command that's really associated with the current Ruby interpreter.
+    # It should never locate a command that's actually associated with a different
+    # Ruby interpreter.
+    #
+    # NOTE: The return value may not be the actual correct invocation for the tool.
+    # Use command_for_ruby_tool for that.
+    #
+    # Returns +nil+ when nothing's found.
+    def locate_ruby_tool(name, extensions = ['', CONFIG['EXEEXT']].compact.uniq)
+      # Deduce Ruby's --program-prefix and --program-suffix from its install name
+      # and transform the given input name accordingly.
+      #
+      #   "rake" => "jrake", "rake1.8", etc.
+      [name, CONFIG['RUBY_INSTALL_NAME'].sub('ruby', name)].uniq.each { |basename|
+        extensions.each { |ext|
+          result = locate_ruby_tool_by_basename(basename + ext) and return result
+        }
+      }
+
+      nil
+    end
+
+    # Returns the correct command string for invoking the +name+ executable
+    # that belongs to the current Ruby interpreter. Returns +nil+ if the
+    # command is not found.
+    #
+    # If the command executable is a Ruby program, then we need to run it
+    # in the correct Ruby interpreter just in case the command doesn't
+    # have the correct shebang line; we don't want a totally different
+    # Ruby than the current one to be invoked.
+    def command_for_ruby_tool(name)
+      filename = respond_to?(name) ? send(name) : locate_ruby_tool(name)
+      shebang_command(filename) =~ /ruby/ ? "#{ruby_command} #{filename}" : filename
+    end
+
+    def self.define_ruby_tool(name)
+      class_eval <<-EOT, __FILE__, __LINE__ + 1
+        def #{name}
+          @#{name} ||= locate_ruby_tool('#{name}')
+        end
+
+        attr_writer :#{name}
+
+        def #{name}_command
+          @#{name}_command ||= command_for_ruby_tool('#{name}')
+        end
+
+        attr_writer :#{name}_command
+      EOT
+    end
+
+    %w[gem rake rspec].each { |name| define_ruby_tool(name) }
+
+    def ruby_options_to_argv(args, ruby_command = ruby_command())
+      argv = [ruby_command]
+
+      ruby_options_from_hash(args.pop, argv) if args.last.is_a?(::Hash)
+
+      argv.concat(args.map! { |arg| arg.to_s.strip })
+    end
+
+    def ruby_options_from_hash(hash, argv = [])
+      hash.each { |key, val|
+        opt = "-#{key.to_s[0, 1]}"
+
+        if val.is_a?(::Array)
+          val.each { |v| argv << opt << v.to_s }
+        elsif opt == '-e'
+          argv << opt << val.to_s
+        elsif val != false
+          argv << "#{opt}#{val unless val == true}"
+        end
+      }
+
+      argv
+    end
+
+    private
+
+    def locate_ruby_tool_by_basename(name)
+      # On OS X we must look for Ruby binaries in /usr/bin.
+      # RubyGems puts executables (e.g. 'rake') in there, not in
+      # /System/Libraries/(...)/bin.
+      dir = ::RUBY_PLATFORM =~ /darwin/ && ruby_command =~ OSX_RUBY_RE ?
+        '/usr/bin' : ::File.dirname(ruby_command)
+
+      filename = executable_filename(dir, name) and return filename
+
+      # RubyGems might put binaries in a directory other
+      # than Ruby's bindir. Debian packaged RubyGems and
+      # DebGem packaged RubyGems are the prime examples.
+      filename = executable_filename(::Gem.bindir, name) and return filename
+
+      # Looks like it's not in the RubyGems bindir. Search in $PATH, but
+      # be very careful about this because whatever we find might belong
+      # to a different Ruby interpreter than the current one.
+      ::ENV['PATH'].split(::File::PATH_SEPARATOR).each { |path|
+        if filename = executable_filename(path, name)
+          return filename if shebang_command(filename) == ruby_command
+        end
+      }
+
+      nil
+    end
+
+    def executable_filename(dir, name)
+      filename = ::File.join(dir, name)
+      filename if ::File.file?(filename) && ::File.executable?(filename)
+    end
+
+    def shebang_command(filename)
+      ::File.foreach(filename) { |line|
+        return $1 if line =~ /\A#!\s*(\S*)/
+
+        # Allow one extra line for magic comment.
+        break if $. > 1
+      }
+
+      nil
+    end
+
+  end
+
+end

data/lib/nuggets/version.rb

@@ -3,7 +3,7 @@ module Nuggets
   module Version
 
     MAJOR = 1
-    MINOR = 1
+    MINOR = 2
     TINY  = 0
 
     class << self

data/spec/nuggets/env/user_home_spec.rb

@@ -25,7 +25,7 @@ describe_extended ENV, Nuggets::Env::UserHomeMixin, true do
     ENV.user_home.should == 'foo'
   end
 
-  unless RUBY_PLATFORM == 'java'
+  unless RUBY_ENGINE == 'jruby'
 
     example do
       ENV.clear

data/spec/nuggets/object/singleton_class_spec.rb

@@ -3,7 +3,7 @@ require 'nuggets/object/singleton_class'
 describe_extended Object, Nuggets::Object::SingletonClassMixin do
 
   objects = [Class, Object.new, Class.new, 's', [1, 2], { :a => 'b' }]
-  objects.unshift(Object) unless RUBY_PLATFORM == 'java' || RUBY_ENGINE == 'rbx'
+  objects.unshift(Object) unless %w[jruby rbx].include?(RUBY_ENGINE)
 
   objects.each { |o|
     example { o.should_not be_a_singleton_class }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nuggets
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Jens Wille
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-26 00:00:00.000000000 Z
+date: 2015-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -47,7 +47,7 @@ dependencies:
         version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.8.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,7 +57,7 @@ dependencies:
         version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.8.1
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -152,6 +152,7 @@ files:
 - lib/nuggets/dotted_decimal.rb
 - lib/nuggets/enumerable/agrep.rb
 - lib/nuggets/enumerable/all_any_extended.rb
+- lib/nuggets/enumerable/all_any_extended_mixin.rb
 - lib/nuggets/enumerable/minmax.rb
 - lib/nuggets/env/set.rb
 - lib/nuggets/env/set_mixin.rb
@@ -172,6 +173,8 @@ files:
 - lib/nuggets/hash/deep_fetch_mixin.rb
 - lib/nuggets/hash/deep_merge.rb
 - lib/nuggets/hash/deep_merge_mixin.rb
+- lib/nuggets/hash/deproc.rb
+- lib/nuggets/hash/deproc_mixin.rb
 - lib/nuggets/hash/idmap.rb
 - lib/nuggets/hash/idmap_mixin.rb
 - lib/nuggets/hash/in_order.rb
@@ -210,6 +213,7 @@ files:
 - lib/nuggets/module/lazy_attr_mixin.rb
 - lib/nuggets/module/query_attr.rb
 - lib/nuggets/module/query_attr_mixin.rb
+- lib/nuggets/net/ssh.rb
 - lib/nuggets/net/success.rb
 - lib/nuggets/numeric/between.rb
 - lib/nuggets/numeric/duration.rb
@@ -241,6 +245,7 @@ files:
 - lib/nuggets/range/quantile.rb
 - lib/nuggets/range/quantile_mixin.rb
 - lib/nuggets/ruby.rb
+- lib/nuggets/ruby_mixin.rb
 - lib/nuggets/statistics.rb
 - lib/nuggets/statistics_mixins.rb
 - lib/nuggets/string/camelscore.rb
@@ -344,17 +349,15 @@ licenses:
 metadata: {}
 post_install_message: |2+
 
-  nuggets-1.1.0 [2014-11-26]:
+  nuggets-1.2.0 [2015-03-13]:
 
-  * Nuggets::LogParser::Rails no longer <tt>eval</tt>s the params hash; set the
-    environment variable +NUGGETS_LOG_PARSER_RAILS_EVAL_PARAMS+ to restore this
-    behaviour.
-  * Added Object#rescue_if and Object#rescue_unless.
-  * Added JRuby variant of Process.ruby.
+  * Extracted Nuggets::RubyMixin from Nuggets::Ruby.
+  * Added Net::SSH::Connection::Session#exec_sudo.
+  * Added Hash.deproc.
 
 rdoc_options:
 - "--title"
-- nuggets Application documentation (v1.1.0)
+- nuggets Application documentation (v1.2.0)
 - "--charset"
 - UTF-8
 - "--line-numbers"
@@ -375,7 +378,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.4
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Extending Ruby.