win32-file-stat 1.4.3 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ee8c0c3a76c7fcc22794899ff2cb0e0f455ba6e0
-  data.tar.gz: 73fbaca95c61912ef6e62f7baa2bf26c3a6f9f66
+  metadata.gz: 570cfbe24ce0b82de003f94d55e00b53dff39c77
+  data.tar.gz: 36cebc20ffc58f5ac96b8daad1558cd48a121f3c
 SHA512:
-  metadata.gz: 7cd9985c5a62e7d71e99f586dfe2f18dc1f49fedc4c808db474fa2f5f0b790870612d1f114450de484e93bdeda2b34e1c1339efe2773cc4401a7f3ef6fe56680
-  data.tar.gz: 0db9479f32582058da50eaff0afff77226f9fa51e7a520aeb2dd0b9e5f2ee63c260f9d3ae0cf1f96cb8bf9cf421b57d5857c44ffbcf0677ce3d8b4dc95e7990a
+  metadata.gz: 6d573af01f22041b8c4b89512865a74e25e93c87a9b3d4450af2e6143a5d405322e506bd26d4ebe12c40e0af64fc218ec481fdce4e87017ba6145727cbd4a813
+  data.tar.gz: 9208feadbeec27b4add065953b2bc35469bf41fa2bf417a606be7688acf71cd1b80bb4eeb76923e16aeab0ea114da2cc3dc73d2a9fea2af6fb9016860cd3ff72

data/CHANGES

@@ -1,3 +1,8 @@
+== 1.5.0 - 10-Nov-2014
+* Added the #streams method, which shows alt streams for the file.
+* Use require_relative where appropriate.
+* Removed reference to rubyforge_project in gemspec.
+
 == 1.4.3 - 8-May-2014
 * The #writable? method now ignores the readonly attribute if it's a directory.
 * Replaced File.exists? with File.exist? to avoid warnings in Ruby 2.1.x.

data/README

@@ -17,6 +17,7 @@
   p stat.readonly?
   p stat.hidden?
   p stat.uid 
+  p stat.streams
 
 == Differences between Ruby's File::Stat and this version:
   * The File::Stat#blksize method returns a meaningful value.
@@ -36,6 +37,7 @@
   * 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.
+  * The File::Stat#streams was added. Returns an array of alt streams.
 
 == Changes between this version and the previous versions.
   * The File::Stat#dev method has reverted to returning a drive number by
@@ -69,6 +71,12 @@
   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.
 
+== Contributions
+  Although this library is free, please consider having your company
+  setup a gittip if used by your company professionally.
+
+  http://www.gittip.com/djberg96/
+
 == Copyright
   (C) 2003-2014, Daniel J. Berger, All Rights Reserved.
 

data/lib/win32/file/stat.rb

@@ -1,7 +1,7 @@
-require File.join(File.dirname(__FILE__), 'windows', 'helper')
-require File.join(File.dirname(__FILE__), 'windows', 'constants')
-require File.join(File.dirname(__FILE__), 'windows', 'structs')
-require File.join(File.dirname(__FILE__), 'windows', 'functions')
+require_relative 'windows/helper'
+require_relative 'windows/constants'
+require_relative 'windows/structs'
+require_relative 'windows/functions'
 require 'pp'
 
 class File::Stat
@@ -54,8 +54,11 @@ class File::Stat
   # Nil on Windows
   attr_reader :dev_major, :dev_minor, :rdev_major, :rdev_minor
 
+  # Alternate streams
+  attr_reader :streams
+
   # The version of the win32-file-stat library
-  WIN32_FILE_STAT_VERSION = '1.4.3'
+  WIN32_FILE_STAT_VERSION = '1.5.0'
 
   # Creates and returns a File::Stat object, which encapsulate common status
   # information for File objects on MS Windows sytems. The information is
@@ -86,6 +89,7 @@ class File::Stat
 
       if handle
         @filetype = get_filetype(handle)
+        @streams  = get_streams(handle)
         @chardev  = @filetype == FILE_TYPE_CHAR
         @regular  = @filetype == FILE_TYPE_DISK
         @pipe     = @filetype == FILE_TYPE_PIPE
@@ -506,8 +510,8 @@ class File::Stat
     members = %w[
       archive? atime blksize blockdev? blocks compressed? ctime dev
       encrypted? gid hidden? indexed? ino mode mtime rdev nlink normal?
-      offline? readonly? reparse_point? size sparse? system? temporary?
-      uid
+      offline? readonly? reparse_point? size sparse? system? streams
+      temporary? uid
     ]
 
     str = "#<#{self.class}"
@@ -533,7 +537,7 @@ class File::Stat
     members = %w[
       archive? atime blksize blockdev? blocks compressed? ctime dev
       encrypted? gid hidden? indexed? ino mode mtime rdev nlink normal?
-      offline? readonly? reparse_point? size sparse? system? temporary?
+      offline? readonly? reparse_point? size sparse? streams system? temporary?
       uid
     ]
 
@@ -713,6 +717,29 @@ class File::Stat
     file_type
   end
 
