ruby-nuggets 0.7.9 → 0.8.0

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.7.9
+This documentation refers to ruby-nuggets version 0.8.0
 
 
 == DESCRIPTION

data/lib/nuggets/io/interact.rb

@@ -0,0 +1,5 @@
+require 'nuggets/io/interact_mixin'
+
+class IO
+  extend Nuggets::IO::InteractMixin
+end

data/lib/nuggets/io/interact_mixin.rb

@@ -0,0 +1,150 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2011 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-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.                                                  #
+#                                                                             #
+# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class IO
+    module InteractMixin
+
+  # call-seq:
+  #   IO.interact(input, output[, timeout[, maxlen]]) -> anArray | nil
+  #
+  # Interact with both ends of a pipe in a non-blocking manner.
+  #
+  # +input+ represents the sending end and is a mapping from the actual
+  # input IO (to send into the pipe) to the pipe's input handle (_stdin_).
+  # The input IO must support +read_nonblock+. If it's a StringIO it will
+  # be extended appropriately. If it's a String it will be converted to
+  # a StringIO.
+  #
+  # +output+ represents the receiving end and is a mapping from the pipe's
+  # output handle (_stdout_) to the designated output IO (to receive data
+  # from the pipe), and, optionally, from the pipe's error handle (_stderr_)
+  # to the designated error IO. The output and error IO must support <tt><<</tt>
+  # with a string argument. If either of them is a Proc it will be extended such
+  # that <tt><<</tt> delegates to +call+.
+  #
+  # +timeout+, if given, will be passed to IO::select and +nil+ is returned
+  # if the select call times out; in all other cases an empty array is returned.
+  #
+  # +maxlen+ is the chunk size for +read_nonblock+.
+  #
+  # Examples:
+  #
+  #   require 'open3'
+  #
+  #   # simply prints 'input string' on STDOUT, ignores +stderr+
+  #   Open3.popen3('cat') { |stdin, stdout, stderr|
+  #     IO.interact({ "input string\n" => stdin }, { stdout => STDOUT })
+  #   }
+  #
+  #   # prints lines you type in reverse order to a string
+  #   str = ''
+  #   Open3.popen3('tac') { |stdin, stdout, stderr|
+  #     IO.interact({ STDIN => stdin }, { stdout => str })
+  #   }
+  #   puts str
+  #
+  #   # prints the IP adresses from /etc/hosts on STDOUT and their lengths
+  #   # on STDERR
+  #   cmd = %q{ruby -ne 'i = $_.split.first or next; warn i.length; puts i'}
+  #   Open3.popen3(cmd) { |stdin, stdout, stderr|
+  #     File.open('/etc/hosts') { |f|
+  #       IO.interact({ f => stdin }, { stdout => STDOUT, stderr => STDERR })
+  #     }
+  #   }
+  def interact(input, output, timeout = nil, maxlen = 2 ** 16)
+    readers, writers = {}, {}
+
+    output.each { |key, val|
+      if val.is_a?(::Proc) && !val.respond_to?(:<<)
+        class << val; alias_method :<<, :call; end
+      end
+
+      readers[key] = val
+    }
+
+    input.each { |key, val|
+      if key.is_a?(::String)
+        require 'stringio'
+        key = ::StringIO.new(key)
+      end
+
+      unless key.respond_to?(:read_nonblock)
+        def key.read_nonblock(*args)
+          read(*args) or raise ::EOFError, 'end of string reached'
+        end
+      end
+
+      writers[val] = [key, '']
+    }
+
+    close = lambda { |*args|
+      container, item, read = args
+
+      container.delete(item)
+      read ? item.close_read : item.close_write
+    }
+
+    read = lambda { |*args|
+      reader, buffer, writer = args
+
+      container = writer ? writers : readers
+      buffer ||= container[reader]
+
+      begin
+        buffer << reader.read_nonblock(maxlen)
+      rescue ::Errno::EAGAIN
+      rescue ::EOFError
+        close[container, writer || reader, !writer]
+      end
+    }
+
+    until readers.empty? && writers.empty?
+      fhs = select(readers.keys, writers.keys, nil, timeout) or return
+
+      fhs[0].each { |reader| read[reader] }
+
+      fhs[1].each { |writer|
+        reader, buffer = writers[writer]
+        read[reader, buffer, writer] or next if buffer.empty?
+
+        begin
+          written = writer.write_nonblock(buffer)
+        rescue ::Errno::EPIPE
+          close[writers, writer]
+        end
+
+        buffer.slice!(0, written) if written
+      }
+    end
+
+    []
+  end
+
+    end
+  end
+end

