win32-dir 0.3.1

data/CHANGES

@@ -0,0 +1,18 @@
+== 0.3.1 - 16-Oct-2006
+* Added the Dir.empty? method.
+* Changed the Dir.reparse_dir? method to Dir.junction? (but kept an alias
+  for backwards compatibility).
+* Added rdoc for Dir.junction? (oops).
+* Some test tweaks and additions.
+
+== 0.3.0 - 28-May-2006
+* Now pure Ruby.
+* Now has a gem.
+* Added a VERSION constant.
+
+== 0.2.0 - 27-Jun-2005
+* Added the Dir.create_junction and Dir.reparse_dir? methods.
+* Added corresponding tests and documentation.
+
+== 0.1.0 - 25-Feb-2005
+* Initial release

data/MANIFEST

@@ -0,0 +1,9 @@
+README
+MANIFEST
+CHANGES
+install.rb
+win32-dir.gemspec
+
+examples/dir_test.rb
+lib/win32/dir.rb
+test/tc_dir.rb

data/README

@@ -0,0 +1,277 @@
+= Description
+   A series of extra constants for the Dir class that define special folders
+   on Win32 systems, , as well as methods for creating and detecting junctions
+   (i.e. symlinks for directories).
+
+= Installation
+== Manual
+   ruby test\tc_dir.rb (optional)
+   ruby install.rb
+== Gems
+   ruby win32-dir.gemspec
+   gem install win32-dir-X.Y.Z-mswin32.gem
+
+= Notes
+   Some tests may fail.  That is expected, because not all constants are
+   necessarily defined on your system.
+
+= Synopsis
+   require "win32/dir"
+	
+   # C:\WINNT or C:\WINDOWS
+   puts Dir::WINDOWS
+
+   # C:\Documents and Settings\Daniel\Start Menu\Programs\Administrative Tools	 
+   puts Dir::ADMINTOOLS
+	
+   Dir.mkdir('C:\from')
+   Dir.create_junction('C:\to', 'C:\from')
+
+= Constants
+   Not all of these are guaranteed to be defined on your system.  Also note
+   that the directories are merely defined.  It doesn't necessarily mean they
+   actually exist.
+	
+== The following constants should be defined:	
+Dir::ADMINTOOLS
+   The file system directory that is used to store administrative tools for an
+   individual user. The Microsoft Management Console (MMC) will save
+   customized consoles to this directory, and it will roam with the user.
+	
+Dir::COMMON_ADMINTOOLS
+   The file system directory containing administrative tools for all users
+   of the computer.
+	
+Dir::APPDATA
+   The file system directory that serves as a common repository for
+   application-specific data. A typical path is
+   C:\Documents and Settings\username\Application Data. This CSIDL is
+   supported by the redistributable Shfolder.dll for systems that do not have
+   the Microsoft Internet Explorer 4.0 integrated Shell installed.
+	
+Dir::COMMON_APPDATA
+   The file system directory containing application data for all users. A
+   typical path is C:\Documents and Settings\All Users\Application Data.
+	
+Dir::COMMON_DOCUMENTS
+   The file system directory that contains documents that are common to all
+   users. A typical paths is C:\Documents and Settings\All Users\Documents.
+	
+Dir::COOKIES
+   The file system directory that serves as a common repository for Internet
+   cookies. A typical path is C:\Documents and Settings\username\Cookies.
+
+Dir::HISTORY
+   The file system directory that serves as a common repository for Internet
+   history items.
+
+Dir::INTERNET_CACHE
+   The file system directory that serves as a common repository for temporary
+   Internet files. A typical path is
+   C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
+
+Dir::LOCAL_APPDATA
+   The file system directory that serves as a data repository for local
+   (nonroaming) applications. A typical path is
+   C:\Documents and Settings\username\Local Settings\Application Data.
+
+Dir::MYPICTURES
+   The file system directory that serves as a common repository for image
+   files. A typical path is
+   C:\Documents and Settings\username\My Documents\My Pictures.
+	
+Dir::PERSONAL
+   The virtual folder representing the My Documents desktop item. This is
+   equivalent to Dir::MYDOCUMENTS.
+
+Dir::PROGRAM_FILES
+   The Program Files folder. A typical path is C:\Program Files.
+	
+Dir::PROGRAM_FILES_COMMON
+   A folder for components that are shared across applications. A typical path
+   is C:\Program Files\Common.
+	
+Dir::SYSTEM
+   The Windows System folder. A typical path is C:\Windows\System32.
+	
+Dir::WINDOWS
+   The Windows directory or SYSROOT. This corresponds to the %windir% or
+   %SYSTEMROOT% environment variables. A typical path is C:\Windows.
+	 
+== The following constants may or may not be defined:
+   Dir::ALTSTARTUP
+   The file system directory that corresponds to the user's nonlocalized
+   Startup program group.
+	
+Dir::BITBUCKET
+   The virtual folder containing the objects in the user's Recycle Bin.
+	
+Dir::CDBURN_AREA
+   The file system directory acting as a staging area for files waiting to
+   be written to CD.
+
+Dir::COMMON_ALTSTARTUP
+   The file system directory that corresponds to the nonlocalized Startup
+   program group for all users.
+
+Dir::COMMON_DESKTOPDIRECTORY
+   The file system directory that contains files and folders that appear on
+   the desktop for all users. A typical path is
+   C:\Documents and Settings\All Users\Desktop.
+
+Dir::COMMON_FAVORITES
+   The file system directory that serves as a common repository for favorite
+   items common to all users.
+
+Dir::COMMON_MUSIC
+   The file system directory that serves as a repository for music files
+   common to all users.
+
+Dir::COMMON_PICTURES
+   The file system directory that serves as a repository for image files
+   common to all users.
+
+Dir::COMMON_PROGRAMS
+   The file system directory that contains the directories for the common
+   program groups that appear on the Start menu for all users. 
+
+Dir::COMMON_STARTMENU
+   The file system directory that contains the programs and folders that
+   appear on the Start menu for all users.
+
+Dir::COMMON_STARTUP
+   The file system directory that contains the programs that appear in the
+   Startup folder for all users.
+
+Dir::COMMON_TEMPLATES
+	The file system directory that contains the templates that are available
+	to all users.
+
+Dir::COMMON_VIDEO
+   The file system directory that serves as a repository for video files
+   common to all users.
+
+Dir::CONTROLS
+   The virtual folder containing icons for the Control Panel applications.
+
+Dir::DESKTOP
+   The virtual folder representing the Windows desktop, the root of the
+   namespace.
+
+Dir::DESKTOPDIRECTORY
+   The file system directory used to physically store file objects on the
+   desktop (not to be confused with the desktop folder itself).
+
+Dir::DRIVES
+   The virtual folder representing My Computer, containing everything on
+   the local computer: storage devices, printers, and Control Panel. The
+   folder may also contain mapped network drives.
+
+Dir::FAVORITES
+   The file system directory that serves as a common repository for the
+   user's favorite items.
+
+Dir::FONTS
+   A virtual folder containing fonts.
+	
+Dir::INTERNET
+   A virtual folder representing the Internet.
+
+Dir::MYDOCUMENTS
+   The virtual folder representing the My Documents desktop item.  See also
+   Dir::PERSONAL.
+
+Dir::MYMUSIC
+   The file system directory that serves as a common repository for music
+   files.
+
+Dir::MYVIDEO
+   The file system directory that serves as a common repository for video
+   files.
+
+Dir::NETHOOD
+   A file system directory containing the link objects that may exist in the
+   My Network Places virtual folder. It is not the same as Dir::NETWORK, which
+   represents the network namespace root.
+
+Dir::NETWORK
+   A virtual folder representing Network Neighborhood, the root of the network
+   namespace hierarchy.
+
+Dir::PRINTERS
+   The virtual folder containing installed printers.
+
+Dir::PRINTHOOD
+   The file system directory that contains the link objects that can exist in
+   the "Printers" virtual folder.
+
+Dir::PROFILE
+   The user's profile folder.
+
+Dir::PROFILES
+   The file system directory containing user profile folders.
+
+Dir::PROGRAMS
+   The file system directory that contains the user's program groups (which
+   are themselves file system directories).
+
+Dir::RECENT
+   The file system directory that contains shortcuts to the user's most
+   recently used documents.
+
+Dir::SENDTO
+   The file system directory that contains Send To menu items.
+
+Dir::STARTMENU
+   The file system directory containing Start menu items.
+
+Dir::STARTUP
+   The file system directory that corresponds to the user's Startup program
+   group.
+
+Dir::TEMPLATES
+   The file system directory that serves as a common repository for document
+   templates.
+
+== Developer's Notes
+   The SHGetFolderPath() documentation on MSDN is somewhat vague about which
+   CSIDL constants are guaranteed to be defined.  However, there are 15 which
+   *should* be defined (see docs above).  The rest I cannot vouch for.  On
+   my own Windows XP SP 2 system, all but 7 were defined.
+	
+== Known Bugs
+   The Unicode support is not quite there for Dir.create_junction.  It creates
+   the directory and junction fine, but the +to+ name appears to get garbled
+   with regards to the character set.
+	
+   Please log any other bug reports on the RubyForge project page at
+   http://www.rubyforge.net/projects/win32utils.
+
+== Future Plans
+   Fix the Unicode issue with Dir.create_junction.
+   Other suggestions welcome.
+
+== Acknowledgements
+   Shashank Date and Zach Dennis for the suggestion and supporting comments
+   on the mailing list.
+	
+   Timothy Byrd and Autrijus Tang for help (directly or indirectly) with the
+   junction methods.  Timothy provided a pure Ruby version of the junction
+   code that I later borrowed from.
+	
+   Most of the documentation was copied from the MSDN web site.
+
+== License
+   Ruby's
+    
+== Copyright
+   (C) 2003-2006 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/install.rb

