win32-file-attributes 1.0.1 → 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2d64c60789cb492bfacc0ecf1381b97be3affc3c
+  data.tar.gz: e08e6072ea0776de56ce9a540f16b67c7aef7b73
+SHA512:
+  metadata.gz: fc5e4cf1840d0d34cee7f697179048c734d9ada03e641da8c65fc9f5fbc21df42a16a4a924744d22a0bbaae3cfa0ea0efb67aeb17ae6160204ee5381cbf1b037
+  data.tar.gz: 2fbef9b336fdc7db8d837055716260ab724d153bea18b91deacbc0e37aa1ebab794ceffa09dfe2465b995ddf1290fd7addef1400648999f51f6cd28545aff4a7

data/CHANGES

@@ -1,7 +1,10 @@
-= 1.0.1 - 8-Apr-2013
-* Fixed the HANDLE prototypes in the underlying FFI code for 64 bit Ruby.
-* Fixed the return type for SetFileAttributes, and adjusted the code to match.
-* Added some tests for constants.
-
-= 1.0.0 - 26-Nov-2012
-* Initial release as an independent library.
+= 1.0.2 - 28-Apr-2014
+* The singleton methods now accept arguments that implement to_str or to_path.
+
+= 1.0.1 - 8-Apr-2013
+* Fixed the HANDLE prototypes in the underlying FFI code for 64 bit Ruby.
+* Fixed the return type for SetFileAttributes, and adjusted the code to match.
+* Added some tests for constants.
+
+= 1.0.0 - 26-Nov-2012
+* Initial release as an independent library.

data/MANIFEST

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

data/README

@@ -1,46 +1,46 @@
-== Description
-  Additional methods for the File class that relate to file properties
-  on the Microsoft Windows operating system.
-
-== Prerequisites
-  * ffi
-
-== Installation
-  gem install win32-file-attributes
-
-== Synopsis
-
-  require 'win32/file/attributes
-
-  p File.hidden?(file)    # => false
-  p File.attributes(file) # => ['archive', 'indexed']
-
-== Notes
-  If you have the win32-file gem already installed then you do not need this
-  gem. This library was split out from the win32-file gem in order to ease
-  testing and maintenance.
-
-  Otherwise, the only difference is that this library uses FFI instead
-  of win32-api. This also means that it works with JRuby.
-
-== 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-attributes/issues
-  
-== License
-  Artistic 2.0
-
-== Copyright
-  (C) 2003-2012, 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 that relate to file properties
+  on the Microsoft Windows operating system.
+
+== Prerequisites
+  * ffi
+
+== Installation
+  gem install win32-file-attributes
+
+== Synopsis
+
+  require 'win32/file/attributes
+
+  p File.hidden?(file)    # => false
+  p File.attributes(file) # => ['archive', 'indexed']
+
+== Notes
+  If you have the win32-file gem already installed then you do not need this
+  gem. This library was split out from the win32-file gem in order to ease
+  testing and maintenance.
+
+  Otherwise, the only difference is that this library uses FFI instead
+  of win32-api. This also means that it works with JRuby.
+
+== 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-attributes/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

data/Rakefile

@@ -1,27 +1,32 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-
-CLEAN.include('**/*.gem', '**/*.rbc')
-
-namespace :gem do
-  desc 'Build the win32-file-attributes gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-file-attributes.gemspec'))
-    Gem::Builder.new(spec).build
-  end
-
-  desc "Install the win32-file-attributes gem"
-  task :install => [:create] do
-    file = Dir["*.gem"].first
-    sh "gem install #{file}"
-  end
-end
-
-Rake::TestTask.new do |t|
-  task :test => :clean
-  t.warning = true
-  t.verbose = true
-end
-
-task :default => :test
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include('**/*.gem', '**/*.rbc')
+
+namespace :gem do
+  desc 'Build the win32-file-attributes gem'
+  task :create => [:clean] do
+    spec = eval(IO.read('win32-file-attributes.gemspec'))
+    if Gem::VERSION >= "2.0"
+      require 'rubygems/package'
+      Gem::Package.build(spec)
+    else
+      Gem::Builder.new(spec).build
+    end
+  end
+
+  desc "Install the win32-file-attributes gem"
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+Rake::TestTask.new do |t|
+  task :test => :clean
+  t.warning = true
+  t.verbose = true
+end
+
+task :default => :test

