This repository has been archived and will no longer receive updates. It was archived as part of the Repository Standardization Initiative.
If you are a Chef customer and need support for this repository, please contact your Chef account team.
== 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:/Progra1") # => C:\Program Files
p File.short_path("C:/Program Files") # => C:\Progra1
== Singleton Methods Added
- File.long_path
- File.short_path
== Singleton Methods Redefined
- File.atime # Takes an optional 2nd argument to set the value.
- 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.ctime # Takes an optional 2nd argument to set the value.
- 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.mtime # Takes an optional 2nd argument to set the value.
- 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