@@ -0,0 +1,11 @@
+# For those who don't like gems...
+require 'rbconfig'
+require 'ftools'
+include Config
+
+sitelibdir = CONFIG['sitelibdir']
+installdir = sitelibdir + '/win32'
+file = 'lib\win32\dir.rb'
+
+Dir.mkdir(installdir) unless File.exists?(installdir)
+File.copy(file, installdir, true)

data/lib/win32/dir.rb

@@ -0,0 +1,153 @@
+require 'windows/directory'
+require 'windows/shell'
+require 'windows/file'
+require 'windows/error'
+require 'windows/device_io'
+require 'windows/unicode'
+require 'windows/directory'
+require 'windows/handle'
+require 'windows/path'
+
+class Dir
+   include Windows::Directory
+   include Windows::Shell
+   include Windows::Error
+   include Windows::File
+   include Windows::DeviceIO
+   extend Windows::Directory
+   extend Windows::Shell
+   extend Windows::File
+   extend Windows::Error
+   extend Windows::DeviceIO
+   extend Windows::Unicode
+   extend Windows::Handle
+   extend Windows::Path
+   
+   VERSION = '0.3.1'
+   
+   # Dynamically set each of the CSIDL_ constants
+   constants.grep(/CSIDL/).each{ |constant|
+      path   = 0.chr * 260
+      nconst = constant.split('CSIDL_').last
+      
+      if SHGetFolderPath(0, const_get(constant), 0, 1, path) != 0
+         path = nil
+      else 
+         path.strip!
+      end
+      
+      Dir.const_set(nconst, path)    
+   }
+   
+   # Creates the symlink +to+, linked to the existing directory +from+.  If the
+	# +to+ directory already exists, it must be empty or an error is raised.
+	# 
+   def self.create_junction(to, from)
+      # Normalize the paths
+      to.tr!('/', "\\")
+      from.tr!('/', "\\")
+      
+      to_path    = 0.chr * 260
+      from_path  = 0.chr * 260
+      buf_target = 0.chr * 260
+      
+      if GetFullPathName(from, from_path.size, from_path, 0) == 0
+         raise StandardError, 'GetFullPathName() failed: ' + get_last_error
+      end
+      
+      if GetFullPathName(to, to_path.size, to_path, 0) == 0
+         raise StandardError, 'GetFullPathName() failed: ' + get_last_error
+      end
+      
+      to_path   = to_path.split(0.chr).first
+      from_path = from_path.split(0.chr).first
+      
+      # You can create a junction to a directory that already exists, so
+      # long as it's empty.
+      rv = CreateDirectory(to_path, 0)
+      if rv == 0 && rv != ERROR_ALREADY_EXISTS
+         raise StandardError, 'CreateDirectory() failed: ' + get_last_error
+      end
+      
+      handle = CreateFile(
+         to_path,
+         GENERIC_READ | GENERIC_WRITE, 
+         0,
+         0,
+         OPEN_EXISTING, 
+         FILE_FLAG_OPEN_REPARSE_POINT | FILE_FLAG_BACKUP_SEMANTICS,
+         0
+      )
+      
+      if handle == INVALID_HANDLE_VALUE
+         raise StandardError, 'CreateFile() failed: ' + get_last_error
+      end 
+      
+      buf_target  = buf_target.split(0.chr).first
+      buf_target  = "\\??\\" << from_path     
+      length      = buf_target.size * 2 # sizeof(WCHAR)
+      wide_string = multi_to_wide(buf_target)
+      
+      # REPARSE_JDATA_BUFFER
+      rdb = [
+         "0xA0000003L".hex,      # ReparseTag (IO_REPARSE_TAG_MOUNT_POINT)
+         wide_string.size + 12,  # ReparseDataLength
+         0,                      # Reserved
+         0,                      # SubstituteNameOffset
+         wide_string.size,       # SubstituteNameLength
+         wide_string.size + 2,   # PrintNameOffset
+         0,                      # PrintNameLength
+         wide_string             # PathBuffer
+      ].pack('LSSSSSSa' + (wide_string.size + 4).to_s)
+
+      bytes = [0].pack('L')
+
+      bool = DeviceIoControl(
+         handle,
+         CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 41, METHOD_BUFFERED, FILE_ANY_ACCESS),
+         rdb,
+         rdb.size,
+         0,
+         0,
+         bytes,
+         0
+      )
+      
+      unless bool
+         error = 'DeviceIoControl() failed: ' + get_last_error
+         RemoveDirectory(to)
+         CloseHandle(handle)        
+         raise error
+      end
+      
+      CloseHandle(handle)
+      
+      self  
+   end
+   
+   # Returns whether or not +path+ is empty.  Returns false if +path+ is not
+   # a directory, or contains any files other than '.' or '..'.
+   # 
+   def self.empty?(path)
+      PathIsDirectoryEmpty(path)
+   end
+   
+   # Returns whether or not +path+ is a junction.
+   # 
+   def self.junction?(path)
+      bool   = true
+      attrib = GetFileAttributes(path)
+      
+      bool = false if attrib == INVALID_FILE_ATTRIBUTES
+      bool = false if attrib & FILE_ATTRIBUTE_DIRECTORY == 0
+      bool = false if attrib & FILE_ATTRIBUTE_REPARSE_POINT == 0
+      
+      bool
+   end 
+   
+   # Class level aliases
+   #
+   class << self
+      alias reparse_dir? junction?
+   end
+end

