epitools 0.5.111 → 0.5.112

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d2e24ebc0ca331f63f356f9275773499b86ab48c3880be8169a5936afba4f58
-  data.tar.gz: 78af329f856014c8d2693cf1654c1479721ab75ca8938fb26c5f1d8c73609686
+  metadata.gz: d59d9daf2f46a0daf7008b75f596bcb8164801c61ec00a8a4f779e3105e97be1
+  data.tar.gz: 97b7ef67560c7377929db8aece4fc6f7f358f3ef96501c5913f99b75a655fa07
 SHA512:
-  metadata.gz: eb0f9dbcc7c796e31ed5db2868823b94e15517ccf8f4ae7f967c006674d5ed82ba63d6719254bdf0f176b2b0f5ebe17a80b39580571259f9e7563dfc1895630d
-  data.tar.gz: 2391e6edc69384fa38081bf91869f0b456da3a828d21f66e012a08a2b8268d47747252dc0d2e40635040463e45ee20ff6d88d7d6e9bf17fa31e6290ab211405b
+  metadata.gz: c17bdd3fada9128955712952cfa8edfa459ff24f83fd04ba4cef9116c3a931f9caba819095a4131f24c89bc4921d574110f6ccd180310a721c5d072896901e40
+  data.tar.gz: b642d62d3c9326b2b20a85ebb8bbf92ca5cff1150c6093f7f73530c44b878ef9637a36a8f2649fcac0e4bc22fca1de75469b947f99a648d77082f4d544f08161

data/Rakefile

@@ -9,7 +9,7 @@ task :release => :build do
 end
 
 task :install => :build do
-  system "gem install epitools-#{gem_version}.gem"
+  system "gem install --local epitools-#{gem_version}.gem"
 end
 
 task :pry do

data/VERSION

@@ -1 +1 @@
-0.5.111
+0.5.112

data/lib/epitools/autoloads.rb

@@ -16,6 +16,7 @@ autoload :Timeout,    'timeout'
 autoload :Find,       'find'
 autoload :Benchmark,  'benchmark'
 autoload :Tracer,     'tracer'
+autoload :TSort,      'tsort'
 autoload :Shellwords, 'shellwords'
 autoload :PTY,        'pty'
 autoload :CSV,        'csv'
@@ -86,6 +87,7 @@ autoreq  :JSON,         'json'
 autoreq  :GeoIP,        'geoip'
 autoreq  :RBTree,       'rbtree'
 autoreq  :MultiRBTree,  'rbtree'
+autoreq  :ID3Tag,       'id3tag'
 
 autoreq :AwesomePrint do
   require 'awesome_print'

data/lib/epitools/browser.rb

@@ -61,7 +61,7 @@ class Browser
     @agent = Mechanize.new do |a|
       # ["Mechanize", "Mac Mozilla", "Linux Mozilla", "Windows IE 6", "iPhone", "Linux Konqueror", "Windows IE 7", "Mac FireFox", "Mac Safari", "Windows Mozilla"]
       a.max_history = 10
-      a.user_agent_alias = "Windows IE 7"
+      a.user_agent_alias = "Windows Chrome"
       a.log = Logger.new "mechanize.log" if @use_logs
     end
 

data/lib/epitools/core_ext/array.rb

@@ -136,6 +136,78 @@ class Array
 
   alias_method :unzip, :transpose
 
+  #
+  # Transpose an array that could have rows of uneven length
+  #
+  def transpose_with_padding
+    max_width = map(&:size).max
+    map { |row| row.rpad(max_width) }.transpose
+  end
+
+  #
+  # Remove instances of "element" from the end of the array (using `Array#pop`)
+  #
+  def rtrim!(element=nil)
+    pop while last == element
+    self
+  end
+
+  #
+  # Like `rtrim!`, but returns a trimmed copy of the array
+  #
+  def rtrim(element=nil)
+    dup.rtrim!(element)
+  end
+
+  ####################################################################
+  # Pseudo-matrix methods
+  ####################################################################
+
+  def rows
+    self
+  end
+
+  def columns
+    cols = transpose_with_padding
+    cols.each &:rtrim!
+    cols
+  end
+  alias_method :cols, :columns
+
+  #
+  # Return row n of a 2D array
+  #
+  def row(n)
+    rows[n]
+  end
+
+  #
+  # Return column n of a 2D array
+  #
+  def column(n)
+    columns[n]&.rtrim!
+  end
+  alias_method :col, :column
+
+  ####################################################################
+
+  #
+  # Extend the array the target_width by adding nils to the end (right side)
+  #
+  def rpad!(target_width)
+    if target_width > size and target_width > 0
+      self[target_width-1] = nil
+    end
+    self
+  end
+
+  #
+  # Return a copy of this array which has been extended to target_width by adding nils to the end (right side)
+  #
+  def rpad(target_width)
+    dup.rpad!(target_width)
+  end
+
   #
   # Convert the array to a hash
   #