data/lib/win32/file/attributes.rb

@@ -1,556 +1,566 @@
-require File.join(File.dirname(__FILE__), 'windows', 'constants')
-require File.join(File.dirname(__FILE__), 'windows', 'structs')
-require File.join(File.dirname(__FILE__), 'windows', 'functions')
-
-class File
-  include Windows::File::Constants
-  include Windows::File::Functions
-  extend Windows::File::Constants
-  extend Windows::File::Structs
-  extend Windows::File::Functions
-
-  # The version of the win32-file library
-  WIN32_FILE_ATTRIBUTE_VERSION = '1.0.1'
-
-  ## ABBREVIATED ATTRIBUTE CONSTANTS
-
-  # The file or directory is an archive. Typically used to mark files for
-  # backup or removal.
-  ARCHIVE = FILE_ATTRIBUTE_ARCHIVE
-
-  # The file or directory is encrypted. For a file, this means that all
-  # data in the file is encrypted. For a directory, this means that
-  # encryption is # the default for newly created files and subdirectories.
-  COMPRESSED = FILE_ATTRIBUTE_COMPRESSED
-
-  # The file is hidden. Not included in an ordinary directory listing.
-  HIDDEN = FILE_ATTRIBUTE_HIDDEN
-
-  # A file that does not have any other attributes set.
-  NORMAL = FILE_ATTRIBUTE_NORMAL
-
-  # The data of a file is not immediately available. This attribute indicates
-  # that file data is physically moved to offline storage.
-  OFFLINE = FILE_ATTRIBUTE_OFFLINE
-
-  # The file is read only. Apps can read it, but not write to it or delete it.
-  READONLY = FILE_ATTRIBUTE_READONLY
-
-  # The file is part of or used exclusively by an operating system.
-  SYSTEM = FILE_ATTRIBUTE_SYSTEM
-
-  # The file is being used for temporary storage.
-  TEMPORARY = FILE_ATTRIBUTE_TEMPORARY
-
-  # The file or directory is to be indexed by the content indexing service.
-  # Note that we have inverted the traditional definition.
-  INDEXED = 0x0002000
-
-  # Synonym for File::INDEXED.
-  CONTENT_INDEXED = INDEXED
-
-  ## SINGLETON METHODS
-
-  # Returns an array of strings indicating the attributes for that file.
-  # The possible values are:
-  #
-  # archive
-  # compressed
-  # directory
-  # encrypted
-  # hidden
-  # indexed
-  # normal
-  # offline
-  # readonly
-  # reparse_point
-  # sparse
-  # system
-  # temporary
-  #
-  def self.attributes(file)
-    attributes = GetFileAttributesW(file.wincode)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    arr = []
-
-    arr << 'archive' if attributes & FILE_ATTRIBUTE_ARCHIVE > 0
-    arr << 'compressed' if attributes & FILE_ATTRIBUTE_COMPRESSED > 0
-    arr << 'directory' if attributes & FILE_ATTRIBUTE_DIRECTORY > 0
-    arr << 'encrypted' if attributes & FILE_ATTRIBUTE_ENCRYPTED > 0
-    arr << 'hidden' if attributes & FILE_ATTRIBUTE_HIDDEN > 0
-    arr << 'indexed' if attributes & FILE_ATTRIBUTE_NOT_CONTENT_INDEXED == 0
-    arr << 'normal' if attributes & FILE_ATTRIBUTE_NORMAL > 0
-    arr << 'offline' if attributes & FILE_ATTRIBUTE_OFFLINE > 0
-    arr << 'readonly' if attributes & FILE_ATTRIBUTE_READONLY > 0
-    arr << 'reparse_point' if attributes & FILE_ATTRIBUTE_REPARSE_POINT > 0
-    arr << 'sparse' if attributes & FILE_ATTRIBUTE_SPARSE_FILE > 0
-    arr << 'system' if attributes & FILE_ATTRIBUTE_SYSTEM > 0
-    arr << 'temporary' if attributes & FILE_ATTRIBUTE_TEMPORARY > 0
-
-    arr
-  end
-
-  # Sets the file attributes based on the given (numeric) +flags+. This does
-  # not remove existing attributes, it merely adds to them. Use the
-  # File.remove_attributes method if you want to remove them.
-  #
-  # Please not that certain attributes cannot always be applied. For example,
-  # you cannot convert a regular file into a directory. Common sense should
-  # guide you here.
-  #
-  def self.set_attributes(file, flags)
-    wfile = file.wincode
-    attributes = GetFileAttributesW(wfile)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    attributes |= flags
-
-    unless SetFileAttributesW(wfile, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Removes the file attributes based on the given (numeric) +flags+.
-  #
-  def self.remove_attributes(file, flags)
-    wfile = file.wincode
-    attributes = GetFileAttributesW(wfile)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    attributes &= ~flags
-
-    unless SetFileAttributesW(wfile, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Returns whether or not the file or directory is an archive file or
-  # directory. Applications typically use this attribute to mark files
-  # for backup or removal.
-  #
-  def self.archive?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_ARCHIVE)
-  end
-
-  # Returns whether or not the file or directory is compressed. For a file,
-  # this means that all of the data in the file is compressed. For a directory,
-  # this means that compression is the default for newly created files and
-  # subdirectories.
-  #
-  def self.compressed?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_COMPRESSED)
-  end
-
-  # Returns whether or not the file or directory is encrypted. For a file,
-  # this means that all data in the file is encrypted. For a directory, this
-  # means that encryption is the default for newly created files and
-  # subdirectories.
-  #
-  def self.encrypted?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_ENCRYPTED)
-  end
-
-  # Returns whether or not the file or directory is hidden. A hidden file
-  # does not show up in an ordinary directory listing.
-  #
-  def self.hidden?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_HIDDEN)
-  end
-
-  # Returns whether or not the file or directory has been indexed by
-  # the content indexing service.
-  #
-  def self.indexed?(file)
-    !check_for_attribute(file, FILE_ATTRIBUTE_NOT_CONTENT_INDEXED)
-  end
-
-  # Returns whether or not the file is a normal file or directory. A normal
-  # file or directory does not have any other attributes set.
-  #
-  def self.normal?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_NORMAL)
-  end
-
-  # Returns whether or not the data of a file is available immediately.
-  # If true it indicates that the file data is physically moved to offline
-  # storage.
-  #
-  def self.offline?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_OFFLINE)
-  end
-
-  # Returns whether or not the file is read-only. If a file is read-only then
-  # applications can read the file, but cannot write to it or delete it.
-  #
-  # Note that this attribute is not honored on directories.
-  #
-  def self.readonly?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_READONLY)
-  end
-
-  # Returns true if the file or directory has an associated reparse point. A
-  # reparse point is a collection of user defined data associated with a file
-  # or directory.  For more on reparse points, search
-  # http://msdn.microsoft.com.
-  #
-  def self.reparse_point?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_REPARSE_POINT)
-  end
-
-  # Returns whether or not the file is a sparse file. A sparse file is a
-  # file in which much of the data is zeros, typically image files.
-  #
-  def self.sparse?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_SPARSE_FILE)
-  end
-
-  # Returns whether or not the file or directory is a system file. A system
-  # file is a file that is part of the operating system or is used exclusively
-  # by the operating system.
-  #
-  def self.system?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_SYSTEM)
-  end
-
-  # Returns whether or not the file is being used for temporary storage.
-  #
-  # File systems avoid writing data back to mass storage if sufficient cache
-  # memory is available, because often the application deletes the temporary
-  # file shortly after the handle is closed. In that case, the system can
-  # entirely avoid writing the data. Otherwise, the data will be written after
-  # the handle is closed.
-  #
-  def self.temporary?(file)
-    check_for_attribute(file, FILE_ATTRIBUTE_TEMPORARY)
-  end
-
-  class << self
-    alias read_only? readonly?
-    alias content_indexed? indexed?
-    alias set_attr set_attributes
-    alias unset_attr remove_attributes
-  end
-
-  ## INSTANCE METHODS
-
-  # Sets whether or not the file is an archive file. Applications typically
-  # use this attribute to mark files for backup or removal.
-  #
-  def archive=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_ARCHIVE;
-    else
-      attributes &= ~FILE_ATTRIBUTE_ARCHIVE;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets whether or not the file is a compressed file. For a file, this means
-  # that all of the data in the file is compressed. For a directory, this means
-  # that compression is the default for newly created files and subdirectories.
-  #
-  def compressed=(bool)
-    in_buf = FFI::MemoryPointer.new(:ulong)
-    bytes  = FFI::MemoryPointer.new(:ulong)
-
-    compression_value = bool ? COMPRESSION_FORMAT_DEFAULT : COMPRESSION_FORMAT_NONE
-    in_buf.write_ulong(compression_value)
-
-    # We can't use get_osfhandle here because we need specific attributes
-    handle = CreateFileW(
-      self.path.wincode,
-      FILE_READ_DATA | FILE_WRITE_DATA,
-      FILE_SHARE_READ | FILE_SHARE_WRITE,
-      nil,
-      OPEN_EXISTING,
-      0,
-      0
-    )
-
-    if handle == INVALID_HANDLE_VALUE
-      raise SystemCallError.new("CreateFile", FFI.errno)
-    end
-
-    begin
-      bool = DeviceIoControl(
-        handle,
-        FSCTL_SET_COMPRESSION(),
-        in_buf,
-        in_buf.size,
-        nil,
-        0,
-        bytes,
-        nil
-      )
-
-      unless bool
-        raise SystemCallError.new("DeviceIoControl", FFI.errno)
-      end
-    ensure
-      CloseHandle(handle)
-    end
-
-    self
-  end
-
-  # Sets the hidden attribute to true or false.  Setting this attribute to
-  # true means that the file is not included in an ordinary directory listing.
-  #
-  def hidden=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_HIDDEN;
-    else
-      attributes &= ~FILE_ATTRIBUTE_HIDDEN;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets the 'indexed' attribute to true or false.  Setting this to
-  # false means that the file will not be indexed by the content indexing
-  # service.
-  #
-  def indexed=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes &= ~FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
-    else
-      attributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  alias :content_indexed= :indexed=
-
-  # Sets the normal attribute. Note that only 'true' is a valid argument,
-  # which has the effect of removing most other attributes.  Attempting to
-  # pass any value except true will raise an ArgumentError.
-  #
-  def normal=(bool)
-    unless bool
-      raise ArgumentError, "only 'true' may be passed as an argument"
-    end
-
-    unless SetFileAttributesW(self.path.wincode, FILE_ATTRIBUTE_NORMAL)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets whether or not a file is online or not.  Setting this to false means
-	# that the data of the file is not immediately available. This attribute
-	# indicates that the file data has been physically moved to offline storage.
-	# This attribute is used by Remote Storage, the hierarchical storage
-	# management software.
-  #
-	# Applications should not arbitrarily change this attribute.
-  #
-  def offline=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_OFFLINE;
-    else
-      attributes &= ~FILE_ATTRIBUTE_OFFLINE;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets the readonly attribute.  If set to true the the file or directory is
-  # readonly. Applications can read the file but cannot write to it or delete
-  # it. In the case of a directory, applications cannot delete it.
-  #
-  def readonly=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_READONLY;
-    else
-      attributes &= ~FILE_ATTRIBUTE_READONLY;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets the file to a sparse (usually image) file.  Note that you cannot
-  # remove the sparse property from a file.
-  #
-  def sparse=(bool)
-    unless bool
-      warn 'cannot remove sparse property from a file - operation ignored'
-      return
-    end
-
-    bytes = FFI::MemoryPointer.new(:ulong)
-
-    handle = CreateFileW(
-      self.path.wincode,
-      FILE_READ_DATA | FILE_WRITE_DATA,
-      FILE_SHARE_READ | FILE_SHARE_WRITE,
-      0,
-      OPEN_EXISTING,
-      FSCTL_SET_SPARSE(),
-      0
-    )
-
-    if handle == INVALID_HANDLE_VALUE
-      raise SystemCallError.new("CreateFile", FFI.errno)
-    end
-
-    begin
-      bool = DeviceIoControl(
-        handle,
-        FSCTL_SET_SPARSE(),
-        nil,
-        0,
-        nil,
-        0,
-        bytes,
-        nil
-      )
-
-      unless bool == 0
-        raise SystemCallError.new("DeviceIoControl", FFI.errno)
-      end
-    ensure
-      CloseHandle(handle)
-    end
-
-    self
-  end
-
-  # Set whether or not the file is a system file.  A system file is a file
-	# that is part of the operating system or is used exclusively by it.
-  #
-  def system=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_SYSTEM;
-    else
-      attributes &= ~FILE_ATTRIBUTE_SYSTEM;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  # Sets whether or not the file is being used for temporary storage.
-  #
-  # File systems avoid writing data back to mass storage if sufficient cache
-  # memory is available, because often the application deletes the temporary
-  # file shortly after the handle is closed. In that case, the system can
-  # entirely avoid writing the data. Otherwise, the data will be written
-  # after the handle is closed.
-  #
-  def temporary=(bool)
-    wide_path  = self.path.wincode
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    if bool
-      attributes |= FILE_ATTRIBUTE_TEMPORARY;
-    else
-      attributes &= ~FILE_ATTRIBUTE_TEMPORARY;
-    end
-
-    unless SetFileAttributesW(wide_path, attributes)
-      raise SystemCallError.new("SetFileAttributes", FFI.errno)
-    end
-
-    self
-  end
-
-  private
-
-  # Convenience method used internally for the various boolean singleton methods.
-  #
-  def self.check_for_attribute(file, attribute)
-    attributes = GetFileAttributesW(file.wincode)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise SystemCallError.new("GetFileAttributes", FFI.errno)
-    end
-
-    attributes & attribute > 0 ? true : false
-  end
-end
+require File.join(File.dirname(__FILE__), 'windows', 'constants')
+require File.join(File.dirname(__FILE__), 'windows', 'structs')
+require File.join(File.dirname(__FILE__), 'windows', 'functions')
+
+class File
+  include Windows::File::Constants
+  include Windows::File::Functions
+  extend Windows::File::Constants
+  extend Windows::File::Structs
+  extend Windows::File::Functions
+
+  # The version of the win32-file library
+  WIN32_FILE_ATTRIBUTE_VERSION = '1.0.2'
+
+  ## ABBREVIATED ATTRIBUTE CONSTANTS
+
+  # The file or directory is an archive. Typically used to mark files for
+  # backup or removal.
+  ARCHIVE = FILE_ATTRIBUTE_ARCHIVE
+
+  # The file or directory is encrypted. For a file, this means that all
+  # data in the file is encrypted. For a directory, this means that
+  # encryption is # the default for newly created files and subdirectories.
+  COMPRESSED = FILE_ATTRIBUTE_COMPRESSED
+
+  # The file is hidden. Not included in an ordinary directory listing.
+  HIDDEN = FILE_ATTRIBUTE_HIDDEN
+
+  # A file that does not have any other attributes set.
+  NORMAL = FILE_ATTRIBUTE_NORMAL
+
+  # The data of a file is not immediately available. This attribute indicates
+  # that file data is physically moved to offline storage.
+  OFFLINE = FILE_ATTRIBUTE_OFFLINE
+
+  # The file is read only. Apps can read it, but not write to it or delete it.
+  READONLY = FILE_ATTRIBUTE_READONLY
+
+  # The file is part of or used exclusively by an operating system.
+  SYSTEM = FILE_ATTRIBUTE_SYSTEM
+
+  # The file is being used for temporary storage.
+  TEMPORARY = FILE_ATTRIBUTE_TEMPORARY
+
+  # The file or directory is to be indexed by the content indexing service.
+  # Note that we have inverted the traditional definition.
+  INDEXED = 0x0002000
+
+  # Synonym for File::INDEXED.
+  CONTENT_INDEXED = INDEXED
+
+  ## SINGLETON METHODS
+
+  # Returns an array of strings indicating the attributes for that file.
+  # The possible values are:
+  #
+  # archive
+  # compressed
+  # directory
+  # encrypted
+  # hidden
+  # indexed
+  # normal
+  # offline
+  # readonly
+  # reparse_point
+  # sparse
+  # system
+  # temporary
+  #
+  def self.attributes(file)
+    attributes = GetFileAttributesW(string_check(file).wincode)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    arr = []
+
+    arr << 'archive' if attributes & FILE_ATTRIBUTE_ARCHIVE > 0
+    arr << 'compressed' if attributes & FILE_ATTRIBUTE_COMPRESSED > 0
+    arr << 'directory' if attributes & FILE_ATTRIBUTE_DIRECTORY > 0
+    arr << 'encrypted' if attributes & FILE_ATTRIBUTE_ENCRYPTED > 0
+    arr << 'hidden' if attributes & FILE_ATTRIBUTE_HIDDEN > 0
+    arr << 'indexed' if attributes & FILE_ATTRIBUTE_NOT_CONTENT_INDEXED == 0
+    arr << 'normal' if attributes & FILE_ATTRIBUTE_NORMAL > 0
+    arr << 'offline' if attributes & FILE_ATTRIBUTE_OFFLINE > 0
+    arr << 'readonly' if attributes & FILE_ATTRIBUTE_READONLY > 0
+    arr << 'reparse_point' if attributes & FILE_ATTRIBUTE_REPARSE_POINT > 0
+    arr << 'sparse' if attributes & FILE_ATTRIBUTE_SPARSE_FILE > 0
+    arr << 'system' if attributes & FILE_ATTRIBUTE_SYSTEM > 0
+    arr << 'temporary' if attributes & FILE_ATTRIBUTE_TEMPORARY > 0
+
+    arr
+  end
+
+  # Sets the file attributes based on the given (numeric) +flags+. This does
+  # not remove existing attributes, it merely adds to them. Use the
+  # File.remove_attributes method if you want to remove them.
+  #
+  # Please not that certain attributes cannot always be applied. For example,
+  # you cannot convert a regular file into a directory. Common sense should
+  # guide you here.
+  #
+  def self.set_attributes(file, flags)
+    wfile = string_check(file).wincode
+    attributes = GetFileAttributesW(wfile)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    attributes |= flags
+
+    unless SetFileAttributesW(wfile, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Removes the file attributes based on the given (numeric) +flags+.
+  #
+  def self.remove_attributes(file, flags)
+    wfile = string_check(file).wincode
+    attributes = GetFileAttributesW(wfile)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    attributes &= ~flags
+
+    unless SetFileAttributesW(wfile, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Returns whether or not the file or directory is an archive file or
+  # directory. Applications typically use this attribute to mark files
+  # for backup or removal.
+  #
+  def self.archive?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_ARCHIVE)
+  end
+
+  # Returns whether or not the file or directory is compressed. For a file,
+  # this means that all of the data in the file is compressed. For a directory,
+  # this means that compression is the default for newly created files and
+  # subdirectories.
+  #
+  def self.compressed?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_COMPRESSED)
+  end
+
+  # Returns whether or not the file or directory is encrypted. For a file,
+  # this means that all data in the file is encrypted. For a directory, this
+  # means that encryption is the default for newly created files and
+  # subdirectories.
+  #
+  def self.encrypted?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_ENCRYPTED)
+  end
+
+  # Returns whether or not the file or directory is hidden. A hidden file
+  # does not show up in an ordinary directory listing.
+  #
+  def self.hidden?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_HIDDEN)
+  end
+
+  # Returns whether or not the file or directory has been indexed by
+  # the content indexing service.
+  #
+  def self.indexed?(file)
+    !check_for_attribute(file, FILE_ATTRIBUTE_NOT_CONTENT_INDEXED)
+  end
+
+  # Returns whether or not the file is a normal file or directory. A normal
+  # file or directory does not have any other attributes set.
+  #
+  def self.normal?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_NORMAL)
+  end
+
+  # Returns whether or not the data of a file is available immediately.
+  # If true it indicates that the file data is physically moved to offline
+  # storage.
+  #
+  def self.offline?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_OFFLINE)
+  end
+
+  # Returns whether or not the file is read-only. If a file is read-only then
+  # applications can read the file, but cannot write to it or delete it.
+  #
+  # Note that this attribute is not honored on directories.
+  #
+  def self.readonly?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_READONLY)
+  end
+
+  # Returns true if the file or directory has an associated reparse point. A
+  # reparse point is a collection of user defined data associated with a file
+  # or directory.  For more on reparse points, search
+  # http://msdn.microsoft.com.
+  #
+  def self.reparse_point?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_REPARSE_POINT)
+  end
+
+  # Returns whether or not the file is a sparse file. A sparse file is a
+  # file in which much of the data is zeros, typically image files.
+  #
+  def self.sparse?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_SPARSE_FILE)
+  end
+
+  # Returns whether or not the file or directory is a system file. A system
+  # file is a file that is part of the operating system or is used exclusively
+  # by the operating system.
+  #
+  def self.system?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_SYSTEM)
+  end
+
+  # Returns whether or not the file is being used for temporary storage.
+  #
+  # File systems avoid writing data back to mass storage if sufficient cache
+  # memory is available, because often the application deletes the temporary
+  # file shortly after the handle is closed. In that case, the system can
+  # entirely avoid writing the data. Otherwise, the data will be written after
+  # the handle is closed.
+  #
+  def self.temporary?(file)
+    check_for_attribute(file, FILE_ATTRIBUTE_TEMPORARY)
+  end
+
+  class << self
+    alias read_only? readonly?
+    alias content_indexed? indexed?
+    alias set_attr set_attributes
+    alias unset_attr remove_attributes
+  end
+
+  ## INSTANCE METHODS
+
+  # Sets whether or not the file is an archive file. Applications typically
+  # use this attribute to mark files for backup or removal.
+  #
+  def archive=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_ARCHIVE;
+    else
+      attributes &= ~FILE_ATTRIBUTE_ARCHIVE;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets whether or not the file is a compressed file. For a file, this means
+  # that all of the data in the file is compressed. For a directory, this means
+  # that compression is the default for newly created files and subdirectories.
+  #
+  def compressed=(bool)
+    in_buf = FFI::MemoryPointer.new(:ulong)
+    bytes  = FFI::MemoryPointer.new(:ulong)
+
+    compression_value = bool ? COMPRESSION_FORMAT_DEFAULT : COMPRESSION_FORMAT_NONE
+    in_buf.write_ulong(compression_value)
+
+    # We can't use get_osfhandle here because we need specific attributes
+    handle = CreateFileW(
+      self.path.wincode,
+      FILE_READ_DATA | FILE_WRITE_DATA,
+      FILE_SHARE_READ | FILE_SHARE_WRITE,
+      nil,
+      OPEN_EXISTING,
+      0,
+      0
+    )
+
+    if handle == INVALID_HANDLE_VALUE
+      raise SystemCallError.new("CreateFile", FFI.errno)
+    end
+
+    begin
+      bool = DeviceIoControl(
+        handle,
+        FSCTL_SET_COMPRESSION(),
+        in_buf,
+        in_buf.size,
+        nil,
+        0,
+        bytes,
+        nil
+      )
+
+      unless bool
+        raise SystemCallError.new("DeviceIoControl", FFI.errno)
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    self
+  end
+
+  # Sets the hidden attribute to true or false.  Setting this attribute to
+  # true means that the file is not included in an ordinary directory listing.
+  #
+  def hidden=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_HIDDEN;
+    else
+      attributes &= ~FILE_ATTRIBUTE_HIDDEN;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets the 'indexed' attribute to true or false.  Setting this to
+  # false means that the file will not be indexed by the content indexing
+  # service.
+  #
+  def indexed=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes &= ~FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+    else
+      attributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  alias :content_indexed= :indexed=
+
+  # Sets the normal attribute. Note that only 'true' is a valid argument,
+  # which has the effect of removing most other attributes.  Attempting to
+  # pass any value except true will raise an ArgumentError.
+  #
+  def normal=(bool)
+    unless bool
+      raise ArgumentError, "only 'true' may be passed as an argument"
+    end
+
+    unless SetFileAttributesW(self.path.wincode, FILE_ATTRIBUTE_NORMAL)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets whether or not a file is online or not.  Setting this to false means
+	# that the data of the file is not immediately available. This attribute
+	# indicates that the file data has been physically moved to offline storage.
+	# This attribute is used by Remote Storage, the hierarchical storage
+	# management software.
+  #
+	# Applications should not arbitrarily change this attribute.
+  #
+  def offline=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_OFFLINE;
+    else
+      attributes &= ~FILE_ATTRIBUTE_OFFLINE;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets the readonly attribute.  If set to true the the file or directory is
+  # readonly. Applications can read the file but cannot write to it or delete
+  # it. In the case of a directory, applications cannot delete it.
+  #
+  def readonly=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_READONLY;
+    else
+      attributes &= ~FILE_ATTRIBUTE_READONLY;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets the file to a sparse (usually image) file.  Note that you cannot
+  # remove the sparse property from a file.
+  #
+  def sparse=(bool)
+    unless bool
+      warn 'cannot remove sparse property from a file - operation ignored'
+      return
+    end
+
+    bytes = FFI::MemoryPointer.new(:ulong)
+
+    handle = CreateFileW(
+      self.path.wincode,
+      FILE_READ_DATA | FILE_WRITE_DATA,
+      FILE_SHARE_READ | FILE_SHARE_WRITE,
+      0,
+      OPEN_EXISTING,
+      FSCTL_SET_SPARSE(),
+      0
+    )
+
+    if handle == INVALID_HANDLE_VALUE
+      raise SystemCallError.new("CreateFile", FFI.errno)
+    end
+
+    begin
+      bool = DeviceIoControl(
+        handle,
+        FSCTL_SET_SPARSE(),
+        nil,
+        0,
+        nil,
+        0,
+        bytes,
+        nil
+      )
+
+      unless bool == 0
+        raise SystemCallError.new("DeviceIoControl", FFI.errno)
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    self
+  end
+
+  # Set whether or not the file is a system file.  A system file is a file
+	# that is part of the operating system or is used exclusively by it.
+  #
+  def system=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_SYSTEM;
+    else
+      attributes &= ~FILE_ATTRIBUTE_SYSTEM;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  # Sets whether or not the file is being used for temporary storage.
+  #
+  # File systems avoid writing data back to mass storage if sufficient cache
+  # memory is available, because often the application deletes the temporary
+  # file shortly after the handle is closed. In that case, the system can
+  # entirely avoid writing the data. Otherwise, the data will be written
+  # after the handle is closed.
+  #
+  def temporary=(bool)
+    wide_path  = self.path.wincode
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_TEMPORARY;
+    else
+      attributes &= ~FILE_ATTRIBUTE_TEMPORARY;
+    end
+
+    unless SetFileAttributesW(wide_path, attributes)
+      raise SystemCallError.new("SetFileAttributes", FFI.errno)
+    end
+
+    self
+  end
+
+  private
+
+  # Used to simulate Ruby's allowance for objects that implement to_str or to_path.
+  #
+  def self.string_check(arg)
+    return arg if arg.is_a?(String)
+    return arg.send(:to_str) if arg.respond_to?(:to_str, true)
+    return arg.to_path if arg.respond_to?(:to_path)
+    raise TypeError
+  end
+
+  # Convenience method used internally for the various boolean singleton methods.
+  #
+  def self.check_for_attribute(file, attribute)
+    file = string_check(file)
+    attributes = GetFileAttributesW(file.wincode)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise SystemCallError.new("GetFileAttributes", FFI.errno)
+    end
+
+    attributes & attribute > 0 ? true : false
+  end
+end