data/test/tc_dir.rb

@@ -0,0 +1,320 @@
+###########################################################################
+# tc_dir.rb
+#
+# Test suite for the win32-dir package.  Note that some of these tests
+# may fail, because some constants are simply not defined, depending on
+# your operating system and version of certain DLL files.
+###########################################################################
+base = File.basename(Dir.pwd)
+
+if base == 'test' || base =~ /win32-dir/
+	Dir.chdir('..') if base == 'test'
+	$LOAD_PATH.unshift(Dir.pwd + '/lib')
+	Dir.chdir('test') rescue nil
+end
+
+require 'test/unit'
+require 'win32/dir'
+require 'fileutils'
+
+puts "Some tests may fail because some constants aren't defined on your system."
+puts "This is not unexpected."
+
+class TC_Win32_Dir < Test::Unit::TestCase
+   def setup
+      @from       = "from"
+      @ascii_to   = "to"
+      @unicode_to = "Ελλάσ" # Greek - the word is 'Hellas'
+      Dir.mkdir(@from)
+   end
+   
+   def test_version
+      assert_equal('0.3.1', Dir::VERSION)
+   end
+  
+   def test_create_junction
+      assert_respond_to(Dir, :create_junction)
+      assert_nothing_raised{ Dir.create_junction(@ascii_to, @from) }
+      assert_nothing_raised{ Dir.create_junction(@unicode_to, @from) }
+      
+      # If we've gotten this far, make sure files created in the @from
+      # directory show up in the linked directories.
+      File.open(@from + "\\test.txt", "w+"){ |f| f.puts "Hello World" }
+      
+      assert_equal(Dir.entries(@from), Dir.entries(@ascii_to))
+      assert_equal(Dir.entries(@from), Dir.entries(@unicode_to))
+   end
+   
+   def test_is_junction
+      assert_respond_to(Dir, :junction?)
+      assert_respond_to(Dir, :reparse_dir?) # alias
+      assert_nothing_raised{ Dir.junction?(@from) }
+      assert_nothing_raised{ Dir.create_junction(@ascii_to, @from) }
+      
+      assert_equal(false, Dir.junction?(@from))
+      assert_equal(true, Dir.junction?(@ascii_to))
+   end
+   
+   def test_is_empty
+      assert_respond_to(Dir, :empty?)
+      assert_equal(false, Dir.empty?("C:\\")) # One would hope
+      assert_equal(true, Dir.empty?(@from))
+   end
+
+   def test_admintools
+      assert_not_nil(Dir::ADMINTOOLS, "+IGNORE+")
+      assert_kind_of(String, Dir::ADMINTOOLS)
+   end
+   
+   def test_altstartup
+      assert_not_nil(Dir::ALTSTARTUP, "+IGNORE+")
+      assert_kind_of(String, Dir::ALTSTARTUP)
+   end
+   
+   def test_appdata
+      assert_not_nil(Dir::APPDATA, "+IGNORE+")
+      assert_kind_of(String, Dir::APPDATA)
+   end
+   
+   def test_bitbucket
+      assert_not_nil(Dir::BITBUCKET, "+IGNORE+")
+      assert_kind_of(String, Dir::BITBUCKET)
+   end
+   
+   def test_cdburn_area
+      assert_not_nil(Dir::CDBURN_AREA, "+IGNORE+")
+      assert_kind_of(String, Dir::CDBURN_AREA)
+   end
+   
+   def test_common_admintools
+      assert_not_nil(Dir::COMMON_ADMINTOOLS, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_ADMINTOOLS)
+   end
+   
+   def test_common_altstartup
+      assert_not_nil(Dir::COMMON_ALTSTARTUP, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_ALTSTARTUP)
+   end
+   
+   def test_common_appdata
+      assert_not_nil(Dir::COMMON_APPDATA, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_APPDATA)
+   end
+   
+   def test_common_desktopdirectory
+      assert_not_nil(Dir::COMMON_DESKTOPDIRECTORY, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_DESKTOPDIRECTORY)
+   end
+   
+   def test_common_documents
+      assert_not_nil(Dir::COMMON_DOCUMENTS, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_DOCUMENTS)
+   end
+   
+   def test_common_favorites
+      assert_not_nil(Dir::COMMON_FAVORITES, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_FAVORITES)
+   end
+   
+   def test_common_music
+      assert_not_nil(Dir::COMMON_MUSIC, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_MUSIC)
+   end
+   
+   def test_common_pictures
+      assert_not_nil(Dir::COMMON_PICTURES, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_PICTURES)
+   end
+   
+   def test_common_programs
+      assert_not_nil(Dir::COMMON_PROGRAMS, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_PROGRAMS)
+   end
+   
+   def test_common_startmenu
+      assert_not_nil(Dir::COMMON_STARTMENU, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_STARTMENU)
+   end
+   
+   def test_common_startup
+      assert_not_nil(Dir::COMMON_STARTUP, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_STARTUP)
+   end
+   
+   def test_common_templates
+      assert_not_nil(Dir::COMMON_TEMPLATES, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_TEMPLATES)
+   end
+   
+   def test_common_video
+      assert_not_nil(Dir::COMMON_VIDEO, "+IGNORE+")
+      assert_kind_of(String, Dir::COMMON_VIDEO)
+   end
+   
+   def test_controls
+      assert_not_nil(Dir::CONTROLS, "+IGNORE+")
+      assert_kind_of(String, Dir::CONTROLS)
+   end
+   
+   def test_cookies
+      assert_not_nil(Dir::COOKIES, "+IGNORE+")
+      assert_kind_of(String, Dir::COOKIES)
+   end
+   
+   def test_desktop
+      assert_not_nil(Dir::DESKTOP, "+IGNORE+")
+      assert_kind_of(String, Dir::DESKTOP)
+   end
+   
+   def test_desktopdirectory
+      assert_not_nil(Dir::DESKTOPDIRECTORY, "+IGNORE+")
+      assert_kind_of(String, Dir::DESKTOPDIRECTORY)
+   end
+   
+   def test_drives
+      assert_not_nil(Dir::DRIVES, "+IGNORE+")
+      assert_kind_of(String, Dir::DRIVES)
+   end
+
+   def test_favorites
+      assert_not_nil(Dir::FAVORITES, "+IGNORE+")
+      assert_kind_of(String, Dir::FAVORITES)
+   end
+   
+   def test_fonts
+      assert_not_nil(Dir::FONTS, "+IGNORE+")
+      assert_kind_of(String, Dir::FONTS)
+   end
+   
+   def test_history
+      assert_not_nil(Dir::HISTORY, "+IGNORE+")
+      assert_kind_of(String, Dir::HISTORY)
+   end
+   
+   def test_internet
+      assert_not_nil(Dir::INTERNET, "+IGNORE+")
+      assert_kind_of(String, Dir::INTERNET)
+   end
+   
+   def test_internet_cache
+      assert_not_nil(Dir::INTERNET_CACHE, "+IGNORE+")
+      assert_kind_of(String, Dir::INTERNET_CACHE)
+   end
+   
+   def test_local_appdata
+      assert_not_nil(Dir::LOCAL_APPDATA, "+IGNORE+")
+      assert_kind_of(String, Dir::LOCAL_APPDATA)
+   end
+   
+   def test_mydocuments
+      assert_not_nil(Dir::MYDOCUMENTS, "+IGNORE+")
+      assert_kind_of(String, Dir::MYDOCUMENTS)
+   end
+   
+   def test_local_mymusic
+      assert_not_nil(Dir::MYMUSIC, "+IGNORE+")
+      assert_kind_of(String, Dir::MYMUSIC)
+   end
+   
+   def test_local_mypictures
+      assert_not_nil(Dir::MYPICTURES, "+IGNORE+")
+      assert_kind_of(String, Dir::MYPICTURES)
+   end
+   
+   def test_local_myvideo
+      assert_not_nil(Dir::MYVIDEO, "+IGNORE+")
+      assert_kind_of(String, Dir::MYVIDEO)
+   end
+   
+   def test_nethood
+      assert_not_nil(Dir::NETHOOD, "+IGNORE+")
+      assert_kind_of(String, Dir::NETHOOD)
+   end
+   
+   def test_network
+      assert_not_nil(Dir::NETWORK, "+IGNORE+")
+      assert_kind_of(String, Dir::NETWORK)
+   end
+
+   def test_personal
+      assert_not_nil(Dir::PERSONAL, "+IGNORE+")
+      assert_kind_of(String, Dir::PERSONAL)
+   end
+   
+   def test_printers
+      assert_not_nil(Dir::PRINTERS, "+IGNORE+")
+      assert_kind_of(String, Dir::PRINTERS)
+   end
+   
+   def test_printhood
+      assert_not_nil(Dir::PRINTHOOD, "+IGNORE+")
+      assert_kind_of(String, Dir::PRINTHOOD)
+   end
+   
+   def test_profile
+      assert_not_nil(Dir::PROFILE, "+IGNORE+")
+      assert_kind_of(String, Dir::PROFILE)
+   end
+   
+   # Doesn't appear to actually exist
+   #def test_profiles
+   #   assert_not_nil(Dir::PROFILES)
+   #   assert_kind_of(String,Dir::PROFILES)
+   #end
+   
+   def test_program_files
+      assert_not_nil(Dir::PROGRAM_FILES, "+IGNORE+")
+      assert_kind_of(String, Dir::PROGRAM_FILES)
+   end
+   
+   def test_program_files_common
+      assert_not_nil(Dir::PROGRAM_FILES_COMMON, "+IGNORE+")
+      assert_kind_of(String, Dir::PROGRAM_FILES_COMMON)
+   end
+   
+   def test_programs
+      assert_not_nil(Dir::PROGRAMS, "+IGNORE+")
+      assert_kind_of(String, Dir::PROGRAMS)
+   end
+   
+   def test_recent
+      assert_not_nil(Dir::RECENT, "+IGNORE+")
+      assert_kind_of(String, Dir::RECENT)
+   end
+   
+   def test_sendto
+      assert_not_nil(Dir::SENDTO, "+IGNORE+")
+      assert_kind_of(String, Dir::SENDTO)
+   end
+   
+   def test_startmenu
+      assert_not_nil(Dir::STARTMENU, "+IGNORE+")
+      assert_kind_of(String, Dir::STARTMENU)
+   end
+   
+   def test_startup
+      assert_not_nil(Dir::STARTUP, "+IGNORE+")
+      assert_kind_of(String, Dir::STARTUP)
+   end
+   
+   def test_system
+      assert_not_nil(Dir::SYSTEM, "+IGNORE+")
+      assert_kind_of(String, Dir::SYSTEM)
+   end
+   
+   def test_templates
+      assert_not_nil(Dir::TEMPLATES, "+IGNORE+")
+      assert_kind_of(String, Dir::TEMPLATES)
+   end
+
+   def test_windows_dir
+      assert_not_nil(Dir::WINDOWS, "+IGNORE+")
+      assert_kind_of(String, Dir::WINDOWS)
+   end
+
+   def teardown
+      Dir.rmdir(@ascii_to) rescue nil
+      Dir.rmdir(@unicode_to) rescue nil
+      FileUtils.rm_rf(@from) rescue nil
+   end
+end

