win32-file 0.7.2 → 0.7.3

data/MANIFEST

@@ -1,13 +1,15 @@
-* CHANGES
-* MANIFEST
-* Rakefile
-* README
-* win32-file.gemspec
-* lib/win32/file.rb
-* lib/win32/file/constants.rb
-* lib/win32/file/functions.rb
-* lib/win32/file/structs.rb
-* test/test_win32_file_path.rb
-* test/test_win32_file_link.rb
-* test/test_win32_file_misc.rb
-* test/test_win32_file_stat.rb
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* win32-file.gemspec
+* certs/djberg96_pub.pem
+* lib/win32-file.rb
+* lib/win32/file.rb
+* lib/win32/file/constants.rb
+* lib/win32/file/functions.rb
+* lib/win32/file/structs.rb
+* test/test_win32_file_path.rb
+* test/test_win32_file_link.rb
+* test/test_win32_file_misc.rb
+* test/test_win32_file_stat.rb

data/README

@@ -1,70 +1,70 @@
-== Description
-  Additional methods for the File class on MS Windows. Plus, several existing
-  methods have been redefined to make them work properly on MS Windows.
-
-== Prerequisites
-  * win32-file-stat
-
-== Installation
-  gem install win32-file
-
-== Synopsis
-  require 'win32/file'
-
-  p File.long_path("C:/Progra~1")       # => C:\Program Files
-  p File.short_path("C:/Program Files") # => C:\Progra~1
-
-  # See redefined methods below
-
-== Singleton Methods Added
-  * File.long_path
-  * File.short_path
-
-== Singleton Methods Redefined
-  * File.basename         # UNC path issues, root path differences.
-  * File.blksize          # Not implemented in MRI
-  * File.blockdev?        # Not implemented in MRI
-  * File.chardev?         # Not implemented in MRI
-  * File.directory?       # Better wide character string handling than MRI
-  * File.dirname          # UNC path issues in MRI
-  * File.executable?      # Not implemented in MRI
-  * File.file?            # Handles non-regular files better than MRI
-  * File.ftype            # Handles non-regular files better than MRI
-  * File.join             # For uniform handling of path separators.
-  * File.grpowned?        # Not implemented in MRI
-  * File.lstat            # Not implemented in MRI
-  * File.owned?           # Not implemented in MRI
-  * File.pipe?            # Not implemented in MRI
-  * File.readable?        # Not implemented in MRI
-  * File.realpath         # MRI doesn't handle symlinks
-  * File.realdirpath      # MRI doesn't handle symlinks
-  * File.socket?          # Not implemented in MRI
-  * File.readlink         # Not implemented in MRI
-  * File.split            # UNC path issues in MRI
-  * File.stat             # Uses object returned by win32-file-stat
-  * File.symlink          # Not implemented in MRI
-  * File.symlink?         # Not implemented in MRI
-  * File.writable?        # Not implemented in MRI
-  * File.world_writable?  # Not implemented in MRI
-
-== Known issues or bugs
-  The File.exist? method will return true on stale symlinks.
-
-  Please report any other issues you find on the github page at:
-
-  https://github.com/djberg96/win32-file/issues
-
-== 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.
-
-== Authors
-  * Daniel J. Berger
-  * Park Heesob
+== Description
+  Additional methods for the File class on MS Windows. Plus, several existing
+  methods have been redefined to make them work properly on MS Windows.
+
+== Prerequisites
+  * win32-file-stat
+
+== Installation
+  gem install win32-file
+
+== Synopsis
+  require 'win32/file'
+
+  p File.long_path("C:/Progra~1")       # => C:\Program Files
+  p File.short_path("C:/Program Files") # => C:\Progra~1
+
+  # See redefined methods below
+
+== Singleton Methods Added
+  * File.long_path
+  * File.short_path
+
+== Singleton Methods Redefined
+  * File.basename         # UNC path issues, root path differences.
+  * File.blksize          # Not implemented in MRI
+  * File.blockdev?        # Not implemented in MRI
+  * File.chardev?         # Not implemented in MRI
+  * File.directory?       # Better wide character string handling than MRI
+  * File.dirname          # UNC path issues in MRI
+  * File.executable?      # Not implemented in MRI
+  * File.file?            # Handles non-regular files better than MRI
+  * File.ftype            # Handles non-regular files better than MRI
+  * File.join             # For uniform handling of path separators.
+  * File.grpowned?        # Not implemented in MRI
+  * File.lstat            # Not implemented in MRI
+  * File.owned?           # Not implemented in MRI
+  * File.pipe?            # Not implemented in MRI
+  * File.readable?        # Not implemented in MRI
+  * File.realpath         # MRI doesn't handle symlinks
+  * File.realdirpath      # MRI doesn't handle symlinks
+  * File.socket?          # Not implemented in MRI
+  * File.readlink         # Not implemented in MRI
+  * File.split            # UNC path issues in MRI
+  * File.stat             # Uses object returned by win32-file-stat
+  * File.symlink          # Not implemented in MRI
+  * File.symlink?         # Not implemented in MRI
+  * File.writable?        # Not implemented in MRI
+  * File.world_writable?  # Not implemented in MRI
+
+== Known issues or bugs
+  The File.exist? method will return true on stale symlinks.
+
+  Please report any other issues you find on the github page at:
+
+  https://github.com/djberg96/win32-file/issues
+
+== License
+  Artistic 2.0
+
+== Copyright
+  (C) 2003-2015, 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.
+
+== Authors
+  * Daniel J. Berger
+  * Park Heesob