data/lib/nuggets/util/ruby.rb

@@ -324,5 +324,14 @@ begin
     argv = ::Util::Ruby.ruby_options_to_argv(args, ::File.ruby)
     ::Open4.popen4(*argv, &block_given? ? ::Proc.new : nil)
   end
+
+  require 'nuggets/io/interact'
+
+  def Process.interact_ruby(input, *args)
+    ruby(*args) { |p, i, o, e|
+      ::IO.interact({ input => i }, { o => $stdout, e => $stderr })
+      p
+    }
+  end
 rescue ::LoadError
 end

data/lib/nuggets/version.rb

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

metadata

@@ -1,216 +1,236 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: ruby-nuggets
-version: !ruby/object:Gem::Version
-  version: 0.7.9
+version: !ruby/object:Gem::Version 
+  hash: 63
   prerelease: 
+  segments: 
+  - 0
+  - 8
+  - 0
+  version: 0.8.0
 platform: ruby
-authors:
+authors: 
 - Jens Wille
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-01 00:00:00.000000000 Z
+
+date: 2011-12-13 00:00:00 Z
 dependencies: []
+
 description: Some extensions to the Ruby programming language.
 email: jens.wille@uni-koeln.de
 executables: []
+
 extensions: []
-extra_rdoc_files:
+
+extra_rdoc_files: 
 - README
 - COPYING
 - ChangeLog
-files:
-- lib/nuggets/file/replace.rb
-- lib/nuggets/file/which_mixin.rb
-- lib/nuggets/file/sub.rb
-- lib/nuggets/file/replace_mixin.rb
-- lib/nuggets/file/which.rb
-- lib/nuggets/file/sub_mixin.rb
-- lib/nuggets/version.rb
-- lib/nuggets/statistics_mixins.rb
-- lib/nuggets/statistics.rb
-- lib/nuggets/env/user_encoding_mixin.rb
-- lib/nuggets/env/set_mixin.rb
-- lib/nuggets/env/user_home_mixin.rb
+files: 
+- lib/nuggets.rb
+- lib/nuggets/range/quantile_mixin.rb
+- lib/nuggets/range/quantile.rb
+- lib/nuggets/hash/unroll_mixin.rb
+- lib/nuggets/hash/insert.rb
+- lib/nuggets/hash/nest.rb
+- lib/nuggets/hash/deep_merge_mixin.rb
+- lib/nuggets/hash/only.rb
+- lib/nuggets/hash/deep_merge.rb
+- lib/nuggets/hash/at.rb
+- lib/nuggets/hash/in_order.rb
+- lib/nuggets/hash/nest_mixin.rb
+- lib/nuggets/hash/unroll.rb
 - lib/nuggets/env/user_home.rb
 - lib/nuggets/env/user_encoding.rb
 - lib/nuggets/env/set.rb
+- lib/nuggets/env/user_home_mixin.rb
+- lib/nuggets/env/set_mixin.rb
+- lib/nuggets/env/user_encoding_mixin.rb
+- lib/nuggets/net/success.rb
 - lib/nuggets/object/silence_mixin.rb
-- lib/nuggets/object/boolean.rb
 - lib/nuggets/object/uniclass.rb
-- lib/nuggets/object/msend_mixin.rb
-- lib/nuggets/object/blank_mixin.rb
-- lib/nuggets/object/singleton_class_mixin.rb
 - lib/nuggets/object/singleton_class.rb
-- lib/nuggets/object/metaclass.rb
-- lib/nuggets/object/virtual_class.rb
-- lib/nuggets/object/eigenclass.rb
-- lib/nuggets/object/silence.rb
-- lib/nuggets/object/boolean_mixin.rb
 - lib/nuggets/object/msend.rb
+- lib/nuggets/object/virtual_class.rb
 - lib/nuggets/object/ghost_class.rb
+- lib/nuggets/object/boolean.rb
 - lib/nuggets/object/blank.rb
