epitools 0.5.7 → 0.5.8

data/VERSION

@@ -1 +1 @@
-0.5.7
+0.5.8

data/epitools.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "epitools"
-  s.version = "0.5.7"
+  s.version = "0.5.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["epitron"]
-  s.date = "2012-05-04"
+  s.date = "2012-07-08"
   s.description = "Miscellaneous utility libraries to make my life easier."
   s.email = "chris@ill-logic.com"
   s.extra_rdoc_files = [
@@ -87,7 +87,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/epitron/epitools"
   s.licenses = ["WTFPL"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.21"
+  s.rubygems_version = "1.8.24"
   s.summary = "NOT UTILS... METILS!"
 
   if s.respond_to? :specification_version then

data/lib/epitools/autoloads.rb

@@ -16,6 +16,7 @@ autoload :Open3,      'open3'
 autoload :Timeout,    'timeout'
 autoload :Find,       'find'
 autoload :Benchmark,  'benchmark'
+autoload :Tracer,     'tracer'
 #autoload :DelegateClass, 'delegate'
 
 # YAML is sometimes loaded improperly.

data/lib/epitools/core_ext.rb

@@ -3,13 +3,13 @@ require 'epitools'
 ## Alias "Enumerator" to "Enum"
 
 if RUBY_VERSION["1.8"]
-  require 'enumerator' 
+  require 'enumerator'
   Enumerator = Enumerable::Enumerator unless defined? Enumerator
 end
 
 unless defined? Enum
   if defined? Enumerator
-    Enum = Enumerator 
+    Enum = Enumerator
   else
     $stderr.puts "WARNING: Couldn't find the Enumerator class. Enum will not be available."
   end
@@ -25,7 +25,7 @@ class Object
   def self.alias_class_method(dest, src)
     metaclass.send(:alias_method, dest, src)
   end
-  
+
 end
 
 require 'epitools/core_ext/object'
@@ -45,22 +45,31 @@ class MatchData
   def to_hash
     Hash[ names.zip(captures) ]
   end
-  
+
 end
 
 
 class Binding
 
+  #
+  # Get a variables in this binding
+  #
   def [](key)
     eval(key.to_s)
   end
-  
+
+  #
+  # Set a variable in this binding
+  #
   def []=(key, val)
     Thread.current[:_alter_binding_local_] = val
     eval("#{key} = Thread.current[:_alter_binding_local_]")
     Thread.current[:_alter_binding_local_] = nil
   end
 
+  #
+  # Return all the local variables in the binding
+  #
   def local_variables
     eval("local_variables")
   end
@@ -72,9 +81,14 @@ end
 class Proc
 
   #
-  # Joins two procs together, returning a new proc.
+  # Chain two procs together, returning a new proc. Each proc is executed one after the other,
+  # with the same input arguments. The return value is an array of all the procs' return values.
   #
-  # Example:
+  # You can use either the .join method, or the overloaded & operator.
+  #
+  # Examples:
+  #   joined = proc1 & proc2
+  #   joined = proc1.join proc2
   #   newproc = proc { 1 } & proc { 2 }
   #   newproc.call #=> [1, 2]
   #
@@ -83,7 +97,7 @@ class Proc
     proc { |*args| [self.call(*args), other.call(*args)] }
   end
   alias_method :&, :join
-  
+
   #
   # Chains two procs together, returning a new proc. The output from each proc is passed into
   # the input of the next one.
@@ -96,14 +110,14 @@ class Proc
     other ||= block
     proc { |*args| other.call( self.call(*args) ) }
   end
-  alias_method :|, :chain 
-  
+  alias_method :|, :chain
+
 end
 
 
 unless defined?(BasicObject)
   #
-  # A BasicObject class for Ruby 1.8  
+  # Backported BasicObject for Ruby 1.8
   #
   class BasicObject
     instance_methods.each { |m| undef_method m unless m =~ /^__/ }
@@ -112,15 +126,36 @@ end
 
 
 
+class Object
+
+  #
+  # Negates a boolean, chained-method style.
+  #
+  # Example:
+  #   >> 10.even?
+  #   => true
+  #   >> 10.not.even?
+  #   => false
+  #
+  def not
+    NotWrapper.new(self)
+  end
+
+end
+
 class NotWrapper < BasicObject # :nodoc:
   def initialize(orig)
     @orig = orig
   end
-  
+
   def inspect
     "{NOT #{@orig.inspect}}"
   end
-  
+
+  def is_a?(other)
+    other === self
+  end
+
   def method_missing(meth, *args, &block)
     result = @orig.send(meth, *args, &block)
     if result.is_a? ::TrueClass or result.is_a? ::FalseClass
@@ -131,35 +166,23 @@ class NotWrapper < BasicObject # :nodoc:
   end
 end
 
-class Object
-  
-  #
-  # Negates a boolean, chained-method style.
-  #
-  # Example:
-  #   >> 10.even?
-  #   => true
-  #   >> 10.not.even?
-  #   => false
-  #
-  def not
-    NotWrapper.new(self)
-  end
-  
-end
+
 
 unless IO.respond_to? :copy_stream
-  
+
   class IO
-    
+
+    #
+    # IO.copy_stream backport
+    #
     def self.copy_stream(input, output)
       while chunk = input.read(8192)
         output.write(chunk)
       end
     end
-    
+
   end
-  
+
 end
 
 
@@ -198,8 +221,37 @@ end
 
 module URI
 
+  #
+  # Return a Hash of the variables in the query string
+  #
   def params
     query.to_params
   end
 
+end
+
+
+class Time
+
+  #
+  # Which "quarter" of the year does this date fall into?
+  #
+  def quarter
+    (month / 3.0).ceil
+  end
+
+end
+
+
+#
+# Give ObjectSpace Enumerable powers (select, map, etc.)
+#
+module ObjectSpace
+
+  include Enumerable
+
+  alias_method :each, :each_object
+
+  extend self
+
 end

data/lib/epitools/core_ext/array.rb

@@ -7,9 +7,13 @@ class Array
   def squash
     flatten.compact.uniq
   end
-  
+
+  #def to_hash
+  #  Hash[self]
+  #end
+
   #
-  # Removes the elements from the array for which the block evaluates to true. 
+  # Removes the elements from the array for which the block evaluates to true.
   # In addition, return the removed elements.
   #
   # For example, if you wanted to split an array into evens and odds:
@@ -20,7 +24,7 @@ class Array
   #
   def remove_if(&block)
     removed = []
-    
+
     delete_if do |x|
       if block.call(x)
         removed << x
@@ -29,29 +33,29 @@ class Array
         false
       end
     end
-    
+
     removed
   end
-  
+
   #
   # zip from the right (or reversed zip.)
   #
   # eg:
-  #   >> [5,39].rzip([:hours, :mins, :secs]) 
+  #   >> [5,39].rzip([:hours, :mins, :secs])
   #   => [ [:mins, 5], [:secs, 39] ]
   #
   def rzip(other)
     # That's a lotta reverses!
     reverse.zip(other.reverse).reverse
-  end  
-  
+  end
+
   #
   # Pick the middle element.
   #
   def middle
     self[(size-1) / 2]
   end
-  
+
   #
   # XOR operator
   #
@@ -67,7 +71,7 @@ class Array
       sort_by{rand}
     end
   end
-  
+
   #
   # Pick (a) random element(s).
   #
@@ -81,15 +85,14 @@ class Array
     end
   end
   alias_method :pick, :sample
-  
+
   #
   # Divide the array into n pieces.
   #
-  def / pieces 
+  def / pieces
     piece_size = (size.to_f / pieces).ceil
     each_slice(piece_size).to_a
   end
-  
 
   alias_method :unzip, :transpose
 

data/lib/epitools/core_ext/enumerable.rb

@@ -316,3 +316,30 @@ module Enumerable
 end
 
 
+class Enumerator
+
+  SPINNER = ['-', '\\', '|', '/']
+
+  #
+  # Display a spinner every `every` elements that pass through the Enumerator.
+  #
+  def with_spinner(every=37)
+    Enumerator.new do |yielder|
+      spins = 0
+
+      each.with_index do |e, i|
+        if i % every == 0
+          print "\b" unless spins == 0
+          print SPINNER[spins % 4]
+
+          spins += 1
+        end
+
+        yielder << e
+      end
+
+      print "\b \b" # erase the spinner when done
+    end
+  end
+
+end

data/lib/epitools/hexdump.rb

@@ -16,51 +16,60 @@ ASCII_PRINTABLE = (33..126)
 # 48:  d2 b1 6d 31 3e 67 e1 88  99 8b 4b 34 1d 61 05 15  |..m1g....K4.a..|
 #
 
-def hexdump(data, options={})
-  base_offset   = options[:base_offset] || 0
-  color         = options[:color].nil? ? true : options[:color] 
-  highlight     = options[:highlight]
-
-  p options
-  p color
-  
-  lines               = data.scan(/.{1,16}/m)
-  max_offset          = (base_offset + data.size) / 16 * 16
-  max_offset_width    = max_offset.to_s.size
-  max_hex_width       = 3 * 16 + 1
-  
-  p [max_offset, max_offset_width]
-  lines.each_with_index do |line,n|
-    offset    = base_offset + n*16
-    bytes     = line.unpack("C*")
-    hex       = bytes.map { |c| "%0.2x" % c }.insert(8, '').join(' ')
-
-    plain = bytes.map do |c|
-      if ASCII_PRINTABLE.include?(c)
-        c = c.chr
-      else
-        color ? '<9>.</9>' : '.' 
-      end
-    end.join('')
-
-    if color
-      outstring = "<light_cyan>%s<cyan>:  <light_yellow>%s <default>|<light_white>%s<default>|" % [offset.to_s.ljust(max_offset_width), hex.ljust(max_hex_width), plain]
-      outstring = outstring.colorize
-    else
-      outstring = "%s:  %s |%s|" % [offset.to_s.ljust(max_offset_width), hex.ljust(max_hex_width), plain]
+
+module Hex
+
+  DUMP_COLORS = Rash.new(
+    /\d/ => 13,
+    /\w/ => 3,
+    nil => 9,
+    :default => 7
+  )
+
+  def self.dump(data, options={})
+    base_offset   = options[:base_offset] || 0
+    color         = options[:color].nil? ? true : options[:color]
+    highlight     = options[:highlight]
+
+    p options
+    p color
+
+    lines               = data.scan(/.{1,16}/m)
+    max_offset          = (base_offset + data.size) / 16 * 16
+    max_offset_width    = max_offset.to_s.size
+    max_hex_width       = 3 * 16 + 1
+
+    p [max_offset, max_offset_width]
+    lines.each_with_index do |line,n|
+      offset    = base_offset + n*16
+      bytes     = line.unpack("C*")
+      hex       = bytes.map { |c| "%0.2x" % c }.insert(8, '').join(' ')
+
+      plain = bytes.map do |c|
+        if ASCII_PRINTABLE.include?(c)
+          c = c.chr
+        else
+          color ? '<9>.</9>' : '.'
+        end
+      end.join('')
+
+      puts "<11>#{offset.to_s.ljust(max_offset_width)}<3>:  <14>#{hex.ljust(max_hex_width)} <8>|<15>#{plain}<8>|".colorize
     end
-    puts outstring
-  end      
+  end
+
 end
 
+def hexdump(*args)
+  Hex.dump(*args)
+end
 
 if $0 == __FILE__
   data = (0..64).map{ rand(255).chr }.join('')
-  hexdump(data)
+  Hex.dump(data)
   puts
-  hexdump(data, :color=>false)
+  Hex.dump(data, :color=>false)
   puts
-  
+
   data = "1234567890"*10
-  hexdump(data)
+  Hex.dump(data)
 end