data/lib/epitools/core_ext/enumerable.rb

@@ -470,6 +470,32 @@ module Enumerable
   end
   alias_method :grouped, :groups
 
+  #
+  # run-length encode the array (returns an array of [count, element] pairs)
+  #
+  def rle
+    return to_enum(:rle) unless block_given?
+
+    last   = nil
+    result = []
+    count  = 1
+
+    each do |e|
+      if last
+        if last != e
+          yield [count, last]
+          count = 1
+        else
+          count += 1
+        end
+      end
+
+      last = e
+    end
+
+    yield [count, last]
+  end
+
   #
   # Sort strings by their numerical values
   #

data/lib/epitools/core_ext/hash.rb

@@ -53,6 +53,7 @@ class Hash
     end
     self
   end
+  alias_method :transform_keys!, :map_keys!
 
   #
   # Transforms the keys of the hash by passing them into the supplied block,
@@ -61,6 +62,34 @@ class Hash
   def map_keys(&block)
     dup.map_keys!(&block)
   end
+  alias_method :transform_keys, :map_keys
+
+  #
+  # Translate keys to other keys, given a hash of old-key to new-key mappings.
+  #
+  # eg: hash.translate_keys!(
+  #       "Extreme Sports!!!!" => :extreme_sports,
+  #       "Mediocre sports"    => :sports,
+  #       "Pretty okay sports" => :sports,
+  #       "Golf"               => :liesure_activities,
+  #     )
+  #
+  def translate_keys!(mapping)
+    # TODO: Allow regexes and lambdas (eg: translate_keys!(/.+/ => ->(key) { key.to_sym })
+    mapping.each do |src,dest|
+      if includes? src
+        self[dest] = delete(src)
+      end
+    end
+    self
+  end
+
+  #
+  # Same as `translate_keys!`, except it returns a copy of the hash
+  #
+  def translate_keys(mapping)
+    dup.translate_keys!(mapping)
+  end
 
   #
   # Convert the keys to symbols in-place, for fun and profit

data/lib/epitools/core_ext/matrix.rb

@@ -1,3 +1,14 @@
+#
+# TODO: Reimplement Matrix so it's not so awful, and give it a new name (like Grid).
+#       (Goal: To be as nice as numpy)
+#
+# Features:
+# * Better constructors
+# * Pretty-printer support
+# * .rows, .cols, .each_{row,col}, .neighbourhood
+# * Vec class, Point class
+#
+
 require 'matrix'
 
 #

data/lib/epitools/core_ext/numbers.rb

@@ -405,7 +405,7 @@ class Float
   #    > 0.32786243.percent(2) # => "32.79%"
   #
   def percent(decimals=0)
-    "%0.#{decimals}f%" % (self * 100)
+    "%0.#{decimals}f%%" % (self * 100)
   end
 
 end

data/lib/epitools/core_ext/string.rb

@@ -28,6 +28,13 @@ class String
     gsub(/[\t ]+/,' ').strip
   end
 
+  #
+  # Smash together all the characters in a string (removing whitespace)
+  #
+  def smash
+    downcase.scan(/\w+/).join
+  end
+
   #
   # Remove redundant whitespace AND newlines.
   #

data/lib/epitools/path.rb