-- lib/nuggets/uri/exist_mixin.rb
-- lib/nuggets/uri/redirect_mixin.rb
-- lib/nuggets/uri/exist.rb
-- lib/nuggets/uri/content_type_mixin.rb
-- lib/nuggets/uri/content_type.rb
-- lib/nuggets/uri/redirect.rb
-- lib/nuggets/util/cli.rb
-- lib/nuggets/util/i18n.rb
-- lib/nuggets/util/content_type.rb
-- lib/nuggets/util/ansicolor2css.rb
-- lib/nuggets/util/added_methods.rb
-- lib/nuggets/util/dotted_decimal.rb
-- lib/nuggets/util/ruby.rb
-- lib/nuggets/util/added_methods/init.rb
-- lib/nuggets/io/null.rb
-- lib/nuggets/io/null_mixin.rb
-- lib/nuggets/io/agrep.rb
-- lib/nuggets/io/modes.rb
-- lib/nuggets/all.rb
-- lib/nuggets/enumerable/agrep.rb
-- lib/nuggets/enumerable/minmax.rb
-- lib/nuggets/enumerable/all_any_extended.rb
-- lib/nuggets/hash/nest.rb
-- lib/nuggets/hash/unroll.rb
-- lib/nuggets/hash/in_order.rb
-- lib/nuggets/hash/insert.rb
-- lib/nuggets/hash/deep_merge_mixin.rb
-- lib/nuggets/hash/unroll_mixin.rb
-- lib/nuggets/hash/only.rb
-- lib/nuggets/hash/deep_merge.rb
-- lib/nuggets/hash/nest_mixin.rb
-- lib/nuggets/hash/at.rb
+- lib/nuggets/object/boolean_mixin.rb
+- lib/nuggets/object/metaclass.rb
+- lib/nuggets/object/msend_mixin.rb
+- lib/nuggets/object/singleton_class_mixin.rb
+- lib/nuggets/object/eigenclass.rb
+- lib/nuggets/object/silence.rb
+- lib/nuggets/object/blank_mixin.rb
+- lib/nuggets/version.rb
+- lib/nuggets/statistics_mixins.rb
+- lib/nuggets/file/replace_mixin.rb
+- lib/nuggets/file/which_mixin.rb
+- lib/nuggets/file/which.rb
+- lib/nuggets/file/replace.rb
+- lib/nuggets/file/sub_mixin.rb
+- lib/nuggets/file/sub.rb
+- lib/nuggets/integer/map_mixin.rb
+- lib/nuggets/integer/to_binary_s.rb
+- lib/nuggets/integer/length_mixin.rb
+- lib/nuggets/integer/length.rb
+- lib/nuggets/integer/map.rb
+- lib/nuggets/integer/factorial.rb
 - lib/nuggets/tempfile/open.rb
-- lib/nuggets/proc/bind_mixin.rb
-- lib/nuggets/proc/bind.rb
-- lib/nuggets/array/to_hash.rb
-- lib/nuggets/array/rand.rb
-- lib/nuggets/array/flatten_once.rb
-- lib/nuggets/array/format.rb
-- lib/nuggets/array/median_mixin.rb
-- lib/nuggets/array/mean.rb
-- lib/nuggets/array/combination.rb
-- lib/nuggets/array/histogram_mixin.rb
-- lib/nuggets/array/mean_mixin.rb
-- lib/nuggets/array/standard_deviation_mixin.rb
-- lib/nuggets/array/standard_deviation.rb
-- lib/nuggets/array/in_order.rb
-- lib/nuggets/array/shuffle.rb
-- lib/nuggets/array/monotone.rb
-- lib/nuggets/array/histogram.rb
-- lib/nuggets/array/median.rb
-- lib/nuggets/array/variance.rb
+- lib/nuggets/string/word_wrap.rb
+- lib/nuggets/string/capitalize_first.rb
+- lib/nuggets/string/wc.rb
+- lib/nuggets/string/evaluate.rb
+- lib/nuggets/string/msub.rb
+- lib/nuggets/string/nsub.rb
+- lib/nuggets/string/xor.rb
+- lib/nuggets/string/wc_mixin.rb
+- lib/nuggets/string/case.rb
+- lib/nuggets/string/xor_mixin.rb
+- lib/nuggets/string/evaluate_mixin.rb
+- lib/nuggets/string/sub_with_md.rb
+- lib/nuggets/all.rb
 - lib/nuggets/array/correlation.rb