+  def get_streams(handle)
+    io_status = IO_STATUS_BLOCK.new
+    ptr = FFI::MemoryPointer.new(:uchar, 1024 * 64)
+
+    NtQueryInformationFile(handle, io_status, ptr, ptr.size, FileStreamInformation)
+
+    if FFI.errno != 0
+      raise SystemCallError.new('NtQueryInformationFile', FFI.errno)
+    end
+
+    arr = []
+
+    while true
+      info = FILE_STREAM_INFORMATION.new(ptr)
+      break if info[:StreamNameLength] == 0
+      arr << info[:StreamName].to_ptr.read_bytes(info[:StreamNameLength]).delete(0.chr)
+      break if info[:NextEntryOffset] == 0
+      info = FILE_STREAM_INFORMATION.new(ptr += info[:NextEntryOffset])
+    end
+
+    arr
+  end
+
   # Return a sid of the file's owner.
   #
   def get_file_sid(file, info)

data/lib/win32/file/windows/constants.rb

@@ -87,6 +87,8 @@ module Windows
 
       TokenUser   = 1
       TokenGroups = 2
+
+      FileStreamInformation = 22
     end
   end
 end

data/lib/win32/file/windows/functions.rb

@@ -16,6 +16,7 @@ module Windows
       typedef :pointer, :ptr
       typedef :buffer_in, :buf_in
       typedef :string, :str
+      typedef :long, :ntstatus
 
       ffi_convention :stdcall
 
@@ -52,6 +53,10 @@ module Windows
       attach_pfunc :BuildTrusteeWithSid, :BuildTrusteeWithSidW, [:ptr, :ptr], :void
       attach_pfunc :GetSecurityDescriptorDacl, [:ptr, :ptr, :ptr, :ptr], :bool
       attach_pfunc :GetEffectiveRightsFromAcl, :GetEffectiveRightsFromAclW, [:ptr, :ptr, :ptr], :dword
+
+      ffi_lib :ntdll
+
+      attach_pfunc :NtQueryInformationFile, [:handle, :pointer, :pointer, :ulong, :int], :ntstatus
     end
   end
 end

data/lib/win32/file/windows/structs.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'constants')
+require_relative 'constants'
 
 require 'ffi'
 
@@ -9,6 +9,31 @@ module Windows
 
       private
 
+      class LowHighLarge < FFI::Struct
+        layout(:LowPart, :ulong, :HighPart, :long)
+      end
+
+      class LARGE_INTEGER < FFI::Union
+        layout(:u, LowHighLarge, :QuadPart, :long_long)
+      end
+
+      class FILE_STREAM_INFORMATION < FFI::Struct
+        layout(
+          :NextEntryOffset, :ulong,
+          :StreamNameLength, :ulong,
+          :StreamSize, LARGE_INTEGER,
+          :StreamAllocateSize, LARGE_INTEGER,
+          :StreamName, [:uchar, 256]
+        )
+      end
+
+      class IO_STATUS_BLOCK < FFI::Struct
+        layout(
+          :union, Class.new(FFI::Union){ layout(:Status, :long, :Pointer, :pointer) },
+          :Information, :uintptr_t
+        )
+      end
+
       class LowHigh < FFI::Struct
         layout(:LowPart, :ulong, :HighPart, :ulong)
       end

data/test/test_file_stat.rb

@@ -54,7 +54,7 @@ class TC_Win32_File_Stat < Test::Unit::TestCase
   end
 
   test "version is set to expected value" do
-    assert_equal('1.4.3', File::Stat::WIN32_FILE_STAT_VERSION)
+    assert_equal('1.5.0', File::Stat::WIN32_FILE_STAT_VERSION)
   end
 
   test "constructor does not modify argument" do
@@ -529,6 +529,15 @@ class TC_Win32_File_Stat < Test::Unit::TestCase
     assert_false(@stat.sticky?)
   end
 
+  test "streams basic functionality" do
+    assert_respond_to(@stat, :streams)
+    assert_kind_of(Array, @stat.streams)
+  end
+
+  test "streams returns expected value" do
+    assert_equal("::$DATA", @stat.streams[0])
+  end
+
   test "symlink? basic functionality" do
     assert_respond_to(@stat, :symlink?)
     assert_boolean(@stat.symlink?)

data/win32-file-stat.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name      = 'win32-file-stat'
-  spec.version   = '1.4.3'
+  spec.version   = '1.5.0'
   spec.authors   = ['Daniel J. Berger', 'Park Heesob']
   spec.license   = 'Artistic 2.0'
   spec.email     = 'djberg96@gmail.com'
@@ -9,7 +9,6 @@ Gem::Specification.new do |spec|
   spec.test_file = 'test/test_file_stat.rb'
   spec.files     = Dir['**/*'].reject{ |f| f.include?('git') }
 
-  spec.rubyforge_project = 'Win32Utils'
   spec.extra_rdoc_files = ['README', 'CHANGES', 'MANIFEST']
   spec.required_ruby_version = ">= 1.9.0"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: win32-file-stat
 version: !ruby/object:Gem::Version
-  version: 1.4.3
+  version: 1.5.0
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -9,62 +9,62 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-08 00:00:00.000000000 Z
+date: 2014-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: win32-security
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: |2
@@ -102,17 +102,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: Win32Utils
-rubygems_version: 2.2.2
+rubyforge_project: 
+rubygems_version: 2.4.2
 signing_key: 
 specification_version: 4
 summary: A File::Stat class tailored to MS Windows