win32-file-stat 1.3.6 → 1.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 21ab123edd8396ff02c8327a373ccfc68e4308c7
+  data.tar.gz: fef46107af70e7f8807936e64ae5e6764323998e
+SHA512:
+  metadata.gz: 26b1420a147218155fe47a17ea9f427b631b212a56733f27e569c58d838472bc0908d94b9d15defda9be00a7de1ea63faf7356c92901d1755a5652973fd17e6d
+  data.tar.gz: 7499482990e1e4a68d52607f612227cf22f11f37ea1a4defb2d62ab6d11fb31b1c0700e2e383989e8d7f4ab57d0df867ca722f4d9b48844fd3daffaad2289cd8

data/CHANGES

@@ -1,103 +1,126 @@
-== 1.3.6 - 24-Mar-2012
-* Eliminated some warnings for Ruby 1.9.3.
-
-== 1.3.5 - 21-Nov-2011
-* Fixed a bug in the dev method for 1.9.x.
-* Fixed some method redefinition warnings.
-* Refactored the Rakefile and gemspec. The old install task has been
-  removed from the Rakefile.
-
-== 1.3.4 - 13-Aug-2009
-* Changed license to Artistic 2.0.
-* Some gemspec updates, including the addition of a license, an updated
-  description, and changing test-unit from a runtime dependency to a
-  development dependency.
-* Some documentation updates, mostly to make certain things invisible that
-  aren't meant for public consumption.
-* One test now skipped on 64-bit versions of Windows.
-
-== 1.3.3 - 9-Feb-2009
-* Fixed a bug where File::Stat.new failed on locked files. Thanks go to
-  Montgomery Kosma for the spot.
-* Now requires windows-pr 1.0.0 or later.
-* Updated the README to note that 32 bit versions of Ruby which attempt
-  to access locked system files on 64 bit versions of MS Windows will fail.
-
-== 1.3.2 - 1-Oct-2008
-* Fixed an issue with the private get_blksize method.
-* Updated the test suite to use Test::Unit 2.x, which also makes it a
-  required dependency.
-* Removed the pre-generated .txt and .exe files that were used for testing.
-  These are now generated within the test suite itself.
-* Fixed two broken size tests, and now omits one blockdev test if there's no
-  media in the drive.
-
-== 1.3.1 - 9-Aug-2008
-* Fixed the stat buf to be the proper size (I had too many struct members).
-* Modified the tests slightly.
-
-== 1.3.0 - 1-Aug-2008
-* Fixed a couple of function calls where I had forgotten to call an
-  explicitly wide version.
-* No longer ignores failures on empty block devices, e.g. CD-ROM drives
-  without any media in them. A SystemCallError is raised instead.
-* Added blockdev boolean to the inspect/pp output.
-* Fixed a potential issue with an internal helper function and the new 'S'
-  prototype from win32-api 1.2.0 or later.
-
-== 1.2.8 - 29-Jul-2008
-* Internally now always uses wide character functions.
-* A private alias was made private.
-* Now requires windows-pr 0.9.1 or later.
-
-== 1.2.7 - 1-Oct-2007
-* Changed an error type in a private method in order to maintain
-  compatibility with the FileUtils module.
-
-== 1.2.6 - 29-Sep-2007
-* Minor tweak to the way I handle redefining the initialize method. The
-  old_init alias is now removed.
-* Now handles a potential failure in getting the atime, ctime and mtime,
-  caused by the underlying filesystem, e.g. Samba. If it fails, these
-  fields are set to the epoch. Thanks go an anonymous user for the spot.
-* Added a Rakefile that includes tasks for installation and testing.
-* Removed the install.rb file. That has been inlined into the Rakefile.
-
-== 1.2.5 - 5-Apr-2007
-* Now runs -w clean.
-
-== 1.2.4 - 22-Jan-2007
-* Improved block device handling.
-
-== 1.2.3 - 4-Nov-2006
-* Bug fix for file sizes over 4gb.
-
-== 1.2.2 - 13-May-2006
-* Yet another blksize bug fix.
-* Minor tweak to the pretty_print method with regards to handling nil values.
-* Bumped the minimum required windows-pr version to 0.4.0 in the gemspec.
-
-== 1.2.1 - 12-May-2006
-* Fixed a bug with regards to the block count where the constructor would die
-  with a FloatDomainError if the blksize returned 0 or nil.  It now defaults
-  to nil in that event.
-
-== 1.2.0 - 23-Apr-2006
-* Removed the attribute setters.  From now on this class provides readonly
-  methods.  Use the win32-file library for attribute setters.
-* Added the content_indexed? alias for the indexed? method.
-* Corresponding test suite changes.
-* Fixed the pp issue by writing a custom pretty_print method.
-
-== 1.1.0 - 15-Apr-2006
-* Added the chardev?, dev_major, dev_minor directory?, file?, executable?,
-  executable_real?, ftype, grpowned?, owned?, pipe?, readable?, readable_real?,
-  rdev_major, rdev_minor, setgid?, setuid?, size?, socket?, sticky?, symlink?,
-  writable?, writable_real? and zero? methods.  Note that not all of these
-  methods return meaningful values and were merely added to match the current
-  spec.  See documentation for details.
-* Added a VERSION constant.
-* Some optimization in the constructor.
-
-== 1.0.0 - 13-Apr-2006
-* Initial release
+== 1.4.0 - 16-Dec-2013
+* Conversion to FFI.
+* Now requires Ruby 1.9 or later.
+* The #mode method now more closely matches core MRI.
+* The #executable? method now simply checks the extension name. The Windows
+  API method I was using before (GetBinaryType) was limited to .exe files and
+  could return false positives. The current version checks for .bat, .cmd,
+  .com and .exe.
+* The #dev method returns the volume serial number instead of a drive letter.
+* The #symlink? method was implemented.
+* The #uid method was implemented. It now returns an actual user id. It can
+  optionally be passed a boolean argument. If true, it will return the full
+  string SID.
+* The #owned? method was implemented.
+* The #gid method was implemented. It now returns an actual group id. It can
+  optionally be passed a boolean argument. If true, it will return the full
+  string SID.
+* The #grpowned? method was implemented.
+* The #ino method was implemented.
+* Added working implementations of the #readable?, #writable?,
+  #world_readable? and #world_writable? methods.
+* The VERSION constant was changed to WIN32_FILE_STAT_VERSION.
+
+== 1.3.6 - 24-Mar-2012
+* Eliminated some warnings for Ruby 1.9.3.
+
+== 1.3.5 - 21-Nov-2011
+* Fixed a bug in the dev method for 1.9.x.
+* Fixed some method redefinition warnings.
+* Refactored the Rakefile and gemspec. The old install task has been
+  removed from the Rakefile.
+
+== 1.3.4 - 13-Aug-2009
+* Changed license to Artistic 2.0.
+* Some gemspec updates, including the addition of a license, an updated
+  description, and changing test-unit from a runtime dependency to a
+  development dependency.
+* Some documentation updates, mostly to make certain things invisible that
+  aren't meant for public consumption.
+* One test now skipped on 64-bit versions of Windows.
+
+== 1.3.3 - 9-Feb-2009
+* Fixed a bug where File::Stat.new failed on locked files. Thanks go to
+  Montgomery Kosma for the spot.
+* Now requires windows-pr 1.0.0 or later.
+* Updated the README to note that 32 bit versions of Ruby which attempt
+  to access locked system files on 64 bit versions of MS Windows will fail.
+
+== 1.3.2 - 1-Oct-2008
+* Fixed an issue with the private get_blksize method.
+* Updated the test suite to use Test::Unit 2.x, which also makes it a
+  required dependency.
+* Removed the pre-generated .txt and .exe files that were used for testing.
+  These are now generated within the test suite itself.
+* Fixed two broken size tests, and now omits one blockdev test if there's no
+  media in the drive.
+
+== 1.3.1 - 9-Aug-2008
+* Fixed the stat buf to be the proper size (I had too many struct members).
+* Modified the tests slightly.
+
+== 1.3.0 - 1-Aug-2008
+* Fixed a couple of function calls where I had forgotten to call an
+  explicitly wide version.
+* No longer ignores failures on empty block devices, e.g. CD-ROM drives
+  without any media in them. A SystemCallError is raised instead.
+* Added blockdev boolean to the inspect/pp output.
+* Fixed a potential issue with an internal helper function and the new 'S'
+  prototype from win32-api 1.2.0 or later.
+
+== 1.2.8 - 29-Jul-2008
+* Internally now always uses wide character functions.
+* A private alias was made private.
+* Now requires windows-pr 0.9.1 or later.
+
+== 1.2.7 - 1-Oct-2007
+* Changed an error type in a private method in order to maintain
+  compatibility with the FileUtils module.
+
+== 1.2.6 - 29-Sep-2007
+* Minor tweak to the way I handle redefining the initialize method. The
+  old_init alias is now removed.
+* Now handles a potential failure in getting the atime, ctime and mtime,
+  caused by the underlying filesystem, e.g. Samba. If it fails, these
+  fields are set to the epoch. Thanks go an anonymous user for the spot.
+* Added a Rakefile that includes tasks for installation and testing.
+* Removed the install.rb file. That has been inlined into the Rakefile.
+
+== 1.2.5 - 5-Apr-2007
+* Now runs -w clean.
+
+== 1.2.4 - 22-Jan-2007
+* Improved block device handling.
+
+== 1.2.3 - 4-Nov-2006
+* Bug fix for file sizes over 4gb.
+
+== 1.2.2 - 13-May-2006
+* Yet another blksize bug fix.
+* Minor tweak to the pretty_print method with regards to handling nil values.
+* Bumped the minimum required windows-pr version to 0.4.0 in the gemspec.
+
+== 1.2.1 - 12-May-2006
+* Fixed a bug with regards to the block count where the constructor would die
+  with a FloatDomainError if the blksize returned 0 or nil.  It now defaults
+  to nil in that event.
+
+== 1.2.0 - 23-Apr-2006
+* Removed the attribute setters.  From now on this class provides readonly
+  methods.  Use the win32-file library for attribute setters.
+* Added the content_indexed? alias for the indexed? method.
+* Corresponding test suite changes.
+* Fixed the pp issue by writing a custom pretty_print method.
+
+== 1.1.0 - 15-Apr-2006
+* Added the chardev?, dev_major, dev_minor directory?, file?, executable?,
+  executable_real?, ftype, grpowned?, owned?, pipe?, readable?, readable_real?,
+  rdev_major, rdev_minor, setgid?, setuid?, size?, socket?, sticky?, symlink?,
+  writable?, writable_real? and zero? methods.  Note that not all of these
+  methods return meaningful values and were merely added to match the current
+  spec.  See documentation for details.
+* Added a VERSION constant.
+* Some optimization in the constructor.
+
+== 1.0.0 - 13-Apr-2006
+* Initial release

