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

* windows-pr
* 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 in MRI
* 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

None that I'm aware of.

Please report any issues you find on the github page at:

https://github.com/djberg96/win32-file/issues

Or the Win32Utils project page at:

http://www.rubyforge.org/projects/win32utils.

License

Artistic 2.0
(C) 2003-2013, 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