-- lib/nuggets/array/correlation_mixin.rb
+- lib/nuggets/array/shuffle.rb
 - lib/nuggets/array/regression_mixin.rb
 - lib/nuggets/array/limit.rb
-- lib/nuggets/array/variance_mixin.rb
-- lib/nuggets/array/only.rb
 - lib/nuggets/array/runiq.rb
+- lib/nuggets/array/variance.rb
+- lib/nuggets/array/histogram.rb
+- lib/nuggets/array/standard_deviation_mixin.rb
+- lib/nuggets/array/median.rb
+- lib/nuggets/array/to_hash.rb
+- lib/nuggets/array/combination.rb
+- lib/nuggets/array/monotone.rb
 - lib/nuggets/array/mode.rb
-- lib/nuggets/array/limit_mixin.rb
+- lib/nuggets/array/variance_mixin.rb
+- lib/nuggets/array/rand.rb
+- lib/nuggets/array/standard_deviation.rb
+- lib/nuggets/array/correlation_mixin.rb
+- lib/nuggets/array/only.rb
+- lib/nuggets/array/mean_mixin.rb
 - lib/nuggets/array/regression.rb
-- lib/nuggets/array/runiq_mixin.rb
 - lib/nuggets/array/mode_mixin.rb
-- lib/nuggets/range/quantile_mixin.rb
-- lib/nuggets/range/quantile.rb
-- lib/nuggets/net/success.rb
-- lib/nuggets/integer/map.rb
-- lib/nuggets/integer/map_mixin.rb
-- lib/nuggets/integer/factorial.rb
-- lib/nuggets/integer/length.rb
-- lib/nuggets/integer/length_mixin.rb
-- lib/nuggets/integer/to_binary_s.rb
-- lib/nuggets/all_mixins.rb
-- lib/nuggets/string/msub.rb
-- lib/nuggets/string/evaluate.rb
-- lib/nuggets/string/evaluate_mixin.rb
-- lib/nuggets/string/nsub.rb
-- lib/nuggets/string/xor_mixin.rb
-- lib/nuggets/string/wc.rb
-- lib/nuggets/string/sub_with_md.rb
-- lib/nuggets/string/wc_mixin.rb
-- lib/nuggets/string/case.rb
-- lib/nuggets/string/word_wrap.rb
-- lib/nuggets/string/xor.rb
-- lib/nuggets/string/capitalize_first.rb
-- lib/nuggets/numeric/to_multiple.rb
-- lib/nuggets/numeric/signum.rb
-- lib/nuggets/numeric/between.rb
+- lib/nuggets/array/limit_mixin.rb
+- lib/nuggets/array/flatten_once.rb
+- lib/nuggets/array/in_order.rb
+- lib/nuggets/array/mean.rb
+- lib/nuggets/array/median_mixin.rb
+- lib/nuggets/array/histogram_mixin.rb
+- lib/nuggets/array/format.rb
+- lib/nuggets/array/runiq_mixin.rb
 - lib/nuggets/numeric/limit.rb
+- lib/nuggets/numeric/between.rb
 - lib/nuggets/numeric/duration.rb
-- lib/nuggets.rb
-- README
+- lib/nuggets/numeric/to_multiple.rb
+- lib/nuggets/numeric/signum.rb
+- lib/nuggets/all_mixins.rb
+- lib/nuggets/util/ansicolor2css.rb
+- lib/nuggets/util/content_type.rb
+- lib/nuggets/util/dotted_decimal.rb
+- lib/nuggets/util/ruby.rb
+- lib/nuggets/util/added_methods.rb
+- lib/nuggets/util/cli.rb
+- lib/nuggets/util/i18n.rb
+- lib/nuggets/util/added_methods/init.rb
+- lib/nuggets/proc/bind_mixin.rb
+- lib/nuggets/proc/bind.rb
+- lib/nuggets/statistics.rb
+- lib/nuggets/io/modes.rb
+- lib/nuggets/io/interact.rb
+- lib/nuggets/io/null_mixin.rb
+- lib/nuggets/io/null.rb
+- lib/nuggets/io/agrep.rb
+- lib/nuggets/io/interact_mixin.rb
+- lib/nuggets/uri/content_type.rb
+- lib/nuggets/uri/redirect_mixin.rb
+- lib/nuggets/uri/redirect.rb
+- lib/nuggets/uri/exist_mixin.rb
+- lib/nuggets/uri/content_type_mixin.rb
+- lib/nuggets/uri/exist.rb
+- lib/nuggets/enumerable/all_any_extended.rb
+- lib/nuggets/enumerable/minmax.rb
+- lib/nuggets/enumerable/agrep.rb
 - ChangeLog
 - COPYING