data/MANIFEST

@@ -1,7 +1,10 @@
-* CHANGES
-* README
-* MANIFEST
-* Rakefile
-* win32-file-stat.gemspec
-* lib/win32/file/stat.rb
-* test/test_file_stat.rb
+* CHANGES
+* README
+* MANIFEST
+* Rakefile
+* win32-file-stat.gemspec
+* lib/win32/file/stat.rb
+* lib/win32/file/windows/constants.rb
+* lib/win32/file/windows/functions.rb
+* lib/win32/file/windows/structs.rb
+* test/test_file_stat.rb

data/README

@@ -1,84 +1,85 @@
-== Description
-A redefinition of the File::Stat class for MS Windows.
-
-== Prerequisites
-* windows-pr 0.9.1 or later.
-
-== Installation
-=== Remote Installation
-gem install win32-file-stat
-
-=== Local Installation
-rake install
-
-== Synopsis
-   # Don't 'require' like this in practice - see 'Known Issues' below
-   require 'win32/file/stat'
-
-   stat = File::Stat.new('file.txt')
-   stat.size
-   stat.readonly?
-   stat.hidden?
-
-== Differences between Ruby's File::Stat and this version:
-* The File::Stat#blksize method returns a meaningful value.
-* The File::Stat#blockdev method works more accurately.
-* The File::Stat#blocks method returns a meaningful value.
-* The File::Stat#dev method returns a drive letter, not a number.
-* The File::Stat#executable? method works properly.
-* The File::Stat#executable_real? returns the same value as
-  File::Stat#executable? (which now works properly).
-* The File::Stat#file? method works properly.
-* The File::Stat#ftype method works more accurately.
-* The File::Stat#pipe method works properly.
-* The File::Stat#size method handles file sizes greater than 2 gigabytes
-  correctly.
-* The File::Stat#socket method works more accurately.
-* Allows you to get file attributes specific to MS Windows, e.g. archive,
-  hidden, etc.
-* The inspect and pretty print output has been customized.
-  
-== Known issues
-You should not require 'win32/file/stat' directly.  Instead, require the
-win32-file library which will, in turn, require win32-file-stat.  This is
-the preferred approach because some modules (i.e. 'find') use the pass-through
-methods of the File class, such as File.lstat.  Many of the pass through
-methods have been redefined in the win32-file library to work in conjunction
-with the custom File::Stat objects created by this library.
-
-Failure to follow these instructions could lead to cases where the core Ruby
-File class attempts to use the custom File::Stat object defined in this class,
-and that will likely cause problems.
-
-Also, a 32 bit Ruby attempting to access a locked system file on a 64 bit
-version of MS Windows will fail.
-
-== Known bugs
-None that I'm aware of beyond the Known Issues listed above. Please report any
-bugs you find on the project page at:
-
-http://www.rubyforge.org/projects/win32utils.
-
-== Miscellaneous
-I had to require 'pp' explicitly in order to deal with the fact that pp.rb
-has a builtin pretty_print method for File::Stat. If I didn't do this
-you would end up using the pretty_print in pp.rb, which would break.
-
-== Future Plans
-This library will eventually be merged with the win32-file library. It will
-also be refactored to use FindFirstFile().
-
-== Copyright
-(C) 2003-2012, Daniel J. Berger, All Rights Reserved.
-
-== License
-Artistic 2.0
-
-= Warranty
-This library 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
+  A redefinition of the File::Stat class for MS Windows.
+
+== Prerequisites
+  * ffi
+  * Ruby 1.9 or later
+
+== Installation
+  gem install win32-file-stat
+
+== Synopsis
+  # require 'win32/file/stat' # Unwise. See below.
+  require 'win32/file' # Preferred. See below.
+
+  stat = File::Stat.new('file.txt')
+  p stat.size
+  p stat.readonly?
+  p stat.hidden?
+  p stat.uid 
+
+== Differences between Ruby's File::Stat and this version:
+  * The File::Stat#blksize method returns a meaningful value.
+  * The File::Stat#blockdev method works more accurately.
+  * The File::Stat#blocks method returns a meaningful value.
+  * The File::Stat#executable? method works properly.
+  * The File::Stat#executable_real? is an alias for File::Stat#executable?
+  * The File::Stat#file? method works properly.
+  * The File::Stat#ftype method works more accurately.
+  * The File::Stat#pipe method works properly.
+  * The File::Stat#socket method works more accurately.
+  * The File::Stat#ino method now returns a file identifier.
+  * The File::Stat#symlink? method works properly.
+  * The File::Stat#uid method returns a meaningful value.
+  * The File::Stat#gid method returns a meaningful value.
+  * The File::Stat#owned? method now works properly.
+  * The File::Stat#grpowned? method now works properly.
+  * The File::Stat#rdev method returns the volume serial number.
+  * The inspect and pretty print output has been customized.
+
+== Changes between this version and the previous versions.
+  * The File::Stat#dev method has reverted to returning a drive number by
+    default. However, you can pass an optional boolean argument to make it
+    return the drive letter instead.
+  
+== Known issues
+  You should not require 'win32/file/stat' directly. Instead, require the
+  win32-file library which will, in turn, require win32-file-stat. This is
+  the preferred approach because some modules (i.e. 'find') use the pass-through
+  methods of the File class, such as File.lstat.  Many of the pass through
+  methods have been redefined in the win32-file library to work in conjunction
+  with the custom File::Stat objects created by this library.
+
+  Failure to follow these instructions could lead to cases where the core Ruby
+  File class attempts to use the custom File::Stat object defined in this class,
+  and that will likely cause problems.
+
+  If run in verbose mode you will see a warning about initialize being
+  redefined. I can do nothing about that since my old trick of aliasing and
+  undefining initialize now causes a warning as well!
+
+== Known bugs
+  None that I'm aware of beyond the "Known Issues" listed above. Please report
+  any bugs you find on the project page at:
+
+  http://www.github.com/djberg96/win32-file-stat
+
+== Miscellaneous
+  I had to require 'pp' explicitly in order to deal with the fact that pp.rb
+  has a builtin pretty_print method for File::Stat. If I didn't do this
+  you would end up using the pretty_print in pp.rb, which would break.
+
+== Copyright
+  (C) 2003-2013, Daniel J. Berger, All Rights Reserved.
+
+== License
+  Artistic 2.0
+
+= Warranty
+  This library 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,26 +1,31 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-
-CLEAN.include("**/*.gem", "**/*.rbx", "**/*.rbc")
-
-namespace :gem do
-  desc "Create the win32-file-stat gem"
-  task :create => [:clean] do
-    spec = eval(IO.read("win32-file-stat.gemspec"))
-    Gem::Builder.new(spec).build
-  end
-
-  desc "Install the win32-file-stat gem"
-  task :install => [:create] do
-    file = Dir["win32-file-stat*.gem"].first
-    sh "gem install #{file}"
-  end
-end
-
-Rake::TestTask.new do |t|
-  t.verbose = true
-  t.warning = true
-end
-
-task :default => :test
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbx", "**/*.rbc", "**/*.log", "**/*.exe", "**/*.txt")
+
+namespace :gem do
+  desc "Create the win32-file-stat gem"
+  task :create => [:clean] do
+    spec = eval(IO.read("win32-file-stat.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 win32-file-stat gem"
+  task :install => [:create] do
+    file = Dir["win32-file-stat*.gem"].first
+    sh "gem install #{file}"
+  end
+end
+
+Rake::TestTask.new do |t|
+  t.verbose = true
+  t.warning = true
+end
+
+task :default => :test