@@ -157,10 +157,7 @@ class Path
     when String
 
       if path =~ %r{^[a-z\-]+://}i # URL?
-        Path::URL.new(path)
-
-      elsif path =~ /^javascript:/
-        Path::JS.new(path)
+        Path::URI.new(path)
 
       else
         # TODO: highlight backgrounds of codeblocks to show indent level & put boxes (or rules?) around (between?) double-spaced regions
@@ -452,13 +449,8 @@ class Path
     !!thing[/^\../]
   end
 
-  def uri?
-    false
-  end
-
-  def url?
-    uri?
-  end
+  def uri?; false; end
+  def url?; uri?; end
 
   def child_of?(parent)
     parent.parent_of? self
@@ -468,6 +460,13 @@ class Path
     dirs == child.dirs[0...dirs.size]
   end
 
+  #
+  # Does the file or directory name start with a "."?
+  #
+  def hidden?
+    (dir? ? dirs.last : filename)[/^\../]
+  end
+
   ###############################################################################
   # Comparisons
   ###############################################################################
@@ -478,7 +477,7 @@ class Path
   # An array of attributes which will be used sort paths (case insensitive, directories come first)
   #
   def sort_attrs
-    [filename ? 1 : 0, path.downcase]
+    [(filename ? 1 : 0), path.downcase]
   end
 
   def <=>(other)
@@ -495,7 +494,9 @@ class Path
   def ==(other)
     self.path == other.to_s
   end
+  alias_method :eql?, :==
 
+  def hash; path.hash; end
 
   ###############################################################################
   # Joining paths
@@ -619,6 +620,9 @@ class Path
   # Opening/Reading files
   ###############################################################################
 
+  #
+  # Open the file (default: read-only + binary mode)
+  #
   def open(mode="rb", &block)
     if block_given?
       File.open(path, mode, &block)
@@ -629,16 +633,19 @@ class Path
   alias_method :io, :open
   alias_method :stream, :open
 
+  #
+  # Read bytes from the file (just a wrapper around File.read)
+  #
   def read(length=nil, offset=nil)
     File.read(path, length, offset)
   end
 
   #
-  # Read the contents of the file, yielding it in 16k chunks. (default chunk size is 16k)
+  # Read the contents of a file one chunk at a time (default chunk size is 16k)
   #
   def each_chunk(chunk_size=2**14)
-    open do |f|
-      yield f.read(chunk_size) until f.eof?
+    open do |io|
+      yield io.read(chunk_size) until io.eof?
     end
   end
 
@@ -646,12 +653,18 @@ class Path
   #
   # All the lines in this file, chomped.
   #
-  def each
-    io.each_line
+  def each_line(&block)
+    open { |io| io.each_line { |line| block.call(line.chomp) } }
   end
-  alias_method :each_line, :each
-  alias_method :lines,     :each
+  alias_method :each,       :each_line
+  alias_method :lines,      :each_line
+  alias_method :nicelines,  :each_line
+  alias_method :nice_lines, :each_line
 
+
+  #
+  # Yields all matching lines in the file (by returning an Enumerator, or receiving a block)
+  #
   def grep(pat)
     return to_enum(:grep, pat).to_a unless block_given?
 
@@ -660,21 +673,22 @@ class Path
     end
   end
 
-  def nicelines
-    lines.map(&:chomp)
-  end
-  alias_method :nice_lines, :nicelines
-
   def unmarshal
     read.unmarshal
   end
 
+  #
+  # Returns all the files in the directory that this path points to
+  #
   def ls
     Dir.foreach(path).
       reject {|fn| fn == "." or fn == ".." }.
       flat_map {|fn| self / fn }
   end
 
+  #
+  # Returns all files in this path's directory and its subdirectories
+  #
   def ls_r(symlinks=false)
     # glob = symlinks ? "**{,/*/**}/*" : "**/*"
     # Path[File.join(path, glob)]
@@ -682,20 +696,33 @@ class Path
   end
   alias_method :ls_R, :ls_r
 
+  #
+  # Returns all the directories in this path
+  #
   def ls_dirs
     ls.select(&:dir?)
     #Dir.glob("#{path}*/", File::FNM_DOTMATCH).map { |s| Path.new(s, :type=>:dir) }
   end
 
+  #
+  # Returns all the files in this path
+  #
   def ls_files
     ls.select(&:file?)
     #Dir.glob("#{path}*", File::FNM_DOTMATCH).map { |s| Path.new(s, :type=>:file) }
   end
 
+  #
+  # Returns all neighbouring directories to this path
+  #
   def siblings
     Path[dir].ls - [self]
   end
 
+  #
+  # Like the unix `touch` command
+  # (if the file exists, update its timestamp, otherwise create a new file)
+  #
   def touch
     open("a") { }
     self
@@ -758,7 +785,7 @@ class Path
 
   #
   # Parse the file based on the file extension.
-  # (Handles json, html, yaml, xml, bson, and marshal.)
+  # (Handles json, html, yaml, xml, csv, marshal, and bson.)
   #
   def parse
     case ext.downcase
@@ -823,29 +850,43 @@ class Path
   end
   alias_method :from_csv, :read_csv
 
-
+  # Parse the file as XML
   def read_xml
     Nokogiri::XML(io)
   end
 
-
+  # Parse the file as a Ruby Marshal dump
   def read_marshal
     Marshal.load(io)
   end
 
+  # Serilize an object to Ruby Marshal format and write it to this path
   def write_marshal(object)
     write object.marshal
   end
 
-
+  # Parse the file as BSON
   def read_bson
     BSON.deserialize(read)
   end
 
+  # Serilize an object to BSON format and write it to this path
   def write_bson(object)
     write BSON.serialize(object)
   end
 
+  #
+  # Read ID3 tags (requires 'id3tag' gem)
+  #
+  # Available fields:
+  #    tag.artist, tag.title, tag.album, tag.year, tag.track_nr, tag.genre, tag.get_frame(:TIT2)&.content, 
+  #    tag.get_frames(:COMM).first&.content, tag.get_frames(:COMM).last&.language
+  #
+  def id3
+    ID3Tag.read(io)
+  end
+  alias_method :id3tags, :id3
+
   #
   # Change into the directory. If a block is given, it changes into
   # the directory for the duration of the block, then puts you back where you
@@ -928,7 +969,11 @@ class Path
 
     n = 1
     loop do
-      new_file = with(:basename => "#{basename} (#{n})")
+      if dir?
+        new_file = with(:dirs => dirs[0..-2] + ["#{dirs.last} (#{n})"])
+      else
+        new_file = with(:basename => "#{basename} (#{n})")
+      end
       return new_file unless new_file.exists?
       n += 1
     end
@@ -1074,7 +1119,12 @@ class Path
 
   ## Dangerous methods.
 
+  #
+  # Remove a file or directory
+  #
   def rm
+    raise "Error: #{self} does not exist" unless symlink? or exists? 
+
     if directory? and not symlink?
       Dir.rmdir(self) == 0
     else
@@ -1085,6 +1135,9 @@ class Path
   alias_method :unlink!, :rm
   alias_method :remove!, :rm
 
+  #
+  # Shrink or expand the size of a file in-place
+  #
   def truncate(offset=0)
     File.truncate(self, offset) if exists?
   end
@@ -1313,12 +1366,12 @@ class Path
     chown_R/1
     chmod_R/1
   ].each do |spec|
-    method, cardinality = spec.split("/")
-    cardinality = cardinality.to_i
+    meth, cardinality = spec.split("/")
+    cardinality       = cardinality.to_i
 
     class_eval %{
-      def self.#{method}(path#{", *args" if cardinality > 0})
-        Path[path].#{method}#{"(*args)" if cardinality > 0}
+      def self.#{meth}(path#{", *args" if cardinality > 0})
+        Path[path].#{meth}#{"(*args)" if cardinality > 0}
       end
     }
   end
@@ -1355,16 +1408,21 @@ class Path
   end
   alias_class_method :tempdir, :tmpdir
 
-
+  #
+  # User's current home directory
+  #
   def self.home
     Path[ENV['HOME']]
   end
 
+  #
+  # The current directory
+  #
   def self.pwd
     Path.new expand_path(Dir.pwd)
   end
 
-  def self.pushd
+  def self.pushd(destination)
     @@dir_stack ||= []
     @@dir_stack.push pwd
   end
@@ -1453,9 +1511,9 @@ class Path::Relative < Path
 end
 
 #
-# A wrapper for URL objects.
+# A wrapper for URI objects.
 #
-class Path::URL < Path
+class Path::URI < Path
 
   attr_reader :uri
 
@@ -1464,7 +1522,7 @@ class Path::URL < Path
   #       (eg: remove commands that write)
 
   def initialize(uri, hints={})
-    @uri = URI.parse(uri)
+    @uri = ::URI.parse(uri)
     self.path = @uri.path
   end
 
@@ -1486,6 +1544,12 @@ class Path::URL < Path
   def scheme; uri.scheme; end
   alias_method :protocol, :scheme
 