+- README
 - Rakefile
-- spec/nuggets/file/which_spec.rb
-- spec/nuggets/file/sub_spec.rb
-- spec/nuggets/file/replace_spec.rb
+- spec/nuggets/range/quantile_spec.rb
+- spec/nuggets/hash/nest_spec.rb
+- spec/nuggets/hash/unroll_spec.rb
+- spec/nuggets/hash/deep_merge_spec.rb
+- spec/nuggets/env/set_spec.rb
 - spec/nuggets/env/user_home_spec.rb
 - spec/nuggets/env/user_encoding_spec.rb
-- spec/nuggets/env/set_spec.rb
 - spec/nuggets/object/silence_spec.rb
-- spec/nuggets/object/msend_spec.rb
 - spec/nuggets/object/singleton_class_spec.rb
-- spec/nuggets/object/boolean_spec.rb
+- spec/nuggets/object/msend_spec.rb
 - spec/nuggets/object/blank_spec.rb
-- spec/nuggets/uri/content_type_spec.rb
-- spec/nuggets/uri/exist_spec.rb
-- spec/nuggets/hash/deep_merge_spec.rb
-- spec/nuggets/hash/unroll_spec.rb
-- spec/nuggets/hash/nest_spec.rb
-- spec/nuggets/proc/bind_spec.rb
+- spec/nuggets/object/boolean_spec.rb
+- spec/nuggets/file/sub_spec.rb
+- spec/nuggets/file/replace_spec.rb
+- spec/nuggets/file/which_spec.rb
+- spec/nuggets/integer/map_spec.rb
+- spec/nuggets/integer/length_spec.rb
+- spec/nuggets/string/evaluate_spec.rb
+- spec/nuggets/string/xor_spec.rb
+- spec/nuggets/string/wc_spec.rb
+- spec/nuggets/array/regression_spec.rb
+- spec/nuggets/array/limit_spec.rb
 - spec/nuggets/array/correlation_spec.rb
+- spec/nuggets/array/standard_deviation_spec.rb
 - spec/nuggets/array/mode_spec.rb
-- spec/nuggets/array/mean_spec.rb
 - spec/nuggets/array/histogram_spec.rb
-- spec/nuggets/array/variance_spec.rb
-- spec/nuggets/array/limit_spec.rb
-- spec/nuggets/array/regression_spec.rb
-- spec/nuggets/array/standard_deviation_spec.rb
 - spec/nuggets/array/median_spec.rb
+- spec/nuggets/array/mean_spec.rb
+- spec/nuggets/array/variance_spec.rb
 - spec/nuggets/array/runiq_spec.rb
-- spec/nuggets/range/quantile_spec.rb
-- spec/nuggets/integer/map_spec.rb
-- spec/nuggets/integer/length_spec.rb
-- spec/nuggets/string/wc_spec.rb
-- spec/nuggets/string/evaluate_spec.rb
-- spec/nuggets/string/xor_spec.rb
+- spec/nuggets/proc/bind_spec.rb
+- spec/nuggets/uri/content_type_spec.rb
+- spec/nuggets/uri/exist_spec.rb
 - spec/spec_helper.rb
 - .rspec
-homepage: http://prometheus.rubyforge.org/
+homepage: http://prometheus.rubyforge.org/ruby-nuggets
 licenses: []
+
 post_install_message: 
-rdoc_options:
-- --charset
-- UTF-8
-- --line-numbers
+rdoc_options: 
 - --all
-- --title
-- ruby-nuggets Application documentation (v0.7.9)
 - --main
 - README
-require_paths:
+- --charset
+- UTF-8
+- --title
+- ruby-nuggets Application documentation (v0.8.0)
+- --line-numbers
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: prometheus
-rubygems_version: 1.8.11
+rubygems_version: 1.8.12
 signing_key: 
 specification_version: 3
 summary: Some extensions to the Ruby programming language.
 test_files: []
+