data/Rakefile

@@ -1,52 +1,49 @@
-require 'rake'
-require 'rake/testtask'
-require 'rake/clean'
-
-CLEAN.include("**/*.txt", "**/*.gem", "**/*.rbc")
-
-namespace 'gem' do
-  desc 'Create the win32-file gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-file.gemspec'))
-    if Gem::VERSION < "2.0"
-      Gem::Builder.new(spec).build  
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end  
-  end
-
-  desc 'Install the win32-file gem'
-  task :install => [:create] do
-    file = Dir['win32-file*.gem'].first
-    sh "gem install -l #{file}"
-  end
-end
-
-namespace 'test' do
-  Rake::TestTask.new("all") do |t|
-    t.verbose = true
-    t.warning = true
-  end
-
-  Rake::TestTask.new("link") do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_win32_file_link.rb']
-  end
-
-  Rake::TestTask.new("path") do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_win32_file_path.rb']
-  end
-
-  Rake::TestTask.new("stat") do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_win32_file_stat.rb']
-  end
-end
-
-task :test => ['test:all']
-task :default => ['test:all']
+require 'rake'
+require 'rake/testtask'
+require 'rake/clean'
+
+CLEAN.include("**/*.txt", "**/*.gem", "**/*.rbc")
+
+namespace 'gem' do
+  desc 'Create the win32-file gem'
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('win32-file.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec)
+  end
+
+  desc 'Install the win32-file gem'
+  task :install => [:create] do
+    file = Dir['win32-file*.gem'].first
+    sh "gem install -l #{file}"
+  end
+end
+
+namespace 'test' do
+  Rake::TestTask.new("all") do |t|
+    t.verbose = true
+    t.warning = true
+  end
+
+  Rake::TestTask.new("link") do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = FileList['test/test_win32_file_link.rb']
+  end
+
+  Rake::TestTask.new("path") do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = FileList['test/test_win32_file_path.rb']
+  end
+
+  Rake::TestTask.new("stat") do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = FileList['test/test_win32_file_stat.rb']
+  end
+end
+
+task :test => ['test:all']
+task :default => ['test:all']

data/certs/djberg96_pub.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
+Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
+S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
+gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
+FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
+zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
+DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
+nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
+bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
+ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
+tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
+/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
+wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
+EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
+tGSHgAmcLlkdGgan182qsE/4kKM=
+-----END CERTIFICATE-----

data/lib/win32-file.rb

@@ -0,0 +1 @@
+require_relative 'win32/file'

data/lib/win32/file.rb

@@ -1,516 +1,516 @@
-require_relative 'file/constants'
-require_relative 'file/structs'
-require_relative 'file/functions'
-require 'win32/file/stat'
-
-class File
-  include Windows::File::Constants
-  include Windows::File::Structs
-  extend Windows::File::Functions
-
-  # The version of the win32-file library
-  WIN32_FILE_VERSION = '0.7.2'
-
-  class << self
-    alias_method :join_orig, :join
-    alias_method :realpath_orig, :realpath
-    alias_method :realdirpath_orig, :realdirpath
-
-    remove_method :basename, :blockdev?, :chardev?, :dirname, :directory?
-    remove_method :executable?, :executable_real?, :file?, :ftype, :grpowned?
-    remove_method :join, :lstat, :owned?, :pipe?, :socket?
-    remove_method :readable?, :readable_real?, :readlink, :realpath
-    remove_method :realdirpath
-    remove_method :split, :stat
-    remove_method :symlink
-    remove_method :symlink?
-    remove_method :world_readable?, :world_writable?
-    remove_method :writable?, :writable_real?
-  end
-
-  ## Path methods
-
-  # Returns the last component of the filename given in +filename+.  If
-  # +suffix+ is given and present at the end of +filename+, it is removed.
-  # Any extension can be removed by giving an extension of ".*".
-  #
-  # This was reimplemented because the current version does not handle UNC
-  # paths properly, i.e. it should not return anything less than the root.
-  # In most other respects it is identical to the current implementation,
-  # except that it does not strip the drive letter on a root path.
-  #
-  # Unlike MRI, this version will convert all forward slashes to
-  # backslashes automatically.
-  #
-  # Examples:
-  #
-  #    File.basename("C:\\foo\\bar.txt")         -> "bar.txt"
-  #    File.basename("C:\\foo\\bar.txt", ".txt") -> "bar"
-  #    File.basename("\\\\foo\\bar")             -> "\\\\foo\\bar"
-  #
-  def self.basename(file, suffix = nil)
-    file = string_check(file)
-    suffix = string_check(suffix) if suffix
-
-    return file if file.empty? # Return an empty path as-is.
-
-    encoding = file.encoding
-    wfile = file.wincode
-
-    # Return a root path as-is.
-    if PathIsRootW(wfile)
-      return file.tr(File::SEPARATOR, File::ALT_SEPARATOR)
-    end
-
-    ptr = FFI::MemoryPointer.from_string(wfile)
-
-    PathStripPathW(ptr) # Gives us the basename
-
-    if suffix
-      if suffix == '.*'
-        PathRemoveExtensionW(ptr)
-      else
-        ext = PathFindExtensionW(ptr).read_string(suffix.length * 2).wstrip
-
-        if ext == suffix
-          PathRemoveExtensionW(ptr)
-        end
-      end
-    end
-
-    wfile = ptr.read_bytes(wfile.size * 2).split("\000\000").first.tr(0.chr, '')
-    file = wfile.encode(encoding)[/^[^\0]*/]
-    file.sub!(/\\+\z/, '') # Trim trailing slashes
-
-    ptr.free
-
-    file
-  end
-
-  # Returns all components of the filename given in +filename+ except the
-  # last one.
-  #
-  # This was reimplemented because the current version does not handle UNC
-  # paths properly, i.e. it should not return anything less than the root.
-  # In all other respects it is identical to the current implementation.
-  #
-  # Also, this method will convert all forward slashes to backslashes.
-  #
-  # Examples:
-  #
-  #    File.dirname("C:\\foo\\bar\\baz.txt") -> "C:\\foo\\bar"
-  #    File.dirname("\\\\foo\\bar")          -> "\\\\foo\\bar"
-  #
-  def self.dirname(file)
-    file = string_check(file)
-
-    # Short circuit for empty paths
-    return '.' if file.empty?
-
-    # Store original encoding, restore it later
-    encoding = file.encoding
-
-    # Convert to UTF-16LE
-    wfile = file.wincode
-
-    # Return a root path as-is.
-    if PathIsRootW(wfile)
-      return file.tr(File::SEPARATOR, File::ALT_SEPARATOR)
-    end
-
-    ptr = FFI::MemoryPointer.from_string(wfile)
-
-    # Remove trailing slashes if present
-    while result = PathRemoveBackslashW(ptr)
-      break unless result.empty?
-    end
-
-    # Remove trailing file name if present
-    unless PathRemoveFileSpecW(ptr)
-      raise SystemCallError.new("PathRemoveFileSpec", FFI.errno)
-    end
-
-    wfile = ptr.read_bytes(wfile.size * 2).split("\000\000").first
-
-    # Empty paths, short relative paths
-    if wfile.nil? or wfile.empty?
-      return '.'
-    end
-
-    # Return to original encoding
-    file = wfile.tr(0.chr, '').encode(encoding)
-
-    ptr.free
-
-    file
-  end
-
-  # Join path string components together into a single string.
-  #
-  # This method was reimplemented so that it automatically converts
-  # forward slashes to backslashes. It is otherwise identical to
-  # the core File.join method.
-  #
-  # Examples:
-  #
-  #   File.join("C:", "foo", "bar") # => C:\foo\bar
-  #   File.join("foo", "bar")       # => foo\bar
-  #
-  def self.join(*args)
-    return join_orig(*args).tr("/", "\\")
-  end
-
-  # Splits the given string into a directory and a file component and
-  # returns them in a two element array. This was reimplemented because
-  # the current version does not handle UNC paths properly.
-  #
-  def self.split(file)
-    file = string_check(file)
-    array = []
-
-    if file.empty? || PathIsRootW(file.wincode)
-      array.push(file, '')
-    else
-      array.push(File.dirname(file), File.basename(file))
-    end
-
-    array
-  end
-
-  # Returns +path+ in long format. For example, if 'SOMEFI~1.TXT'
-  # was the argument provided, and the short representation for
-  # 'somefile.txt', then this method would return 'somefile.txt'.
-  #
-  # Note that certain file system optimizations may prevent this method
-  # from working as expected. In that case, you will get back the file
-  # name in 8.3 format.
-  #
-  def self.long_path(file)
-    buffer = FFI::Buffer.new(:wint_t, 1024, true)
-    wfile  = string_check(file).wincode
-
-    length = GetLongPathNameW(wfile, buffer, buffer.size)
-
-    if length == 0 || length > buffer.size / 2
-      raise SystemCallError.new('GetLongPathName', FFI.errno)
-    end
-
-    buffer.read_bytes(length * 2).wstrip
-  end
-
-  # Returns +path+ in 8.3 format. For example, 'c:\documentation.doc'
-  # would be returned as 'c:\docume~1.doc'.
-  #
-  def self.short_path(file)
-    buffer = FFI::Buffer.new(:wint_t, 1024, true)
-    wfile  = string_check(file).wincode
-
-    length = GetShortPathNameW(wfile, buffer, buffer.size)
-
-    if length == 0 || length > buffer.size / 2
-      raise SystemCallError.new('GetShortPathName', FFI.errno)
-    end
-
-    buffer.read_bytes(length * 2).wstrip
-  end
-
-  # Creates a symbolic link called +new_name+ for the file or directory
-  # +old_name+.
-  #
-  # This method requires Windows Vista or later to work. Otherwise, it
-  # returns nil as per MRI.
-  #
-  def self.symlink(target, link)
-    target = string_check(target)
-    link = string_check(link)
-
-    flags = File.directory?(target) ? 1 : 0
-
-    wlink = link.wincode
-    wtarget = target.wincode
-
-    unless CreateSymbolicLinkW(wlink, wtarget, flags)
-      raise SystemCallError.new('CreateSymbolicLink', FFI.errno)
-    end
-
-    0 # Comply with spec
-  end
-
-  # Returns whether or not +file+ is a symlink.
-  #
-  def self.symlink?(file)
-    return false unless File.exist?(file)
-
-    bool  = false
-    wfile = string_check(file).wincode
-
-    attrib = GetFileAttributesW(wfile)
-
-    if attrib == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new('GetFileAttributes', FFI.errno)
-    end
-
-    if attrib & FILE_ATTRIBUTE_REPARSE_POINT > 0
-      begin
-        find_data = WIN32_FIND_DATA.new
-        handle = FindFirstFileW(wfile, find_data)
-
-        if handle == INVALID_HANDLE_VALUE
-          raise SystemCallError.new('FindFirstFile', FFI.errno)
-        end
-
-        if find_data[:dwReserved0] == IO_REPARSE_TAG_SYMLINK
-          bool = true
-        end
-      ensure
-        CloseHandle(handle)
-      end
-    end
-
-    bool
-  end
-
-  # Converts path to a full file path, with all symlinks resolved and relative
-  # paths made absolute. If a second parameter if present, it is used as the
-  # base for resolving leading relative path segments.
-  #
-  # Unlike File.realpath, an error is not raised if the final path created
-  # using a relative path argument doesn't exist.
-  #--
-  # On Windows we only modify the realpath method if the file is a symlink.
-  #
-  def self.realdirpath(file, relative_to = nil)
-    file = string_check(file)
-
-    if symlink?(file)
-      if relative_to
-        File.join(relative_to, File.basename(readlink(file)))
-      else
-        readlink(file)
-      end
-    else
-      realdirpath_orig(file, relative_to)
-    end
-  end
-
-  # Converts path to a full file path, with all symlinks resolved and relative
-  # paths made absolute. If a second parameter if present, it is used as the
-  # base for resolving leading relative path segments.
-  #--
-  # On Windows we only modify the realpath method if the file is a symlink.
-  #
-  def self.realpath(file, relative_to = nil)
-    file = string_check(file)
-    relative_to = string_check(relative_to) if relative_to
-
-    if symlink?(file)
-      if relative_to
-        result = File.join(relative_to, File.basename(readlink(file)))
-        if File.exist?(result)
-          result
-        else
-          raise SystemCallError.new(result, 2) # Errno::ENOENT
-        end
-      else
-        readlink(file)
-      end
-    else
-      realpath_orig(file, relative_to)
-    end
-  end
-
-  # Returns the path of the of the symbolic link referred to by +file+.
-  #
-  # Unlike unixy platforms, this will raise an error if the link is stale.
-  #
-  def self.readlink(file)
-    file = string_check(file)
-
-    if exist?(file) && !symlink?(file)
-      raise SystemCallError.new(22) # EINVAL, match the spec
-    end
-
-    wfile = file.wincode
-    path  = 0.chr * 1024
-
-    if File.directory?(file)
-      flags = FILE_FLAG_BACKUP_SEMANTICS
-    else
-      flags = FILE_ATTRIBUTE_NORMAL
-    end
-
-    begin
-      handle = CreateFileW(
-        wfile,
-        GENERIC_READ,
-        FILE_SHARE_READ,
-        nil,
-        OPEN_EXISTING,
-        flags,
-        0
-      )
-
-      if handle == INVALID_HANDLE_VALUE
-        raise SystemCallError.new('CreateFile', FFI.errno)
-      end
-
-      if GetFinalPathNameByHandleW(handle, path, path.size/2, 0) == 0
-        raise SystemCallError.new('GetFinalPathNameByHandle', FFI.errno)
-      end
-    ensure
-      CloseHandle(handle)
-    end
-
-    path.wstrip[4..-1] # Remove leading backslashes + question mark
-  end
-
-  ## STAT METHODS
-
-  # Returns the filesystem's block size.
-  #
-  def self.blksize(file)
-    File::Stat.new(file).blksize
-  end
-
-  # Returns whether or not the file is a block device. For MS Windows a
-  # block device is a removable drive, cdrom or ramdisk.
-  #
-  def self.blockdev?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).blockdev?
-  end
-
-  # Returns whether or not the file is a character device.
-  #
-  def self.chardev?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).chardev?
-  end
-
-  # Returns whether or not the file is a directory.
-  #
-  def self.directory?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).directory?
-  end
-
-  # Returns whether or not the file is executable.
-  #
-  def self.executable?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).executable?
-  end
-
-  # Returns whether or not the file is a regular file.
-  #
-  def self.file?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).file?
-  end
-
-  # Identifies the type of file. The return string is one of 'file',
-  # 'directory', 'characterSpecial', 'socket' or 'unknown'.
-  #
-  def self.ftype(file)
-    File::Stat.new(file).ftype
-  end
-
-  # Returns true if the process owner's ID is the same as one of the file's groups.
-  #
-  def self.grpowned?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).grpowned?
-  end
-
-  # Returns whether or not the current process owner is the owner of the file.
-  #
-  def self.owned?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).owned?
-  end
-
-  # Returns whether or not the file is a pipe.
-  #
-  def self.pipe?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).pipe?
-  end
-
-  # Returns whether or not the file is readable by the process owner.
-  #
-  def self.readable?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).readable?
-  end
-
-  # Synonym for File.readable?
-  #
-  def self.readable_real?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).readable_real?
-  end
-
-  # Returns a File::Stat object as defined in the win32-file-stat library.
-  #
-  def self.stat(file)
-    File::Stat.new(file)
-  end
-
-  # Returns whether or not the file is readable by others. Note that this
-  # merely returns true or false, not permission bits (or nil).
-  #
-  def self.world_readable?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).world_readable?
-  end
-
-  # Returns whether or not the file is writable by others. Note that this
-  # merely returns true or false, not permission bits (or nil).
-  #
-  def self.world_writable?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).world_writable?
-  end
-
-  # Returns whether or not the file is writable by the current process owner.
-  #
-  def self.writable?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).writable?
-  end
-
-  # Synonym for File.writable?
-  #
-  def self.writable_real?(file)
-    return false unless File.exist?(file)
-    File::Stat.new(file).writable_real?
-  end
-
-  # Singleton aliases
-  class << self
-    alias lstat stat
-    alias executable_real? executable?
-    alias socket? pipe?
-  end
-
-  ## Instance Methods
-
-  # Same as MRI, except it returns a stat object using the win32-file-stat gem.
-  #
-  def stat
-    File::Stat.new(self.path)
-  end
-
-  # Private singleton methods
-  class << self
-    private
-
-    # Simulate Ruby's string checking
-    def string_check(arg)
-      return arg if arg.is_a?(String)
-      return arg.send(:to_str) if arg.respond_to?(:to_str, true) # MRI allows private to_str
-      return arg.to_path if arg.respond_to?(:to_path)
-      raise TypeError
-    end
-  end
-end
+require_relative 'file/constants'
+require_relative 'file/structs'
+require_relative 'file/functions'
+require 'win32/file/stat'
+
+class File
+  include Windows::File::Constants
+  include Windows::File::Structs
+  extend Windows::File::Functions
+
+  # The version of the win32-file library
+  WIN32_FILE_VERSION = '0.7.3'
+
+  class << self
+    alias_method :join_orig, :join
+    alias_method :realpath_orig, :realpath
+    alias_method :realdirpath_orig, :realdirpath
+
+    remove_method :basename, :blockdev?, :chardev?, :dirname, :directory?
+    remove_method :executable?, :executable_real?, :file?, :ftype, :grpowned?
+    remove_method :join, :lstat, :owned?, :pipe?, :socket?
+    remove_method :readable?, :readable_real?, :readlink, :realpath
+    remove_method :realdirpath
+    remove_method :split, :stat
+    remove_method :symlink
+    remove_method :symlink?
+    remove_method :world_readable?, :world_writable?
+    remove_method :writable?, :writable_real?
+  end
+
+  ## Path methods
+
+  # Returns the last component of the filename given in +filename+.  If
+  # +suffix+ is given and present at the end of +filename+, it is removed.
+  # Any extension can be removed by giving an extension of ".*".
+  #
+  # This was reimplemented because the current version does not handle UNC
+  # paths properly, i.e. it should not return anything less than the root.
+  # In most other respects it is identical to the current implementation,
+  # except that it does not strip the drive letter on a root path.
+  #
+  # Unlike MRI, this version will convert all forward slashes to
+  # backslashes automatically.
+  #
+  # Examples:
+  #
+  #    File.basename("C:\\foo\\bar.txt")         -> "bar.txt"
+  #    File.basename("C:\\foo\\bar.txt", ".txt") -> "bar"
+  #    File.basename("\\\\foo\\bar")             -> "\\\\foo\\bar"
+  #
+  def self.basename(file, suffix = nil)
+    file = string_check(file)
+    suffix = string_check(suffix) if suffix
+
+    return file if file.empty? # Return an empty path as-is.
+
+    encoding = file.encoding
+    wfile = file.wincode
+
+    # Return a root path as-is.
+    if PathIsRootW(wfile)
+      return file.tr(File::SEPARATOR, File::ALT_SEPARATOR)
+    end
+
+    ptr = FFI::MemoryPointer.from_string(wfile)
+
+    PathStripPathW(ptr) # Gives us the basename
+
+    if suffix
+      if suffix == '.*'
+        PathRemoveExtensionW(ptr)
+      else
+        ext = PathFindExtensionW(ptr).read_string(suffix.length * 2).wstrip
+
+        if ext == suffix
+          PathRemoveExtensionW(ptr)
+        end
+      end
+    end
+
+    wfile = ptr.read_bytes(wfile.size * 2).split("\000\000").first.tr(0.chr, '')
+    file = wfile.encode(encoding)[/^[^\0]*/]
+    file.sub!(/\\+\z/, '') # Trim trailing slashes
+
+    ptr.free
+
+    file
+  end
+
+  # Returns all components of the filename given in +filename+ except the
+  # last one.
+  #
+  # This was reimplemented because the current version does not handle UNC
+  # paths properly, i.e. it should not return anything less than the root.
+  # In all other respects it is identical to the current implementation.
+  #
+  # Also, this method will convert all forward slashes to backslashes.
+  #
+  # Examples:
+  #
+  #    File.dirname("C:\\foo\\bar\\baz.txt") -> "C:\\foo\\bar"
+  #    File.dirname("\\\\foo\\bar")          -> "\\\\foo\\bar"
+  #
+  def self.dirname(file)
+    file = string_check(file)
+
+    # Short circuit for empty paths
+    return '.' if file.empty?
+
+    # Store original encoding, restore it later
+    encoding = file.encoding
+
+    # Convert to UTF-16LE
+    wfile = file.wincode
+
+    # Return a root path as-is.
+    if PathIsRootW(wfile)
+      return file.tr(File::SEPARATOR, File::ALT_SEPARATOR)
+    end
+
+    ptr = FFI::MemoryPointer.from_string(wfile)
+
+    # Remove trailing slashes if present
+    while result = PathRemoveBackslashW(ptr)
+      break unless result.empty?
+    end
+
+    # Remove trailing file name if present
+    unless PathRemoveFileSpecW(ptr)
+      raise SystemCallError.new("PathRemoveFileSpec", FFI.errno)
+    end
+
+    wfile = ptr.read_bytes(wfile.size * 2).split("\000\000").first
+
+    # Empty paths, short relative paths
+    if wfile.nil? or wfile.empty?
+      return '.'
+    end
+
+    # Return to original encoding
+    file = wfile.tr(0.chr, '').encode(encoding)
+
+    ptr.free
+
+    file
+  end
+
+  # Join path string components together into a single string.
+  #
+  # This method was reimplemented so that it automatically converts
+  # forward slashes to backslashes. It is otherwise identical to
+  # the core File.join method.
+  #
+  # Examples:
+  #
+  #   File.join("C:", "foo", "bar") # => C:\foo\bar
+  #   File.join("foo", "bar")       # => foo\bar
+  #
+  def self.join(*args)
+    return join_orig(*args).tr("/", "\\")
+  end
+
+  # Splits the given string into a directory and a file component and
+  # returns them in a two element array. This was reimplemented because
+  # the current version does not handle UNC paths properly.
+  #
+  def self.split(file)
+    file = string_check(file)
+    array = []
+
+    if file.empty? || PathIsRootW(file.wincode)
+      array.push(file, '')
+    else
+      array.push(File.dirname(file), File.basename(file))
+    end
+
+    array
+  end
+
+  # Returns +path+ in long format. For example, if 'SOMEFI~1.TXT'
+  # was the argument provided, and the short representation for
+  # 'somefile.txt', then this method would return 'somefile.txt'.
+  #
+  # Note that certain file system optimizations may prevent this method
+  # from working as expected. In that case, you will get back the file
+  # name in 8.3 format.
+  #
+  def self.long_path(file)
+    buffer = FFI::Buffer.new(:wint_t, 1024, true)
+    wfile  = string_check(file).wincode
+
+    length = GetLongPathNameW(wfile, buffer, buffer.size)
+
+    if length == 0 || length > buffer.size / 2
+      raise SystemCallError.new('GetLongPathName', FFI.errno)
+    end
+
+    buffer.read_bytes(length * 2).wstrip
+  end
+
+  # Returns +path+ in 8.3 format. For example, 'c:\documentation.doc'
+  # would be returned as 'c:\docume~1.doc'.
+  #
+  def self.short_path(file)
+    buffer = FFI::Buffer.new(:wint_t, 1024, true)
+    wfile  = string_check(file).wincode
+
+    length = GetShortPathNameW(wfile, buffer, buffer.size)
+
+    if length == 0 || length > buffer.size / 2
+      raise SystemCallError.new('GetShortPathName', FFI.errno)
+    end
+
+    buffer.read_bytes(length * 2).wstrip
+  end
+
+  # Creates a symbolic link called +new_name+ for the file or directory
+  # +old_name+.
+  #
+  # This method requires Windows Vista or later to work. Otherwise, it
+  # returns nil as per MRI.
+  #
+  def self.symlink(target, link)
+    target = string_check(target)
+    link = string_check(link)
+
+    flags = File.directory?(target) ? 1 : 0
+
+    wlink = link.wincode
+    wtarget = target.wincode
+
+    unless CreateSymbolicLinkW(wlink, wtarget, flags)
+      raise SystemCallError.new('CreateSymbolicLink', FFI.errno)
+    end
+
+    0 # Comply with spec
+  end
+
+  # Returns whether or not +file+ is a symlink.
+  #
+  def self.symlink?(file)
+    return false unless File.exist?(file)
+
+    bool  = false
+    wfile = string_check(file).wincode
+
+    attrib = GetFileAttributesW(wfile)
+
+    if attrib == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new('GetFileAttributes', FFI.errno)
+    end
+
+    if attrib & FILE_ATTRIBUTE_REPARSE_POINT > 0
+      begin
+        find_data = WIN32_FIND_DATA.new
+        handle = FindFirstFileW(wfile, find_data)
+
+        if handle == INVALID_HANDLE_VALUE
+          raise SystemCallError.new('FindFirstFile', FFI.errno)
+        end
+
+        if find_data[:dwReserved0] == IO_REPARSE_TAG_SYMLINK
+          bool = true
+        end
+      ensure
+        CloseHandle(handle)
+      end
+    end
+
+    bool
+  end
+
+  # Converts path to a full file path, with all symlinks resolved and relative
+  # paths made absolute. If a second parameter if present, it is used as the
+  # base for resolving leading relative path segments.
+  #
+  # Unlike File.realpath, an error is not raised if the final path created
+  # using a relative path argument doesn't exist.
+  #--
+  # On Windows we only modify the realpath method if the file is a symlink.
+  #
+  def self.realdirpath(file, relative_to = nil)
+    file = string_check(file)
+
+    if symlink?(file)
+      if relative_to
+        File.join(relative_to, File.basename(readlink(file)))
+      else
+        readlink(file)
+      end
+    else
+      realdirpath_orig(file, relative_to)
+    end
+  end
+
+  # Converts path to a full file path, with all symlinks resolved and relative
+  # paths made absolute. If a second parameter if present, it is used as the
+  # base for resolving leading relative path segments.
+  #--
+  # On Windows we only modify the realpath method if the file is a symlink.
+  #
+  def self.realpath(file, relative_to = nil)
+    file = string_check(file)
+    relative_to = string_check(relative_to) if relative_to
+
+    if symlink?(file)
+      if relative_to
+        result = File.join(relative_to, File.basename(readlink(file)))
+        if File.exist?(result)
+          result
+        else
+          raise SystemCallError.new(result, 2) # Errno::ENOENT
+        end
+      else
+        readlink(file)
+      end
+    else
+      realpath_orig(file, relative_to)
+    end
+  end
+
+  # Returns the path of the of the symbolic link referred to by +file+.
+  #
+  # Unlike unixy platforms, this will raise an error if the link is stale.
+  #
+  def self.readlink(file)
+    file = string_check(file)
+
+    if exist?(file) && !symlink?(file)
+      raise SystemCallError.new(22) # EINVAL, match the spec
+    end
+
+    wfile = file.wincode
+    path  = 0.chr * 1024
+
+    if File.directory?(file)
+      flags = FILE_FLAG_BACKUP_SEMANTICS
+    else
+      flags = FILE_ATTRIBUTE_NORMAL
+    end
+
+    begin
+      handle = CreateFileW(
+        wfile,
+        GENERIC_READ,
+        FILE_SHARE_READ,
+        nil,
+        OPEN_EXISTING,
+        flags,
+        0
+      )
+
+      if handle == INVALID_HANDLE_VALUE
+        raise SystemCallError.new('CreateFile', FFI.errno)
+      end
+
+      if GetFinalPathNameByHandleW(handle, path, path.size/2, 0) == 0
+        raise SystemCallError.new('GetFinalPathNameByHandle', FFI.errno)
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    path.wstrip[4..-1] # Remove leading backslashes + question mark
+  end
+
+  ## STAT METHODS
+
+  # Returns the filesystem's block size.
+  #
+  def self.blksize(file)
+    File::Stat.new(file).blksize
+  end
+
+  # Returns whether or not the file is a block device. For MS Windows a
+  # block device is a removable drive, cdrom or ramdisk.
+  #
+  def self.blockdev?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).blockdev?
+  end
+
+  # Returns whether or not the file is a character device.
+  #
+  def self.chardev?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).chardev?
+  end
+
+  # Returns whether or not the file is a directory.
+  #
+  def self.directory?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).directory?
+  end
+
+  # Returns whether or not the file is executable.
+  #
+  def self.executable?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).executable?
+  end
+
+  # Returns whether or not the file is a regular file.
+  #
+  def self.file?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).file?
+  end
+
+  # Identifies the type of file. The return string is one of 'file',
+  # 'directory', 'characterSpecial', 'socket' or 'unknown'.
+  #
+  def self.ftype(file)
+    File::Stat.new(file).ftype
+  end
+
+  # Returns true if the process owner's ID is the same as one of the file's groups.
+  #
+  def self.grpowned?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).grpowned?
+  end
+
+  # Returns whether or not the current process owner is the owner of the file.
+  #
+  def self.owned?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).owned?
+  end
+
+  # Returns whether or not the file is a pipe.
+  #
+  def self.pipe?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).pipe?
+  end
+
+  # Returns whether or not the file is readable by the process owner.
+  #
+  def self.readable?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).readable?
+  end
+
+  # Synonym for File.readable?
+  #
+  def self.readable_real?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).readable_real?
+  end
+
+  # Returns a File::Stat object as defined in the win32-file-stat library.
+  #
+  def self.stat(file)
+    File::Stat.new(file)
+  end
+
+  # Returns whether or not the file is readable by others. Note that this
+  # merely returns true or false, not permission bits (or nil).
+  #
+  def self.world_readable?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).world_readable?
+  end
+
+  # Returns whether or not the file is writable by others. Note that this
+  # merely returns true or false, not permission bits (or nil).
+  #
+  def self.world_writable?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).world_writable?
+  end
+
+  # Returns whether or not the file is writable by the current process owner.
+  #
+  def self.writable?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).writable?
+  end
+
+  # Synonym for File.writable?
+  #
+  def self.writable_real?(file)
+    return false unless File.exist?(file)
+    File::Stat.new(file).writable_real?
+  end
+
+  # Singleton aliases
+  class << self
+    alias lstat stat
+    alias executable_real? executable?
+    alias socket? pipe?
+  end
+
+  ## Instance Methods
+
+  # Same as MRI, except it returns a stat object using the win32-file-stat gem.
+  #
+  def stat
+    File::Stat.new(self.path)
+  end
+
+  # Private singleton methods
+  class << self
+    private
+
+    # Simulate Ruby's string checking
+    def string_check(arg)
+      return arg if arg.is_a?(String)
+      return arg.send(:to_str) if arg.respond_to?(:to_str, true) # MRI allows private to_str
+      return arg.to_path if arg.respond_to?(:to_path)
+      raise TypeError
+    end
+  end
+end