+  %w[http https ftp magnet].each do |s|
+    define_method("#{s}?") { scheme[/^#{s}$/i] }
+  end
+
+  def http?; super or https?; end
+
   #
   # ...and this is: 'host.com'
   #

data/spec/core_ext_spec.rb

@@ -196,6 +196,7 @@ describe Numeric do
 
 end
 
+
 describe String do
 
   it "anys?" do
@@ -204,8 +205,6 @@ describe String do
     "YAY".should be_any
   end
 
-
-
   it "rot13s" do
     message = "Unbreakable Code"
     message.rot13.should_not   == message
@@ -429,6 +428,7 @@ describe Integer do
 
 end
 
+
 describe Float do
 
   it "float?" do
@@ -462,6 +462,7 @@ describe Number do
 
 end
 
+
 describe Array do
 
   it "squashes" do
@@ -522,6 +523,41 @@ describe Array do
     [:a, :b, :c].includes?(5).should == false
   end
 
+  it "rpads" do
+    [1,2,3].rpad(5).should == [1,2,3,nil,nil]
+  end
+
+  it "transpose_with_padding" do
+    a = [
+      [1,2],
+      [1],
+      [1,2,3]
+    ]
+
+    a_transposed = [
+      [1,2,nil],
+      [1,nil,nil],
+      [1,2,3]
+    ].transpose
+
+    a.transpose_with_padding.should == a_transposed
+  end
+
+  it "rows and columnses" do
+    a = [
+      [  1,  2,  3,  4,  5 ],
+      [  6,  7,  8,  9, 10 ],
+      [ 11, 12             ],
+    ]
+
+    a.row(0).should   == [1,2,3,4,5]
+    a.col(0).should   == [1,6,11]
+    a.col(-1).should  == [5,10]
+    a.col(-10).should == nil
+
+    a.cols.map(&:size).should == [3,3,2,2,2]
+  end
+
 end
 
 
@@ -660,6 +696,11 @@ describe Enumerable do
     (a * b).to_a.should == [[1,3],[1,4],[2,3],[2,4]]
   end
 
+  it "rles" do
+           [1, 2, 3,3,3, 4].rle.to_a.should == [ [1,1], [1,2], [3,3], [1,4] ]
+    [5,5, 1, 2, 3,3,3, 4,4].rle.to_a.should == [ [2,5], [1,1], [1,2], [3,3], [2,4] ]
+  end
+
   it "sorts strings numerically" do
     a  = ["a1", "a11", "a2", "a3"]
     proper = ["a1", "a2", "a3", "a11"]
@@ -673,6 +714,7 @@ describe Enumerable do
 
 end
 
+
 describe Enumerator do
 
   it "spins" do
@@ -831,6 +873,7 @@ describe Binding do
   b.call.should         == 5
 end
 
+
 describe Proc do
 
   it "joins procs" do

data/spec/path_spec.rb

@@ -242,7 +242,7 @@ describe Path do
     path.exists?.should == false
 
     path.touch
-    lambda { path.rename(:ext=>".dat") }.should raise_error
+    lambda { path.rename(:ext=>".dat") }.should raise_error(RuntimeError)
 
     dest.rm
     path.rename!(:ext=>".dat")
@@ -264,7 +264,7 @@ describe Path do
     dest.rm
 
     path.touch
-    p path.numbered_backup_file
+    # p path.numbered_backup_file
 
     dest = path.numbered_backup!
     path.touch
@@ -275,6 +275,14 @@ describe Path do
 
     dest.rm
     dest2.rm
+
+
+    path = Path.tmpdir
+    path.dir?.should == true
+    backup = path.numbered_backup!
+    backup.dir?.should == true
+    backup.dirs.last.should == "#{path.dirs.last} (1)"
+    backup.rm
   end
 
   it "rms" do
@@ -316,7 +324,7 @@ describe Path do
 
   it "mkdirs" do
     tmp = Path.tmpfile
-    lambda { tmp.mkdir }.should raise_error
+    lambda { tmp.mkdir }.should raise_error(RuntimeError)
     tmp.rm
     tmp.mkdir.should be_truthy
     tmp.rm.should be_truthy
@@ -409,7 +417,7 @@ describe Path do
   end
 
   it "modes" do
-    Path.tmpfile.mode.class.should == Fixnum
+    Path.tmpfile.mode.class.should == Integer
   end
 
   it "chmods and chmod_Rs" do
@@ -547,7 +555,7 @@ describe Path do
     file["user.test"].should == nil
     Path.getfattr(file)["user.test"].should == nil
 
-    lambda { file["blahblahblah"] = "whee" }.should raise_error
+    lambda { file["blahblahblah"] = "whee" }.should raise_error(RuntimeError)
 
     # Test assigning an entire hash of attributes, using diffing
     attrs = file.attrs
@@ -584,4 +592,12 @@ describe Path do
     # if the source is a file, copies it and builds the directory tree
   end
 
+  it "id3's" do
+    path = Path["test.mp3"]
+    if path.exists?
+      tags = path.id3
+      tags.title.should_not == nil
+      tags.artist.should_not == nil
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: epitools
 version: !ruby/object:Gem::Version
-  version: 0.5.111
+  version: 0.5.112
 platform: ruby
 authors:
 - epitron
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-26 00:00:00.000000000 Z
+date: 2018-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec