epitools 0.5.136 → 0.5.137

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c080c53832ae049dd0ac7abedc41844d515b759fd081f4541855359a21eb75a
-  data.tar.gz: f6871df3e1da9c2cdb315ab49a5c76cea1eb6dfc8f776d6a3f44b3e6d59844fd
+  metadata.gz: 8b483b258d704fbf993bbab386612c813ae695444da9badcd8797c4fcebdc877
+  data.tar.gz: dbdf278b2e463cf45803cd0278243ee1e2bf7737879bdd2fd403eb340a7a5613
 SHA512:
-  metadata.gz: d93c4452eb2e0537265eb95497bf6a0ca9d9022f2ab099972a64904465eccabbe0d3f1901ff2b711940e4603bb6e7afd7c56f7b9b93eea4d9d7762f6453ed3ee
-  data.tar.gz: 75a2d4e10cf13071f4a2cab7239f6a2db7c3b0bb66a68ce603c75bbe5051c15d742308d9f370cc9fb045e6db2492942f8cd37a65db40ba235655e1ea4d429ac8
+  metadata.gz: '0585860f4e91323260513ed1c3e9cc6c49be6ceef4345a184d14b734ff61529c0bce4be6ffd2520e019d51cd9dc3f34a7895792c3c16da1cebd7b5b1ef2907b6'
+  data.tar.gz: 6459b4b90495b0c1f274bfa0053d99c386beba31beb0ce649c157cba7777155e96bed02255b108f096210062f95270bdba124207015cb8d62814ae1f863db0c9

data/VERSION

@@ -1 +1 @@
-0.5.136
+0.5.137

data/lib/epitools/core_ext/array.rb

@@ -1,3 +1,4 @@
+require 'epitools/minimal'
 
 class Array
 

data/lib/epitools/core_ext/date.rb

@@ -0,0 +1,84 @@
+require 'epitools/minimal'
+
+class Date
+
+  def self.find(direction=:backward, &block)
+    Date.today.find(direction, &block)
+  end
+  alias_class_method :search, :find
+
+  def self.find(direction=:backward, &block)
+    Date.today.find(direction, &block)
+  end
+  alias_class_method :search, :find
+
+  def self.find_bidirectional(&block)
+    Date.today.find_bidirectional(&block)
+  end
+  alias_class_method :find_both, :find_bidirectional
+  alias_class_method :search_both, :find_bidirectional
+  alias_class_method :search_bidirectional, :find_bidirectional
+
+
+  #
+  # Returns an enumerator which searches through the calendar a day at a time, returning every date that match the block.
+  #
+  # Examples:
+  #   >> Date.find(:forward) { year % 42 == 0 }
+  #   >> Date.find(:backward) { month == 1 }
+  #   >> Date.parse("1900-01-01").find_bidirectional { wednesday? }
+  #   >> Date.today.find_forward { wednesday? and day == 4 }.take(10)
+  #
+  # (Note: the block doesn't need a parameter; every method you call is sent directly to the date object that's being evaluated)
+  #
+  def find(direction=:backward, &block)
+    raise ArgumentError.new("This method requires a block") unless block_given?
+    Enumerator.new do |y|
+      p = self
+
+      loop do
+        y << p if p.instance_eval(&block)
+
+        case direction
+        when :forward, :forwards
+          p = p.next_day
+        when :backward, :backwards
+          p = p.prev_day
+        else
+          raise "Error: Unknown date search direction #{direction.inspect}"
+        end
+      end
+    end
+  end
+
+  alias_method :search, :find
+
+
+  def find_forwards(&block)
+    find(:forwards, &block)
+  end
+
+  def find_backwards(&block)
+    find(:backwards, &block)
+  end
+
+  def find_bidirectional(&block)
+    f = find(:forward, &block)
+    b = find(:backward, &block)
+
+    Enumerator.new do |y|
+      loop do
+        y << b.next
+        y << f.next
+      end
+    end
+  end
+
+  alias_method :find_backward, :find_backwards
+  alias_method :find_forward,  :find_forwards
+
+  alias_method :find_both,            :find_bidirectional
+  alias_method :search_both,          :find_bidirectional
+  alias_method :search_bidirectional, :find_bidirectional
+
+end

data/lib/epitools/core_ext/io.rb

@@ -27,6 +27,14 @@ class IO
     end
   end
 
+  #
+  # Unmarshal the IO (transform it into Ruby datatypes).
+  #
+  def unmarshal
+    Marshal.load self
+  end
+  alias_method :from_marshal, :unmarshal
+
 end
 
 

data/lib/epitools/core_ext/misc.rb

@@ -172,6 +172,11 @@ class DateTime
   def to_f; to_time.to_f; end
 end
 
+class Date
+  def inspect
+    strftime("#<Date: %Y-%m-%d (%a %b %d, %Y)>")
+  end
+end
 
 class NilClass
 

data/lib/epitools/core_ext/numbers.rb

@@ -33,17 +33,28 @@ class Numeric
   #    12.clamp(0..100)             #=> 12
   #    -38817112.clamp(0..100)      #=> 0
   #
-  def clamp(range)
-    if self < range.first
-      range.first
-    elsif self >= range.last
-      if range.exclude_end?
-        range.last - 1
+  unless method_defined? :clamp
+    def clamp(*args)
+      case args.size 
+      when 0
+        raise "Error: clamp takes either a Range object or 2 arguments"
+      when 1
+        range = args.first
+      when 2
+        range = (args.first..args.second)
+      end
+
+      if self < range.first
+        range.first
+      elsif self >= range.last
+        if range.exclude_end?
+          range.last - 1
+        else
+          range.last
+        end
       else
-        range.last
+        self
       end
-    else
-      self
     end
   end
 

data/lib/epitools/core_ext/string.rb

@@ -28,6 +28,27 @@ class String
     gsub("\r\n", "\n")
   end
 
+  #
+  # Convert the string from one encoding into another (eg: convert_encoding('cp437', 'utf-8'))
+  #
+  def convert_encoding(from, to)
+    force_encoding(from).encode(to)
+  end
+
+  #
+  # Convert the string to utf-8, forcing another encoding
+  #
+  def to_utf8(from="cp437")
+    convert_encoding(from, "utf-8")
+  end
+
+  #
+  # Convert a string from cp437 into utf-8
+  #
+  def from_cp437
+    to_utf8
+  end
+
   #
   # Escape shell characters (globs, quotes, parens, etc.)
   #
@@ -278,12 +299,29 @@ class String
   enumerable :each_slice
 
   #
-  # The Infamous Caesar-Cipher. Unbreakable to this day.
+  # Implements the Infamous Caesar-Cipher. Unbreakable to this day.
   #
   def rot13
     tr('n-za-mN-ZA-M', 'a-zA-Z')
   end
 
+  #
+  # Implements the unfamous non-Caesar ciphers. Want to `rot` your string more or less than 13? You've come to the right place!
+  # (NOTE: Currently only works on American letters. No fancy accents or cyrillic letters please!)
+  #
+  def rot(amount=1)
+    chars.map do |c|
+      case c
+      when ?a..?z
+        (((c.ord - ?a.ord + amount) % 26) + ?a.ord).chr
+      when ?A..?Z
+        (((c.ord - ?A.ord + amount) % 26) + ?A.ord).chr
+      else
+        c
+      end
+    end.join
+  end
+
   #
   # Cache an `URI::RFC2396_Parser` instance, because it's slowwww to initialize
   #
@@ -351,6 +389,13 @@ class String
     bs.with_index.inject(0) { |sum,(b,i)| (b << (8*i)) + sum }
   end
 
+  #
+  # Convert the bytes of this string to hexadecimcal digits
+  #
+  def to_hex
+    unpack("H*").first
+  end
+
   #
   # Cached constants for base conversion.
   #
@@ -405,6 +450,14 @@ class String
     BEncode.load(self)
   end
    
+  #
+  # CRC32 the string
+  #
+  def crc32
+    Zlib.crc32(self).to_hex
+  end
+  alias_method :crc, :crc32
+
   #
   # MD5 the string
   #
@@ -426,6 +479,8 @@ class String
     Digest::SHA256.hexdigest self
   end
 
+
+
   #
   # gzip the string
   #
@@ -490,7 +545,7 @@ class String
   # Unmarshal the string (transform it into Ruby datatypes).
   #
   def unmarshal
-    Marshal.restore self
+    Marshal.load self
   end
   alias_method :from_marshal, :unmarshal
 

data/lib/epitools/core_ext.rb

@@ -15,7 +15,9 @@ require 'epitools/core_ext/hash'
 require 'epitools/core_ext/numbers'
 require 'epitools/core_ext/truthiness'
 require 'epitools/core_ext/range'
+
 require 'epitools/core_ext/time'
+require 'epitools/core_ext/date'
 
 require 'epitools/core_ext/argv'
 require 'epitools/core_ext/file'