Project

win32-file

0.01
Repository is archived
No release in over 3 years
Low commit activity in last 3 years
The win32-file library adds several methods to the core File class which are specific to MS Windows, such as the ability to set and retrieve file attributes. In addition, several core methods have been redefined in order to work properly on MS Windows, such as File.blksize. See the README file for more details.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

Runtime

 Project Readme

Archived Repository

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

See redefined methods below

== 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