epitools 0.5.36 → 0.5.37

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 62218ee364081707cdf868454642a359f73863c2
-  data.tar.gz: 61fdb3c5bd004f72a9d1c8a3f769d8d325226867
+  metadata.gz: 74b5a665bc66555050576a5aa863b79017d10e90
+  data.tar.gz: a860badfc15c9f1f44f7d8db7aa4f47d2ef32bd4
 SHA512:
-  metadata.gz: e7941b58505310ee7212e344ff45a890455b07354a2a934b589863e4b079b8b66d6369883d11d44978268e84bdb5032d4cfdc20e4161155e45dffcedc4c0aac1
-  data.tar.gz: 9dcea6e9c715edf1c33d22a0f5afa84a3dde31a07bc9b5bbee7023ad6c97009c9ec77f27f6bb7d82169fbafd452c95363f173d5d237af507977f7dddcb21e652
+  metadata.gz: 1d19c2fd984f89485d8a00f7c2f8c5fb0cdeff916b1bf7fa8ea4a5922c447258a56ea21b610ae20e6c5e0b27d5e4679a4d9617b7263d9dbe1b36eaefff4a8f8e
+  data.tar.gz: db684ad10202d61c32167346cf6e3032316041308a0914bd3be5ac5b3ef535a687362966be703778f573686180c526ea3d4525957b9042669bb1cbd9d497e888

data/VERSION

@@ -1 +1 @@
-0.5.36
+0.5.37

data/lib/epitools/core_ext.rb

@@ -5,6 +5,7 @@ require 'epitools'
 require 'epitools/core_ext/object'
 require 'epitools/core_ext/string'
 require 'epitools/core_ext/array'
+require 'epitools/core_ext/file'
 require 'epitools/core_ext/enumerable'
 require 'epitools/core_ext/hash'
 require 'epitools/core_ext/numbers'

data/lib/epitools/core_ext/file.rb

@@ -0,0 +1,102 @@
+require 'epitools/minimal'
+
+#
+# Beginning of File reached! (Raised when reading a file backwards.)
+#
+class BOFError < Exception; end
+
+class File
+
+  #
+  # A much faster `reverse_each` implementation.
+  #
+  def reverse_each(&block)
+    return to_enum(:reverse_each) unless block_given?
+
+    seek_end
+    reverse_each_from_current_pos(&block)
+  end
+
+  #
+  # Read the previous +length+ bytes. After the read, +pos+ will be at the beginning of the region that you just read.
+  #
+  def read_backwards(length)
+    old_pos = pos
+
+    if length > pos
+      seek(0)
+    else
+      seek(-length, IO::SEEK_CUR)
+    end
+
+    new_pos = pos
+    data = read(old_pos - new_pos)
+    seek(new_pos)
+
+    data
+  end
+
+  #
+  # Read each line of file backwards (from the current position.)
+  #
+  def reverse_each_from_current_pos
+    return to_enum(:reverse_each_from_current_pos) unless block_given?
+
+    fragment = readline rescue ""
+
+    loop do
+      data = read_backwards(4096) + fragment
+      loc  = data.size-1
+
+      # NOTE: `rindex(str, loc)` includes the character at `loc`
+      while index = data.rindex("\n", loc-1)
+        line = data[index+1..loc]
+        yield line
+        loc = index
+      end
+
+      fragment = data[0..loc]
+
+      break if pos == 0 # we're done reading!
+    end
+
+    yield fragment
+  end
+
+  #
+  # Seek to `EOF`
+  #
+  def seek_end
+    seek(0, IO::SEEK_END)
+  end
+
+  #
+  # Read the previous line (leaving `pos` at the beginning of the string that was read.)
+  #
+  def reverse_readline
+    raise BOFError.new("beginning of file reached") if pos == 0
+
+    seek_backwards_to("\n", 512, -2)
+    new_pos = pos
+    data = readline
+    seek(new_pos)
+    data
+  end
+
+  #
+  # Scan backwards in the file until `string` is found, and set the IO's +pos+ to the first character after the matched string.
+  # 
+  def seek_backwards_to(string, blocksize=512, rindex_end=-1)
+    loop do
+      data = read_backwards(blocksize)
+
+      if index = data.rindex(string, rindex_end)
+        seek(index+string.size, IO::SEEK_CUR)
+        break
+      elsif pos == 0
+        break
+      end
+    end
+  end
+
+end

data/lib/epitools/core_ext/misc.rb

@@ -178,6 +178,15 @@ class Range
     Kernel.rand(self)
   end
 
+  #
+  # The middle element of this range.
+  #
+  def middle
+    (min + max) / 2
+  end
+
+  
+
 end
 
 

data/lib/epitools/core_ext/string.rb

@@ -268,16 +268,18 @@ class String
   
   # `true` if this string starts with the substring 
   #  
-  def startswith(substring)
+  def startswith?(substring)
     self[0...substring.size] == substring
   end
+  alias_method :startswith, :startswith?
   
   #
   # `true` if this string ends with the substring 
   #  
-  def endswith(substring)
+  def endswith?(substring)
     self[-substring.size..-1] == substring
   end
+  alias_method :endswith, :endswith?
 
   #
   # Parse this string as JSON

data/spec/core_ext_spec.rb

@@ -754,4 +754,16 @@ describe "to_hms and from_hms" do
   60.to_hms.from_hms.should == 60
   "1:20:33".from_hms.to_hms.should == "01:20:33"
   "5:01:20:33".from_hms.to_hms.should == "05:01:20:33"
+end
+
+
+describe File do
+
+  it "reverse_eaches" do
+    tmp = Path.tmp
+    tmp << "hi\nthere\neveryone!\n"
+    f = open(tmp)
+    f.reverse_each.to_a.should == ["everyone!\n", "there\n", "hi\n"]
+  end
+
 end

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: epitools
 version: !ruby/object:Gem::Version
-  version: 0.5.36
+  version: 0.5.37
 platform: ruby
 authors:
 - epitron
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-13 00:00:00.000000000 Z
+date: 2013-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Miscellaneous utility libraries to make my life easier.
@@ -33,9 +33,9 @@ extra_rdoc_files:
 - README.rdoc
 - TODO
 files:
-- ".document"
-- ".gemspec"
-- ".gitignore"
+- .document
+- .gemspec
+- .gitignore
 - Guardfile
 - LICENSE
 - README.rdoc
@@ -52,6 +52,7 @@ files:
 - lib/epitools/core_ext.rb
 - lib/epitools/core_ext/array.rb
 - lib/epitools/core_ext/enumerable.rb
+- lib/epitools/core_ext/file.rb
 - lib/epitools/core_ext/hash.rb
 - lib/epitools/core_ext/matrix.rb
 - lib/epitools/core_ext/misc.rb
@@ -113,17 +114,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 3
 summary: Not utils... METILS!