data/win32-dir.gemspec

@@ -0,0 +1,24 @@
+require "rubygems"
+
+spec = Gem::Specification.new do |gem|
+   gem.name        = "win32-dir"
+   gem.version     = "0.3.1"
+   gem.author      = "Daniel J. Berger"
+   gem.email       = "djberg96@gmail.com"
+   gem.homepage    = "http://www.rubyforge.org/projects/win32utils"
+   gem.platform    = Gem::Platform::RUBY
+   gem.summary     = "Extra constants and methods for the Dir class on Windows."
+   gem.description = "Extra constants and methods for the Dir class on Windows."
+   gem.test_file   = "test/tc_dir.rb"
+   gem.has_rdoc    = true
+   gem.files       = Dir["lib/win32/*.rb"] + Dir["test/*"] + Dir["[A-Z]*"]
+   gem.files.reject! { |fn| fn.include? "CVS" }
+   gem.require_path = "lib"
+   gem.extra_rdoc_files = ["README", "CHANGES"]
+   gem.add_dependency("windows-pr", ">= 0.5.1")
+end
+
+if $0 == __FILE__
+   Gem.manage_gems
+   Gem::Builder.new(spec).build
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: win32-dir
+version: !ruby/object:Gem::Version 
+  version: 0.3.1
+date: 2006-10-16 00:00:00 -06:00
+summary: Extra constants and methods for the Dir class on Windows.
+require_paths: 
+- lib
+email: djberg96@gmail.com
+homepage: http://www.rubyforge.org/projects/win32utils
+rubyforge_project: 
+description: Extra constants and methods for the Dir class on Windows.
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Daniel J. Berger
+files: 
+- lib/win32/dir.rb
+- test/tc_dir.rb
+- CHANGES
+- examples
+- install.rb
+- lib
+- MANIFEST
+- README
+- test
+- win32-dir-0.3.1.gem
+- win32-dir.gemspec
+test_files: 
+- test/tc_dir.rb
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: windows-pr
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.1
+    version: