ptools 1.3.2-universal-mingw32 → 1.4.0-universal-mingw32

data/README

@@ -1,66 +1,68 @@
-== Description
-  The ptools (power tools) library is an additional set of commands for the
-  File class based on Unix command line tools.
-   
-== Prerequisites
-  On MS Windows you will need the win32-file gem.
-
-== Installation
-  gem install ptools
-
-== Synopsis
-  require "ptools"
-
-  File.which("ruby")         # '/usr/local/bin/ruby'
-  File.whereis("ruby")       # ['/usr/local/bin/ruby','/opt/bin/ruby']
-
-  File.head("myfile")        # Returns first 10 lines of 'myfile'
-  File.tail("myfile",3)      # Returns last 3 lines of 'myfile'
-  File.wc("myfile",'words')  # Returns the number of words in 'myfile'
-
-  File.touch("newfile")      # "newfile" now exists
-  File.null                  # '/dev/null' on Unix, 'NUL' on Windows
-  File.binary?('some_file')  # true or false
-  File.sparse?('some_file')  # true or false
-
-  # Creates a copy of 'myfile' called 'newfile', in DOS format
-  File.nl_convert("myfile", "newfile", "dos")
-   
-== Known Bugs
-  The File.which and File.whereis methods may fail when using JRuby on Windows.
-  See https://github.com/jruby/jruby/issues/2291 for details.
-
-  Please report any other issues on the github project page.
-
-  http://www.github.com/djberg96/ptools
-
-== Acknowledgements
-  The File.which method was originally adopted from the FileWhich code posted
-  by Michael Granger on the now defunct rubygarden.org website. That code was
-  later replaced by a version based on the ruby-which library.
-
-  The File.nl_convert method is based on the nlcvt program found at
-  http://www.perl.com/language/ppt/src/nlcvt/nlcvt, written by Tom Christiansen.
-    
-  The binary?() method was based almost entirely on a blog post by Ryan
-  Davis (who, in turn, based his code on Perl's -B switch).
-
-  Thanks go to Matt Hoyle for help with the File.tail method.
-
-== Future Plans
-  Add whatever other tools people think might be useful.
-   
-== License
-  Artistic 2.0
-    
-== Copyright
-  (C) 2003-2014 Daniel J. Berger
-  All Rights Reserved.
-    
-== Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-
-== Author
-  Daniel J. Berger
+== Description
+  The ptools (power tools) library is an additional set of commands for the
+  File class based on Unix command line tools.
+   
+== Prerequisites
+  On MS Windows you will need the win32-file gem.
+
+== Installation
+  gem install ptools
+
+== Synopsis
+  require "ptools"
+
+  File.which("ruby")         # '/usr/local/bin/ruby'
+  File.whereis("ruby")       # ['/usr/local/bin/ruby','/opt/bin/ruby']
+
+  File.head("myfile")        # Returns first 10 lines of 'myfile'
+  File.tail("myfile",3)      # Returns last 3 lines of 'myfile'
+  File.wc("myfile",'words')  # Returns the number of words in 'myfile'
+
+  File.touch("newfile")      # "newfile" now exists
+  File.null                  # '/dev/null' on Unix, 'NUL' on Windows
+  File.binary?('some_file')  # true or false
+  File.sparse?('some_file')  # true or false
+
+  # Creates a copy of 'myfile' called 'newfile', in DOS format
+  File.nl_convert("myfile", "newfile", "dos")
+   
+== Known Bugs
+  The File.which and File.whereis methods may fail when using JRuby on Windows.
+  See https://github.com/jruby/jruby/issues/2291 for details.
+
+  Please report any other issues on the github project page.
+
+  http://www.github.com/djberg96/ptools
+
+== Acknowledgements
+  The File.which method was originally adopted from the FileWhich code posted
+  by Michael Granger on the now defunct rubygarden.org website. That code was
+  later replaced by a version based on the ruby-which library.
+
+  The File.nl_convert method is based on the nlcvt program found at
+  http://www.perl.com/language/ppt/src/nlcvt/nlcvt, written by Tom Christiansen.
+    
+  The binary?() method was based almost entirely on a blog post by Ryan
+  Davis (who, in turn, based his code on Perl's -B switch).
+
+  Thanks go to Matt Hoyle for help with the File.tail method.
+
+  And thanks to any and all contributors!
+
+== Future Plans
+  Add whatever other tools people think might be useful.
+   
+== License
+  Artistic-2.0
+    
+== Copyright
+  (C) 2003-2020 Daniel J. Berger
+  All Rights Reserved.
+    
+== Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+
+== Author
+  Daniel J. Berger

data/Rakefile

@@ -1,139 +1,87 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-require 'rbconfig'
-include RbConfig
-
-CLEAN.include("**/*.gem", "**/*.rbc", "**/*coverage*")
-
-desc 'Install the ptools package (non-gem)'
-task :install do
-   sitelibdir = CONFIG["sitelibdir"]
-   file = "lib/ptools.rb"
-   FileUtils.cp(file, sitelibdir, :verbose => true)
-end
-
-namespace 'gem' do
-  desc 'Create the ptools gem'
-  task :create => [:clean] do
-    Dir["*.gem"].each{ |f| File.delete(f) } # Clean first
-    spec = eval(IO.read('ptools.gemspec'))
-    if Gem::VERSION < "2.0.0"
-      Gem::Builder.new(spec).build
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end
-  end
-
-  desc 'Install the ptools gem'
-  task :install => [:create] do
-    file = Dir["*.gem"].first
-    if RUBY_PLATFORM == 'java'
-      sh "jruby -S gem install -l #{file}"
-    else
-      sh "gem install -l #{file}"
-    end
-  end
-end
-
-Rake::TestTask.new do |t|
-  task :test => :clean
-  t.verbose = true
-  t.warning = true
-end
-
-namespace 'test' do
-  desc "Check test coverage using rcov"
-  task :coverage => [:clean] do
-    require 'rcov'
-    rm_rf 'coverage'
-    sh "rcov -Ilib test/test*.rb" 
-  end
-
-  Rake::TestTask.new('binary') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_binary.rb']
-  end
-
-  Rake::TestTask.new('constants') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_constants.rb']
-  end
-
-  Rake::TestTask.new('head') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_head.rb']
-  end
-
-  Rake::TestTask.new('image') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_image.rb']
-  end
-
-  Rake::TestTask.new('nlconvert') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_nlconvert.rb']
-  end
-
-  Rake::TestTask.new('null') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_null.rb']
-  end
-
-  Rake::TestTask.new('sparse') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_is_sparse.rb']
-  end
-
-  Rake::TestTask.new('tail') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_tail.rb']
-  end
-
-  Rake::TestTask.new('touch') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_touch.rb']
-  end
-
-  Rake::TestTask.new('wc') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_wc.rb']
-  end
-
-  Rake::TestTask.new('whereis') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_whereis.rb']
-  end
-
-  Rake::TestTask.new('which') do |t|
-    t.libs << 'test'
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_which.rb']
-  end
-end
-
-task :default => :test
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+require 'rspec/core/rake_task'
+include RbConfig
+
+CLEAN.include("**/*.gem", "**/*.rbc", "**/*coverage*", "**/*.lock")
+
+desc 'Install the ptools package (non-gem)'
+task :install do
+  sitelibdir = CONFIG["sitelibdir"]
+  file = "lib/ptools.rb"
+  FileUtils.cp(file, sitelibdir, :verbose => true)
+end
+
+namespace 'gem' do
+  desc 'Create the ptools gem'
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('ptools.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec)
+  end
+
+  desc 'Install the ptools gem'
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    if RUBY_PLATFORM == 'java'
+      sh "jruby -S gem install -l #{file}"
+    else
+      sh "gem install -l #{file}"
+    end
+  end
+end
+
+namespace 'spec' do
+  RSpec::Core::RakeTask.new(:binary) do |t|
+    t.pattern = 'spec/binary_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:constants) do |t|
+    t.pattern = 'spec/constants_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:head) do |t|
+    t.pattern = 'spec/head_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:image) do |t|
+    t.pattern = 'spec/image_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:nlconvert) do |t|
+    t.pattern = 'spec/nlconvert_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:sparse) do |t|
+    t.pattern = 'spec/sparse_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:tail) do |t|
+    t.pattern = 'spec/tail_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:touch) do |t|
+    t.pattern = 'spec/touch_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:wc) do |t|
+    t.pattern = 'spec/wc_spec.rb'
+  end
+ 
+  RSpec::Core::RakeTask.new(:whereis) do |t|
+    t.pattern = 'spec/whereis_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:which) do |t|
+    t.pattern = 'spec/which_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:all) do |t|
+    t.pattern = 'spec/*_spec.rb'
+  end
+end
+
+task :default => 'spec:all'

data/certs/djberg96_pub.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+/3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+-----END CERTIFICATE-----

data/lib/ptools.rb

@@ -1,482 +1,476 @@
-require 'rbconfig'
-require 'win32/file' if File::ALT_SEPARATOR
-
-class File
-  # The version of the ptools library.
-  PTOOLS_VERSION = '1.3.2'
-
-  # :stopdoc:
-
-  # The WIN32EXTS string is used as part of a Dir[] call in certain methods.
-  if File::ALT_SEPARATOR
-    MSWINDOWS = true
-    if ENV['PATHEXT']
-      WIN32EXTS = ('.{' + ENV['PATHEXT'].tr(';', ',').tr('.','') + '}').downcase
-    else
-      WIN32EXTS = '.{exe,com,bat}'
-    end
-  else
-    MSWINDOWS = false
-  end
-
-  IMAGE_EXT = %w[.bmp .gif .jpg .jpeg .png]
-
-  # :startdoc:
-
-  # Returns whether or not the file is an image. Only JPEG, PNG, BMP and
-  # GIF are checked against.
-  #
-  # This method does some simple read and extension checks. For a version
-  # that is more robust, but which depends on a 3rd party C library (and is
-  # difficult to build on MS Windows), see the 'filemagic' library.
-  #
-  # Examples:
-  #
-  #    File.image?('somefile.jpg') # => true
-  #    File.image?('somefile.txt') # => false
-  #--
-  # The approach I used here is based on information found at
-  # http://en.wikipedia.org/wiki/Magic_number_(programming)
-  #
-  def self.image?(file)
-    bool = IMAGE_EXT.include?(File.extname(file).downcase)      # Match ext
-    bool = bmp?(file) || jpg?(file) || png?(file) || gif?(file) || tiff?(file) # Check data
-    bool
-  end
-
-  # Returns the name of the null device (aka bitbucket) on your platform.
-  #
-  # Examples:
-  #
-  #   # On Linux
-  #   File.null # => '/dev/null'
-  #
-  #   # On MS Windows
-  #   File.null # => 'NUL'
-  #--
-  # The values I used here are based on information from
-  # http://en.wikipedia.org/wiki//dev/null
-  #
-  def self.null
-    case RbConfig::CONFIG['host_os']
-      when /mswin|win32|msdos|mingw|windows/i
-        'NUL'
-      when /amiga/i
-        'NIL:'
-      when /openvms/i
-        'NL:'
-      else
-        '/dev/null'
-    end
-  end
-
-  class << self
-    alias null_device null
-  end
-
-  # Returns whether or not +file+ is a binary non-image file, i.e. executable,
-  # shared object, ect. Note that this is NOT guaranteed to be 100% accurate.
-  # It performs a "best guess" based on a simple test of the first
-  # +File.blksize+ characters, or 4096, whichever is smaller.
-  #
-  # Example:
-  #
-  #   File.binary?('somefile.exe') # => true
-  #   File.binary?('somefile.txt') # => false
-  #--
-  # Based on code originally provided by Ryan Davis (which, in turn, is
-  # based on Perl's -B switch).
-  #
-  def self.binary?(file)
-    return false if image?(file)
-    bytes = File.stat(file).blksize
-    bytes = 4096 if bytes > 4096
-    s = (File.read(file, bytes) || "")
-    s = s.encode('US-ASCII', :undef => :replace).split(//)
-    ((s.size - s.grep(" ".."~").size) / s.size.to_f) > 0.30
-  end
-
-  # Looks for the first occurrence of +program+ within +path+.
-  #
-  # On Windows, it looks for executables ending with the suffixes defined
-  # in your PATHEXT environment variable, or '.exe', '.bat' and '.com' if
-  # that isn't defined, which you may optionally include in +program+.
-  #
-  # Returns nil if not found.
-  #
-  # Examples:
-  #
-  #   File.which('ruby') # => '/usr/local/bin/ruby'
-  #   File.which('foo')  # => nil
-  #
-  def self.which(program, path=ENV['PATH'])
-    if path.nil? || path.empty?
-      raise ArgumentError, "path cannot be empty"
-    end
-
-    # Bail out early if an absolute path is provided.
-    if program =~ /^\/|^[a-z]:[\\\/]/i
-      program += WIN32EXTS if MSWINDOWS && File.extname(program).empty?
-      found = Dir[program].first
-      if found && File.executable?(found) && !File.directory?(found)
-        return found
-      else
-        return nil
-      end
-    end
-
-    # Iterate over each path glob the dir + program.
-    path.split(File::PATH_SEPARATOR).each{ |dir|
-      dir = File.expand_path(dir)
-
-      next unless File.exist?(dir) # In case of bogus second argument
-      file = File.join(dir, program)
-
-      # Dir[] doesn't handle backslashes properly, so convert them. Also, if
-      # the program name doesn't have an extension, try them all.
-      if MSWINDOWS
-        file = file.tr("\\", "/")
-        file += WIN32EXTS if File.extname(program).empty?
-      end
-
-      found = Dir[file].first
-
-      # Convert all forward slashes to backslashes if supported
-      if found && File.executable?(found) && !File.directory?(found)
-        found.tr!(File::SEPARATOR, File::ALT_SEPARATOR) if File::ALT_SEPARATOR
-        return found
-      end
-    }
-
-    nil
-  end
-
-  # Returns an array of each +program+ within +path+, or nil if it cannot
-  # be found.
-  #
-  # On Windows, it looks for executables ending with the suffixes defined
-  # in your PATHEXT environment variable, or '.exe', '.bat' and '.com' if
-  # that isn't defined, which you may optionally include in +program+.
-  #
-  # Examples:
-  #
-  #   File.whereis('ruby') # => ['/usr/bin/ruby', '/usr/local/bin/ruby']
-  #   File.whereis('foo')  # => nil
-  #
-  def self.whereis(program, path=ENV['PATH'])
-    if path.nil? || path.empty?
-      raise ArgumentError, "path cannot be empty"
-    end
-
-    paths = []
-
-    # Bail out early if an absolute path is provided.
-    if program =~ /^\/|^[a-z]:[\\\/]/i
-      program += WIN32EXTS if MSWINDOWS && File.extname(program).empty?
-      program = program.tr("\\", '/') if MSWINDOWS
-      found = Dir[program]
-      if found[0] && File.executable?(found[0]) && !File.directory?(found[0])
-        if File::ALT_SEPARATOR
-          return found.map{ |f| f.tr('/', "\\") }
-        else
-          return found
-        end
-      else
-        return nil
-      end
-    end
-
-    # Iterate over each path glob the dir + program.
-    path.split(File::PATH_SEPARATOR).each{ |dir|
-      next unless File.exist?(dir) # In case of bogus second argument
-      file = File.join(dir, program)
-
-      # Dir[] doesn't handle backslashes properly, so convert them. Also, if
-      # the program name doesn't have an extension, try them all.
-      if MSWINDOWS
-        file = file.tr("\\", "/")
-        file += WIN32EXTS if File.extname(program).empty?
-      end
-
-      found = Dir[file].first
-
-      # Convert all forward slashes to backslashes if supported
-      if found && File.executable?(found) && !File.directory?(found)
-        found.tr!(File::SEPARATOR, File::ALT_SEPARATOR) if File::ALT_SEPARATOR
-        paths << found
-      end
-    }
-
-    paths.empty? ? nil : paths.uniq
-  end
-
-  # In block form, yields the first +num_lines+ from +filename+.  In non-block
-  # form, returns an Array of +num_lines+
-  #
-  # Examples:
-  #
-  #  # Return an array
-  #  File.head('somefile.txt') # => ['This is line1', 'This is line2', ...]
-  #
-  #  # Use a block
-  #  File.head('somefile.txt'){ |line| puts line }
-  #
-  def self.head(filename, num_lines=10)
-    a = []
-
-    IO.foreach(filename){ |line|
-      break if num_lines <= 0
-      num_lines -= 1
-      if block_given?
-        yield line
-      else
-        a << line
-      end
-    }
-
-    return a.empty? ? nil : a # Return nil in block form
-  end
-
-  # In block form, yields the last +num_lines+ of file +filename+.
-  # In non-block form, it returns the lines as an array.
-  #
-  # Example:
-  #
-  #   File.tail('somefile.txt') # => ['This is line7', 'This is line8', ...]
-  #
-  # If you're looking for tail -f functionality, please use the file-tail
-  # gem instead.
-  #
-  #--
-  # Internally I'm using a 64 chunk of memory at a time. I may allow the size
-  # to be configured in the future as an optional 3rd argument.
-  #
-  def self.tail(filename, num_lines=10)
-    tail_size = 2**16 # 64k chunks
-
-    # MS Windows gets unhappy if you try to seek backwards past the
-    # end of the file, so we have some extra checks here and later.
-    file_size  = File.size(filename)
-    read_bytes = file_size % tail_size
-    read_bytes = tail_size if read_bytes == 0
-
-    line_sep = File::ALT_SEPARATOR ? "\r\n" : "\n"
-
-    buf = ''
-
-    # Open in binary mode to ensure line endings aren't converted.
-    File.open(filename, 'rb'){ |fh|
-      position = file_size - read_bytes # Set the starting read position
-
-      # Loop until we have the lines or run out of file
-      while buf.scan(line_sep).size <= num_lines and position >= 0
-        fh.seek(position, IO::SEEK_SET)
-        buf = fh.read(read_bytes) + buf
-        read_bytes = tail_size
-        position -= read_bytes
-      end
-    }
-
-    lines = buf.split(line_sep).pop(num_lines)
-
-    if block_given?
-      lines.each{ |line| yield line  }
-    else
-      lines
-    end
-  end
-
-  # Converts a text file from one OS platform format to another, ala
-  # 'dos2unix'. The possible values for +platform+ include:
-  #
-  # * MS Windows -> dos, windows, win32, mswin
-  # * Unix/BSD   -> unix, linux, bsd, osx, darwin, sunos, solaris
-  # * Mac        -> mac, macintosh, apple
-  #
-  # You may also specify 'local', in which case your CONFIG['host_os'] value
-  # will be used. This is the default.
-  #
-  # Note that this method is only valid for an ftype of "file". Otherwise a
-  # TypeError will be raised. If an invalid format value is received, an
-  # ArgumentError is raised.
-  #
-  def self.nl_convert(old_file, new_file = old_file, platform = 'local')
-    unless File::Stat.new(old_file).file?
-      raise ArgumentError, 'Only valid for plain text files'
-    end
-
-    format = nl_for_platform(platform)
-
-    orig = $\ # $OUTPUT_RECORD_SEPARATOR
-    $\ = format
-
-    if old_file == new_file
-      require 'fileutils'
-      require 'tempfile'
-
-      begin
-        temp_name = Time.new.strftime("%Y%m%d%H%M%S")
-        tf = Tempfile.new('ruby_temp_' + temp_name)
-        tf.open
-
-        IO.foreach(old_file){ |line|
-          line.chomp!
-          tf.print line
-        }
-      ensure
-        tf.close if tf && !tf.closed?
-      end
-
-      File.delete(old_file)
-      FileUtils.mv(tf.path, old_file)
-    else
-      begin
-        nf = File.new(new_file, 'w')
-        IO.foreach(old_file){ |line|
-          line.chomp!
-          nf.print line
-        }
-      ensure
-        nf.close if nf && !nf.closed?
-      end
-    end
-
-    $\ = orig
-    self
-  end
-
-  # Changes the access and modification time if present, or creates a 0
-  # byte file +filename+ if it doesn't already exist.
-  #
-  def self.touch(filename)
-    if File.exist?(filename)
-      time = Time.now
-      File.utime(time, time, filename)
-    else
-      File.open(filename, 'w'){}
-    end
-    self
-  end
-
-  # With no arguments, returns a four element array consisting of the number
-  # of bytes, characters, words and lines in filename, respectively.
-  #
-  # Valid options are 'bytes', 'characters' (or just 'chars'), 'words' and
-  # 'lines'.
-  #
-  def self.wc(filename, option='all')
-    option.downcase!
-    valid = %w/all bytes characters chars lines words/
-
-    unless valid.include?(option)
-      raise ArgumentError, "Invalid option: '#{option}'"
-    end
-
-    n = 0
-
-    if option == 'lines'
-      IO.foreach(filename){ n += 1 }
-      return n
-    elsif option == 'bytes'
-      File.open(filename){ |f|
-        f.each_byte{ n += 1 }
-      }
-      return n
-    elsif option == 'characters' || option == 'chars'
-      File.open(filename){ |f|
-        while f.getc
-          n += 1
-        end
-      }
-      return n
-    elsif option == 'words'
-      IO.foreach(filename){ |line|
-        n += line.split.length
-      }
-      return n
-    else
-      bytes,chars,lines,words = 0,0,0,0
-      IO.foreach(filename){ |line|
-        lines += 1
-        words += line.split.length
-        chars += line.split('').length
-      }
-      File.open(filename){ |f|
-        while f.getc
-          bytes += 1
-        end
-      }
-      return [bytes,chars,words,lines]
-    end
-  end
-
-  # Already provided by win32-file on MS Windows
-  unless respond_to?(:sparse?)
-    # Returns whether or not +file+ is a sparse file.
-    #
-    # A sparse file is a any file where its size is greater than the number
-    # of 512k blocks it consumes, i.e. its apparent and actual file size is
-    # not the same.
-    #
-    # See http://en.wikipedia.org/wiki/Sparse_file for more information.
-    #
-    def self.sparse?(file)
-      stats = File.stat(file)
-      stats.size > stats.blocks * 512
-    end
-  end
-
-  private
-
-  def self.nl_for_platform(platform)
-    platform = RbConfig::CONFIG["host_os"] if platform == 'local'
-
-    case platform
-      when /dos|windows|win32|mswin|mingw/i
-        return "\cM\cJ"
-      when /unix|linux|bsd|cygwin|osx|darwin|solaris|sunos/i
-        return "\cJ"
-      when /mac|apple|macintosh/i
-        return "\cM"
-      else
-        raise ArgumentError, "Invalid platform string"
-    end
-  end
-
-  def self.bmp?(file)
-    IO.read(file, 3) == "BM6"
-  end
-
-  def self.jpg?(file)
-    IO.read(file, 10, nil, :encoding => 'binary') == "\377\330\377\340\000\020JFIF".force_encoding(Encoding::BINARY)
-  end
-
-  def self.png?(file)
-    IO.read(file, 4, nil, :encoding => 'binary') == "\211PNG".force_encoding(Encoding::BINARY)
-  end
-
-  def self.gif?(file)
-    ['GIF89a', 'GIF97a'].include?(IO.read(file, 6))
-  end
-
-  def self.tiff?(file)
-    return false if File.size(file) < 12
-
-    bytes = IO.read(file, 4)
-
-    # II is Intel, MM is Motorola
-    if bytes[0..1] != 'II'&& bytes[0..1] != 'MM'
-      return false
-    end
-
-    if bytes[0..1] == 'II' && bytes[2..3].ord != 42
-      return false
-    end
-
-    if bytes[0..1] == 'MM' && bytes[2..3].reverse.ord != 42
-      return false
-    end
-
-    true
-  end
-end
+require 'rbconfig'
+require 'win32/file' if File::ALT_SEPARATOR
+
+class File
+  # The version of the ptools library.
+  PTOOLS_VERSION = '1.4.0'.freeze
+
+  # :stopdoc:
+
+  # The WIN32EXTS string is used as part of a Dir[] call in certain methods.
+  if File::ALT_SEPARATOR
+    MSWINDOWS = true
+    if ENV['PATHEXT']
+      WIN32EXTS = ('.{' + ENV['PATHEXT'].tr(';', ',').tr('.','') + '}').downcase
+    else
+      WIN32EXTS = '.{exe,com,bat}'
+    end
+  else
+    MSWINDOWS = false
+  end
+
+  IMAGE_EXT = %w[.bmp .gif .jpg .jpeg .png]
+
+  # :startdoc:
+
+  # Returns whether or not the file is an image. Only JPEG, PNG, BMP,
+  # GIF, and ICO are checked against.
+  #
+  # This method does some simple read and extension checks. For a version
+  # that is more robust, but which depends on a 3rd party C library (and is
+  # difficult to build on MS Windows), see the 'filemagic' library.
+  #
+  # Examples:
+  #
+  #    File.image?('somefile.jpg') # => true
+  #    File.image?('somefile.txt') # => false
+  #--
+  # The approach I used here is based on information found at
+  # http://en.wikipedia.org/wiki/Magic_number_(programming)
+  #
+  def self.image?(file)
+    bool = IMAGE_EXT.include?(File.extname(file).downcase)
+    bool = bmp?(file) || jpg?(file) || png?(file) || gif?(file) || tiff?(file) || ico?(file)
+    bool
+  end
+
+  # Returns whether or not +file+ is a binary non-image file, i.e. executable,
+  # shared object, ect. Note that this is NOT guaranteed to be 100% accurate.
+  # It performs a "best guess" based on a simple test of the first
+  # +File.blksize+ characters, or 4096, whichever is smaller.
+  #
+  # By default it will check to see if more than 30 percent of the characters
+  # are non-text characters. If so, the method returns true. You can configure
+  # this percentage by passing your own as a second argument.
+  #
+  # Example:
+  #
+  #   File.binary?('somefile.exe') # => true
+  #   File.binary?('somefile.txt') # => false
+  #--
+  # Based on code originally provided by Ryan Davis (which, in turn, is
+  # based on Perl's -B switch).
+  #
+  def self.binary?(file, percentage = 0.30)
+    return false if File.stat(file).zero?
+    return false if image?(file)
+    return false if check_bom?(file)
+    bytes = File.stat(file).blksize
+    bytes = 4096 if bytes > 4096
+    s = (File.read(file, bytes) || "")
+    s = s.encode('US-ASCII', :undef => :replace).split(//)
+    ((s.size - s.grep(" ".."~").size) / s.size.to_f) > percentage
+  end
+
+  # Looks for the first occurrence of +program+ within +path+.
+  #
+  # On Windows, it looks for executables ending with the suffixes defined
+  # in your PATHEXT environment variable, or '.exe', '.bat' and '.com' if
+  # that isn't defined, which you may optionally include in +program+.
+  #
+  # Returns nil if not found.
+  #
+  # Examples:
+  #
+  #   File.which('ruby') # => '/usr/local/bin/ruby'
+  #   File.which('foo')  # => nil
+  #
+  def self.which(program, path=ENV['PATH'])
+    if path.nil? || path.empty?
+      raise ArgumentError, "path cannot be empty"
+    end
+
+    # Bail out early if an absolute path is provided.
+    if program =~ /^\/|^[a-z]:[\\\/]/i
+      program += WIN32EXTS if MSWINDOWS && File.extname(program).empty?
+      found = Dir[program].first
+      if found && File.executable?(found) && !File.directory?(found)
+        return found
+      else
+        return nil
+      end
+    end
+
+    # Iterate over each path glob the dir + program.
+    path.split(File::PATH_SEPARATOR).each{ |dir|
+      dir = File.expand_path(dir)
+
+      next unless File.exist?(dir) # In case of bogus second argument
+      file = File.join(dir, program)
+
+      # Dir[] doesn't handle backslashes properly, so convert them. Also, if
+      # the program name doesn't have an extension, try them all.
+      if MSWINDOWS
+        file = file.tr("\\", "/")
+        file += WIN32EXTS if File.extname(program).empty?
+      end
+
+      found = Dir[file].first
+
+      # Convert all forward slashes to backslashes if supported
+      if found && File.executable?(found) && !File.directory?(found)
+        found.tr!(File::SEPARATOR, File::ALT_SEPARATOR) if File::ALT_SEPARATOR
+        return found
+      end
+    }
+
+    nil
+  end
+
+  # Returns an array of each +program+ within +path+, or nil if it cannot
+  # be found.
+  #
+  # On Windows, it looks for executables ending with the suffixes defined
+  # in your PATHEXT environment variable, or '.exe', '.bat' and '.com' if
+  # that isn't defined, which you may optionally include in +program+.
+  #
+  # Examples:
+  #
+  #   File.whereis('ruby') # => ['/usr/bin/ruby', '/usr/local/bin/ruby']
+  #   File.whereis('foo')  # => nil
+  #
+  def self.whereis(program, path=ENV['PATH'])
+    if path.nil? || path.empty?
+      raise ArgumentError, "path cannot be empty"
+    end
+
+    paths = []
+
+    # Bail out early if an absolute path is provided.
+    if program =~ /^\/|^[a-z]:[\\\/]/i
+      program += WIN32EXTS if MSWINDOWS && File.extname(program).empty?
+      program = program.tr("\\", '/') if MSWINDOWS
+      found = Dir[program]
+      if found[0] && File.executable?(found[0]) && !File.directory?(found[0])
+        if File::ALT_SEPARATOR
+          return found.map{ |f| f.tr('/', "\\") }
+        else
+          return found
+        end
+      else
+        return nil
+      end
+    end
+
+    # Iterate over each path glob the dir + program.
+    path.split(File::PATH_SEPARATOR).each{ |dir|
+      next unless File.exist?(dir) # In case of bogus second argument
+      file = File.join(dir, program)
+
+      # Dir[] doesn't handle backslashes properly, so convert them. Also, if
+      # the program name doesn't have an extension, try them all.
+      if MSWINDOWS
+        file = file.tr("\\", "/")
+        file += WIN32EXTS if File.extname(program).empty?
+      end
+
+      found = Dir[file].first
+
+      # Convert all forward slashes to backslashes if supported
+      if found && File.executable?(found) && !File.directory?(found)
+        found.tr!(File::SEPARATOR, File::ALT_SEPARATOR) if File::ALT_SEPARATOR
+        paths << found
+      end
+    }
+
+    paths.empty? ? nil : paths.uniq
+  end
+
+  # In block form, yields the first +num_lines+ from +filename+.  In non-block
+  # form, returns an Array of +num_lines+
+  #
+  # Examples:
+  #
+  #  # Return an array
+  #  File.head('somefile.txt') # => ['This is line1', 'This is line2', ...]
+  #
+  #  # Use a block
+  #  File.head('somefile.txt'){ |line| puts line }
+  #
+  def self.head(filename, num_lines=10)
+    a = []
+
+    IO.foreach(filename){ |line|
+      break if num_lines <= 0
+      num_lines -= 1
+      if block_given?
+        yield line
+      else
+        a << line
+      end
+    }
+
+    return a.empty? ? nil : a # Return nil in block form
+  end
+
+  # In block form, yields the last +num_lines+ of file +filename+.
+  # In non-block form, it returns the lines as an array.
+  #
+  # Example:
+  #
+  #   File.tail('somefile.txt') # => ['This is line7', 'This is line8', ...]
+  #
+  # If you're looking for tail -f functionality, please use the file-tail
+  # gem instead.
+  #
+  #--
+  # Internally I'm using a 64 chunk of memory at a time. I may allow the size
+  # to be configured in the future as an optional 3rd argument.
+  #
+  def self.tail(filename, num_lines=10)
+    tail_size = 2**16 # 64k chunks
+
+    # MS Windows gets unhappy if you try to seek backwards past the
+    # end of the file, so we have some extra checks here and later.
+    file_size  = File.size(filename)
+    read_bytes = file_size % tail_size
+    read_bytes = tail_size if read_bytes == 0
+
+    line_sep = File::ALT_SEPARATOR ? "\r\n" : "\n"
+
+    buf = ''
+
+    # Open in binary mode to ensure line endings aren't converted.
+    File.open(filename, 'rb'){ |fh|
+      position = file_size - read_bytes # Set the starting read position
+
+      # Loop until we have the lines or run out of file
+      while buf.scan(line_sep).size <= num_lines and position >= 0
+        fh.seek(position, IO::SEEK_SET)
+        buf = fh.read(read_bytes) + buf
+        read_bytes = tail_size
+        position -= read_bytes
+      end
+    }
+
+    lines = buf.split(line_sep).pop(num_lines)
+
+    if block_given?
+      lines.each{ |line| yield line  }
+    else
+      lines
+    end
+  end
+
+  # Converts a text file from one OS platform format to another, ala
+  # 'dos2unix'. The possible values for +platform+ include:
+  #
+  # * MS Windows -> dos, windows, win32, mswin
+  # * Unix/BSD   -> unix, linux, bsd, osx, darwin, sunos, solaris
+  # * Mac        -> mac, macintosh, apple
+  #
+  # You may also specify 'local', in which case your CONFIG['host_os'] value
+  # will be used. This is the default.
+  #
+  # Note that this method is only valid for an ftype of "file". Otherwise a
+  # TypeError will be raised. If an invalid format value is received, an
+  # ArgumentError is raised.
+  #
+  def self.nl_convert(old_file, new_file = old_file, platform = 'local')
+    unless File::Stat.new(old_file).file?
+      raise ArgumentError, 'Only valid for plain text files'
+    end
+
+    format = nl_for_platform(platform)
+
+    orig = $\ # $OUTPUT_RECORD_SEPARATOR
+    $\ = format
+
+    if old_file == new_file
+      require 'fileutils'
+      require 'tempfile'
+
+      begin
+        temp_name = Time.new.strftime("%Y%m%d%H%M%S")
+        tf = Tempfile.new('ruby_temp_' + temp_name)
+        tf.open
+
+        IO.foreach(old_file){ |line|
+          line.chomp!
+          tf.print line
+        }
+      ensure
+        tf.close if tf && !tf.closed?
+      end
+
+      File.delete(old_file)
+      FileUtils.mv(tf.path, old_file)
+    else
+      begin
+        nf = File.new(new_file, 'w')
+        IO.foreach(old_file){ |line|
+          line.chomp!
+          nf.print line
+        }
+      ensure
+        nf.close if nf && !nf.closed?
+      end
+    end
+
+    $\ = orig
+    self
+  end
+
+  # Changes the access and modification time if present, or creates a 0
+  # byte file +filename+ if it doesn't already exist.
+  #
+  def self.touch(filename)
+    if File.exist?(filename)
+      time = Time.now
+      File.utime(time, time, filename)
+    else
+      File.open(filename, 'w'){}
+    end
+    self
+  end
+
+  # With no arguments, returns a four element array consisting of the number
+  # of bytes, characters, words and lines in filename, respectively.
+  #
+  # Valid options are 'bytes', 'characters' (or just 'chars'), 'words' and
+  # 'lines'.
+  #
+  def self.wc(filename, option='all')
+    option.downcase!
+    valid = %w/all bytes characters chars lines words/
+
+    unless valid.include?(option)
+      raise ArgumentError, "Invalid option: '#{option}'"
+    end
+
+    n = 0
+
+    if option == 'lines'
+      IO.foreach(filename){ n += 1 }
+      return n
+    elsif option == 'bytes'
+      File.open(filename){ |f|
+        f.each_byte{ n += 1 }
+      }
+      return n
+    elsif option == 'characters' || option == 'chars'
+      File.open(filename){ |f|
+        while f.getc
+          n += 1
+        end
+      }
+      return n
+    elsif option == 'words'
+      IO.foreach(filename){ |line|
+        n += line.split.length
+      }
+      return n
+    else
+      bytes,chars,lines,words = 0,0,0,0
+      IO.foreach(filename){ |line|
+        lines += 1
+        words += line.split.length
+        chars += line.split('').length
+      }
+      File.open(filename){ |f|
+        while f.getc
+          bytes += 1
+        end
+      }
+      return [bytes,chars,words,lines]
+    end
+  end
+
+  # Already provided by win32-file on MS Windows
+  unless respond_to?(:sparse?)
+    # Returns whether or not +file+ is a sparse file.
+    #
+    # A sparse file is a any file where its size is greater than the number
+    # of 512k blocks it consumes, i.e. its apparent and actual file size is
+    # not the same.
+    #
+    # See http://en.wikipedia.org/wiki/Sparse_file for more information.
+    #
+    def self.sparse?(file)
+      stats = File.stat(file)
+      stats.size > stats.blocks * 512
+    end
+  end
+
+  private
+
+  # Returns whether or not the given +text+ contains a BOM marker.
+  # If present, we can generally assume it's a text file.
+  #
+  def self.check_bom?(file)
+    text = File.read(file, 4).force_encoding('utf-8')
+
+    bool = false
+    bool = true if text[0,3] == "\xEF\xBB\xBF"
+    bool = true if text[0,4] == "\x00\x00\xFE\xFF" || text[0,4] == "\xFF\xFE\x00\x00"
+    bool = true if text[0,2] == "\xFF\xFE" || text[0,2] == "\xFE\xFF"
+
+    bool
+  end
+
+  def self.nl_for_platform(platform)
+    platform = RbConfig::CONFIG["host_os"] if platform == 'local'
+
+    case platform
+      when /dos|windows|win32|mswin|mingw/i
+        return "\cM\cJ"
+      when /unix|linux|bsd|cygwin|osx|darwin|solaris|sunos/i
+        return "\cJ"
+      when /mac|apple|macintosh/i
+        return "\cM"
+      else
+        raise ArgumentError, "Invalid platform string"
+    end
+  end
+
+  def self.bmp?(file)
+    IO.read(file, 3) == "BM6"
+  end
+
+  def self.jpg?(file)
+    IO.read(file, 10, nil, :encoding => 'binary') == "\377\330\377\340\000\020JFIF".force_encoding(Encoding::BINARY)
+  end
+
+  def self.png?(file)
+    IO.read(file, 4, nil, :encoding => 'binary') == "\211PNG".force_encoding(Encoding::BINARY)
+  end
+
+  def self.gif?(file)
+    ['GIF89a', 'GIF97a'].include?(IO.read(file, 6))
+  end
+
+  def self.tiff?(file)
+    return false if File.size(file) < 12
+
+    bytes = IO.read(file, 4)
+
+    # II is Intel, MM is Motorola
+    if bytes[0..1] != 'II'&& bytes[0..1] != 'MM'
+      return false
+    end
+
+    if bytes[0..1] == 'II' && bytes[2..3].ord != 42
+      return false
+    end
+
+    if bytes[0..1] == 'MM' && bytes[2..3].reverse.ord != 42
+      return false
+    end
+
+    true
+  end
+
+  def self.ico?(file)
+    ["\000\000\001\000", "\000\000\002\000"].include?(IO.read(file, 4, nil, :encoding => 'binary'))
+  end
+end