epitools 0.5.105 → 0.5.106

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d427d1b5d8c2314e24298cf32b86887e9f4592c3
-  data.tar.gz: 7e4ba5fbe4bdb2b3f07484f63f53fec7dba23389
+  metadata.gz: e62d7058f8223acc7bf84eb7c77fc32e78c94735
+  data.tar.gz: c9b8d58d8dd39c12e78ccf29aeacc5a0c109edfc
 SHA512:
-  metadata.gz: 56cfdcaf9cc2b1d56e41a0eacad29c004cdf675f996a4281074f714dee52435c5dcd062b61d7ba0f32930b10044d7cbfb318670eea8b1a6a6d8f970953fdcd61
-  data.tar.gz: 442b4209f5caf2d85b3a90980d15e4a7114d2521eda593e8f641c29674617e5f6914f33a445c014dd35887fb3c88193d336b3f9c4327c50e3dd648b84864db5b
+  metadata.gz: 89a89b7b72de4c1c71f46af1a2b27e2dc02811d82034c8e17cd84a36e44c0a14fb28ead350509f150b3ec6f258175d2a3714a5f9455409a84924735a659cf794
+  data.tar.gz: 4962e60b4daf5eb39c623d606a04bc08846e24aae70f2e003028c96c2f4f6a76874d030adfb8972079bbd485de06d4bf2afac931e1fdbfe3d3b70113ed1f93d7

data/VERSION

@@ -1 +1 @@
-0.5.105
+0.5.106

data/lib/epitools/core_ext/file.rb

@@ -111,7 +111,7 @@ class File
         seek(-(data.size - index), IO::SEEK_CUR)
         break
       elsif eof?
-        break
+        return nil
       else
         seek(-(string.size - 1), IO::SEEK_CUR)
       end
@@ -133,7 +133,7 @@ class File
         seek(index+string.size, IO::SEEK_CUR)
         break
       elsif pos == 0
-        break
+        return nil
       else
         seek(string.size - 1, IO::SEEK_CUR)
       end

data/lib/epitools/core_ext/misc.rb

@@ -257,6 +257,19 @@ module ObjectSpace
 
 end
 
+
+#
+# Make OpenStruct a little tiny bit more like a Hash
+#
+class OpenStruct
+  def empty?; @table ? @table.empty? : true; end
+  def blank?; empty?; end
+  def any?;  !empty?; end
+
+  def keys; @table&.keys || []; end
+end
+
+
 #
 # Flush standard input's buffer.
 #

data/lib/epitools/core_ext/string.rb

@@ -428,7 +428,7 @@ class String
     #
     # String#to_proc
     #
-    # See http://weblog.raganwald.com/2007/10/stringtoproc.html
+    # See: http://weblog.raganwald.com/2007/10/stringtoproc.html
     #
     # Ported from the String Lambdas in Oliver Steele's Functional Javascript
     # http://osteele.com/sources/javascript/functional/
@@ -438,6 +438,105 @@ class String
     # (c) 2007 Reginald Braithwaite
     # Portions Copyright (c) 2006 Oliver Steele
     #
+    #
+    # ## Basic Usage
+    #
+    # 'x+1'.to_proc[2];
+    #      → 3
+    # 'x+2*y'.to_proc[2, 3];
+    #      → 8
+    # or (more usefully) later:
+    #
+    # square = 'x*x'.to_proc;
+    # square(3);
+    #      → 9
+    # square(4);
+    #      → 16
+    #
+    # ## Explicit parameters
+    #
+    # If the string contains a ->, this separates the parameters from the body.
+    #
+    # 'x y -> x+2*y'.to_proc[2, 3];
+    #      → 8
+    # 'y x -> x+2*y'.to_proc[2, 3];
+    #      → 7
+    # Otherwise, if the string contains a _, it’s a unary function and _ is name of the parameter:
+    #
+    # '_+1'.to_proc[2];
+    #      → 3
+    # '_*_'.to_proc[3];
+    #      → 9
+    # ## Implicit parameters
+    #
+    # If the string doesn’t specify explicit parameters, they are implicit.
+    #
+    # If the string starts with an operator or relation besides -, or ends with an operator or relation, then its implicit arguments are placed at the beginning and/or end:
+    #
+    # '*2'.to_proc[2];
+    #      → 4
+    # '/2'.to_proc[4];
+    #      → 2
+    # '2/'.to_proc[4];
+    #      → 0.5
+    # '/'.to_proc[2, 4];
+    #      → 0.5
+    # ’.’ counts as a right operator:
+    #
+    # '.abs'.to_proc[-1];
+    #  → 1
+    #
+    #
+    # Otherwise, the variables in the string, in order of occurrence, are its parameters.
+    #
+    # 'x+1'.to_proc[2];
+    #      → 3
+    # 'x*x'.to_proc[3];
+    #      → 9
+    # 'x + 2*y'.to_proc[1, 2];
+    #      → 5
+    # 'y + 2*x'.to_proc[1, 2];
+    #      → 5
+    #
+    # ## Chaining
+    #
+    # Chain -> to create curried functions.
+    #
+    # 'x y -> x+y'.to_proc[2, 3];
+    #      → 5
+    # 'x -> y -> x+y'.to_proc[2][3];
+    #      → 5
+    # plus_two = 'x -> y -> x+y'.to_proc[2];
+    # plus_two[3]
+    #      → 5
+    #
+    # Using String#to_proc in Idiomatic Ruby
+    #
+    # Ruby on Rails popularized Symbol#to_proc, so much so that it will be part of Ruby 1.9.
+    #
+    # If you like:
+    #
+    # %w[dsf fgdg fg].map(&:capitalize)
+    #     → ["Dsf", "Fgdg", "Fg"]
+    # then %w[dsf fgdg fg].map(&'.capitalize') isn’t much of an improvement.
+    #
+    # But what about doubling every value in a list:
+    #
+    # (1..5).map &'*2'
+    #     → [2, 4, 6, 8, 10]
+    #
+    # Or folding a list:
+    #
+    # (1..5).inject &'+'
+    #     → 15
+    #
+    # Or having fun with factorial:
+    #
+    # factorial = "(1.._).inject &'*'".to_proc
+    # factorial[5]
+    #     → 120
+    #
+    # LICENSE:
     # 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

data/lib/epitools/path.rb

@@ -108,6 +108,8 @@ require 'epitools/core_ext/string'
 #
 class Path
 
+  include Enumerable
+
   # The directories in the path, split into an array. (eg: ['usr', 'src', 'linux'])
   attr_reader :dirs
 
@@ -637,10 +639,11 @@ class Path
   #
   # All the lines in this file, chomped.
   #
-  def each_line
+  def each
     io.each_line
   end
-  alias_method :lines, :each_line
+  alias_method :each_line, :each
+  alias_method :lines,     :each
 
   def grep(pat)
     return to_enum(:grep, pat).to_a unless block_given?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: epitools
 version: !ruby/object:Gem::Version
-  version: 0.5.105
+  version: 0.5.106
 platform: ruby
 authors:
 - epitron
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-08 00:00:00.000000000 Z
+date: 2017-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec