pathname2 1.0.0 → 1.1.0

data/CHANGES

@@ -1,2 +1,5 @@
+== 1.1.0 - 13-Jul-2005
+* Added the 'find' facade.
+
 == 1.0.0 - 11-Jun-2005
 * Initial release

data/lib/pathname2.rb

@@ -1,536 +1,557 @@
-# == Synopsis
-#
-# Pathname represents a path name on a filesystem.  A Pathname can be
-# relative or absolute.  It does not matter whether the path exists or not.
-#
-# All functionality from File, FileTest, and Dir is included, using a facade
-# pattern.
-#
-# This class works on both Unix and Win32, including UNC path names.  Note
-# that forward slashes are converted to backslashes on Win32 systems.
-#
-# == Usage
-#
-# require "pathname"
-# 
-# # Unix
-# path1 = Pathname.new("/foo/bar/baz")
-# path2 = Pathname.new("../zap")
-#
-# path1 + path2 # "/foo/bar/zap"
-# path1.dirname # "/foo/bar"
-#
-# # Win32
-# path1 = Pathname.new("C:\\foo\\bar\\baz")
-# path2 = Pathname.new("..\\zap")
-#
-# path1 + path2 # "C:\\foo\\bar\\zap"
-# path1.exists? # Does the path exist?
-#
-# == Author
-#
-# Daniel J. Berger
-# djberg96 at gmail dot com
-# imperator on IRC (irc.freenode.net)
-#
-# == Copyright
-# Copyright (c) 2005 Daniel J. Berger.
-# Licensed under the same terms as Ruby itself.
-#
-require "facade"
-require "ftools"
-require "fileutils"
-
-class Pathname < String
-   extend Facade
-   facade File
-   facade Dir
-   
-   if PLATFORM.match("mswin32")
-      require "Win32API"
-      @@PathStripToRoot  = Win32API.new("shlwapi","PathStripToRoot","P","L")
-      @@PathIsUNC        = Win32API.new("shlwapi","PathIsUNC","P","L")
-      @@PathIsURL        = Win32API.new("shlwapi","PathIsURL","P","L")
-      @@PathCanonicalize = Win32API.new("shlwapi","PathCanonicalize","PP","L")
-      @@PathAppend       = Win32API.new("shlwapi","PathAppend","PP","L")     
-      @@PathIsRoot       = Win32API.new("shlwapi","PathIsRoot","P","L")
-      @@PathIsDirectory  = Win32API.new("shlwapi","PathIsDirectory","P","L")
-      @@PathIsRelative   = Win32API.new("shlwapi","PathIsRelative","P","L")
-      @@PathFileExists   = Win32API.new("shlwapi","PathFileExists","P","L")
-      @@PathUndecorate   = Win32API.new("shlwapi","PathUndecorate","P","L")
-
-      @@PathGetDriveNumber =
-         Win32API.new("shlwapi","PathGetDriveNumber","P","L")
-   
-      @@PathCreateFromUrl  =
-         Win32API.new("shlwapi", "PathCreateFromUrl", "PPPL", "L")
-   
-      @@PathRemoveBackslash =
-         Win32API.new("shlwapi", "PathRemoveBackslash", "P", "P")
-   end
-
-   VERSION  = "1.0.0"
-   MAX_PATH = 260
-   
-   # Creates and returns a new Pathname object.
-   #
-   # On Win32 systems, all forward slashes are replaced with backslashes.
-   def initialize(path)
-      if path.length > MAX_PATH
-         msg = "string too long.  maximum string length is " + MAX_PATH.to_s
-         raise PathnameError, msg
-      end
-
-      @sep   = File::ALT_SEPARATOR || File::SEPARATOR
-      @win32 = PLATFORM.match("mswin32")
-
-      # Handle File URL's for Windows
-      if @win32
-         if @@PathIsURL.call(path) > 0
-            buf = 0.chr * MAX_PATH
-            len = [buf.length].pack("l")
-            if @@PathCreateFromUrl.call(path, buf, len, 0) >= 0
-               path = buf.strip
-            else
-               raise PathnameError, "invalid file url: #{path}"
-            end
-         end
-      end
-
-      # Convert forward slashes to backslashes on Win32
-      path = path.tr("/", @sep) if @win32
-      super(path)
-   end
-
-   # Win32 only
-   #
-   # Removes the decoration from a path string.  For example,
-   # C:\Path\File[5].txt would become C:\Path\File.txt.
-   def undecorate
-      unless @win32
-         raise NotImplementedError, "not supported on this platform"
-      end
-      buf = 0.chr * MAX_PATH
-      buf[0..self.length-1] = self
-      @@PathUndecorate.call(buf)
-      Pathname.new(buf.split(0.chr).first)
-   end
-
-   # Removes trailing slash, if present.
-   def pstrip
-      if @win32
-         @@PathRemoveBackslash.call(self)
-         self.strip!
-      else
-         if self[-1] == @sep
-            self.strip!
-            self.chop!
-         end
-      end
-      self
-   end
-
-   # Splits a pathname into pieces based on the path separator.  For example,
-   # "/foo/bar/baz" would return a three element array of ['foo','bar','baz'].
-   def to_a
-      array = split(@sep) # Split string by path separator
-      array.delete("")    # Remove empty elements
-      array
-   end
-   
-   # Yields each component of the path name to a block.
-   def each
-      self.to_a.each{ |element| yield element }
-   end
-
-   # Returns the root directory of the path, or '.' if there is no root
-   # directory.
-   #
-   # On Unix, this means the '/' character.  On Win32 systems, this can
-   # refer to the drive letter, or the server and share path if the path
-   # is a UNC path.
-   def root
-      dir = "."   
-      if @win32
-         buf = 0.chr * MAX_PATH
-         buf[0..self.length-1] = self
-      
-         if @@PathStripToRoot.call(buf) > 0
-            dir = Pathname.new(buf.split(0.chr).first)
-         end
-      else
-         dir = File.dirname(self)
-         while dir != "/" && dir != "."
-            dir = File.dirname(dir)
-         end
-      end
-      dir = "." if dir.empty?
-      dir
-   end
-
-   # Returns whether or not the path consists only of a root directory.
-   def root?
-      if @win32
-         @@PathIsRoot.call(self) > 0
-      else
-         self == root
-      end
-   end
-   
-   # Win32 only
-   #
-   # Determines if the string is a valid Universal Naming Convention (UNC)
-   # for a server and share path.
-   def unc?
-      unless @win32
-         raise NotImplementedError, "not supported on this platform"
-      end
-
-      @@PathIsUNC.call(self) > 0
-   end
-   
-   # Win32 only
-   #
-   # Returns the drive number that corresponds to the root, or nil if not
-   # applicable.
-   #
-   # For example, Pathname.new("C:\\foo").drive_number would return 2.
-   def drive_number
-      unless @win32
-         raise NotImplementedError, "not supported on this platform"
-      end
-
-      num = @@PathGetDriveNumber.call(self)
-      num >= 0 ? num : nil
-   end
-
-   # Pathnames may only be compared against other Pathnames, not strings.
-   def <=>(string)
-      return nil unless string.kind_of?(Pathname)
-      super
-   end
-
-   # Adds two Pathname objects together, or a Pathname and a String.  It
-   # also automatically cleans the Pathname.
-   #
-   # Example:
-   #    path1 = '/foo/bar'
-   #    path2 = '../baz'
-   #    path1 + path2 # '/foo/baz'
-   #
-   # Adding a root path to an existing path merely replaces the current
-   # path.  Adding '.' to an existing path does nothing.
-   def +(string)
-      unless string.kind_of?(Pathname)
-         string = Pathname.new(string)
-      end
-
-      # Any path plus "." is the same directory
-      return self if string == "."
-      
-      # Use the builtin PathAppend method if on Windows - much easier
-      if @win32
-         buf = 0.chr * MAX_PATH
-         buf[0..self.length-1] = self
-         @@PathAppend.call(buf, string << 0.chr)
-         buf.strip!
-         return Pathname.new(buf) # PathAppend cleans automatically
-      end
-      
-      # If the string is an absolute directory, return it
-      return string if string.absolute?
-
-      array = self.to_a + string.to_a
-      new_string = array.join(@sep)
-      
-      unless self.relative? || @win32
-         new_string = @sep + new_string   # Add root path back if needed
-      end
-      
-      Pathname.new(new_string).clean
-   end
-
-   # Returns whether or not the path is an absolute path.
-   def absolute?
-      !relative?
-   end
-   
-   # Returns whether or not the path is a relative path.
-   def relative?
-      if @win32
-         @@PathIsRelative.call(self) > 0
-      else
-         root == "."
-      end
-   end
-
-   # Removes unnecessary '.' paths and ellides '..' paths appropriately.
-   def clean
-      return self if self.empty?
-
-      if @win32
-         path = 0.chr * MAX_PATH
-         if @@PathCanonicalize.call(path, self) > 0
-            return Pathname.new(path.split(0.chr).first)
-         else
-            return self
-         end
-      end
-
-      final = []
-      self.to_a.each{ |element|
-         next if element == "."
-         final.push(element)
-         if element == ".." && self != ".."
-            2.times{ final.pop }
-         end
-      }
-      final = final.join(@sep)
-      final = root + final if root != "."
-      final = "." if final.empty?
-      Pathname.new(final)
-   end
-   alias :cleanpath :clean
-
-   #-- IO methods not handled by facade
-   
-   # IO.foreach
-   def foreach(*args, &block)
-      IO.foreach(self, *args, &block)
-   end
-
-   # IO.read
-   def read(*args)
-      IO.read(self, *args)
-   end
-
-   # IO.readlines
-   def readlines(*args)
-      IO.readlines(self, *args)  
-   end
-
-   # IO.sysopen
-   def sysopen(*args)
-      IO.sysopen(self, *args)
-   end
-
-   #-- Dir methods not handled by facade
-
-   # Dir.glob
-   def glob(*args)
-      if block_given?
-         Dir.glob(*args){ |file| yield Pathname.new(file) }
-      else
-         Dir.glob(*args).map{ |file| Pathname.new(file) }
-      end
-   end
-
-   # Dir.chdir
-   def chdir(&block)
-      Dir.chdir(self, &block)
-   end
-
-   # Dir.entries
-   def entries
-      Dir.entries(self).map{ |file| Pathname.new(file) }
-   end
-
-   # Dir.mkdir
-   def mkdir(*args)
-      Dir.mkdir(self, *args)
-   end
-
-   # Dir.opendir
-   def opendir(&block)
-      Dir.open(self, &block)
-   end
-
-   #-- File methods not handled by facade
-
-   # File.chmod
-   def chmod(mode)
-      File.chmod(mode, self)
-   end
-
-   # File.lchmod
-   def lchmod(mode)
-      File.lchmod(mode, self)
-   end
-
-   # File.chown
-   def chown(owner, group)
-      File.chown(owner, group, self)
-   end
-
-   # File.lchown
-   def lchown(owner, group)
-      File.lchown(owner, group, self)
-   end
-
-   # File.fnmatch
-   def fnmatch(pattern, *args)
-      File.fnmatch(pattern, self, *args)
-   end
-
-   # File.fnmatch?
-   def fnmatch?(pattern, *args)
-      File.fnmatch?(pattern, self, *args)
-   end
-
-   # File.link
-   def link(old)
-      File.link(old, self)
-   end
-
-   # File.open
-   def open(*args, &block)
-      File.open(self, *args, &block)
-   end
-
-   # File.rename
-   def rename(name)
-      File.rename(self, name)
-   end
-
-   # File.symlink
-   def symlink(old)
-      File.symlink(old, self)
-   end
-
-   # File.truncate
-   def truncate(length)
-      File.truncate(self, length)
-   end
-
-   # File.utime
-   def utime(atime, mtime)
-      File.utime(atime, mtime, self)
-   end
-
-   # File.basename
-   def basename(*args)
-      File.basename(self, *args)
-   end
-
-   # File.expand_path
-   def expand_path(*args)
-      File.expand_path(self, *args)
-   end
-
-   #--
-   # ftools facade
-   #++
-
-   # ftools File.copy
-   def copy(*args)
-      File.copy(self, *args)
-   end
-
-   #--
-   # FileUtils facade.  Note that methods already covered by File and Dir
-   # are not defined here (pwd, mkdir, etc).
-   #++
-
-   # FileUtils.cd
-   def cd(*args, &block)
-      FileUtils.cd(self, *args, &block)
-   end
-
-   # FileUtils.mkdir_p
-   def mkdir_p(*args)
-      FileUtils.mkdir_p(self, *args)
-   end
-   alias mkpath   mkdir_p
-
-   # FileUtils.ln
-   def ln(*args)
-      FileUtils.ln(self, *args)
-   end
-
-   # FileUtils.ln_s
-   def ln_s(*args)
-      FileUtils.ln_s(self, *args)
-   end
-
-   # FileUtils.ln_sf
-   def ln_sf(*args)
-      FileUtils.ln_sf(self, *args)
-   end
-
-   # FileUtils.cp
-   def cp(*args)
-      FileUtils.cp(self, *args)
-   end
-
-   # FileUtils.cp_r
-   def cp_r(*args)
-      FileUtils.cp_r(self, *args)
-   end
-
-   # FileUtils.mv
-   def mv(*args)
-      FileUtils.mv(self, *args)
-   end
-
-   # FileUtils.rm
-   def rm(*args)
-      FileUtils.rm(self, *args)
-   end
-   alias remove rm
-
-   # FileUtils.rm_f
-   def rm_f(*args)
-      FileUtils.rm_f(self, *args)
-   end
-
-   # FileUtils.rm_r
-   def rm_r(*args)
-      FileUtils.rm_r(self, *args)
-   end
-
-   # FileUtils.rm_rf
-   def rm_rf(*args)
-      FileUtils.rm_rf(self, *args)
-   end
-   alias rmtree rm_rf
-
-   # FileUtils.install
-   def install(*args)
-      FileUtils.install(self, *args)
-   end
-
-   # FileUtils.touch
-   def touch(*args)
-      FileUtils.touch(*args)
-   end
-
-   # FileUtils.compare_file
-   def compare_file(file)
-      FileUtils.compare_file(self, file)
-   end
-
-   # FileUtils.uptodate?
-   def uptodate?(*args)
-      FileUtils.uptodate(self, *args)
-   end
-
-   # FileUtils.copy_file
-   def copy_file(*args)
-      FileUtils.copy_file(self, *args)
-   end
-
-   # FileUtils.remove_dir
-   def remove_dir(*args)
-      FileUtils.remove_dir(self, *args)
-   end
-
-   # FileUtils.remove_file
-   def remove_file(*args)
-      FileUtils.remove_dir(self, *args)
-   end
-   
-   # FileUtils.copy_entry
-   def copy_entry(*args)
-      FileUtils.copy_entry(self, *args)
-   end
-end
+# == Synopsis
+#
+# Pathname represents a path name on a filesystem.  A Pathname can be
+# relative or absolute.  It does not matter whether the path exists or not.
+#
+# All functionality from File, FileTest, and Dir is included, using a facade
+# pattern.
+#
+# This class works on both Unix and Win32, including UNC path names.  Note
+# that forward slashes are converted to backslashes on Win32 systems.
+#
+# == Usage
+#
+# require "pathname"
+# 
+# # Unix
+# path1 = Pathname.new("/foo/bar/baz")
+# path2 = Pathname.new("../zap")
+#
+# path1 + path2 # "/foo/bar/zap"
+# path1.dirname # "/foo/bar"
+#
+# # Win32
+# path1 = Pathname.new("C:\\foo\\bar\\baz")
+# path2 = Pathname.new("..\\zap")
+#
+# path1 + path2 # "C:\\foo\\bar\\zap"
+# path1.exists? # Does the path exist?
+#
+# == Author
+#
+# Daniel J. Berger
+# djberg96 at gmail dot com
+# imperator on IRC (irc.freenode.net)
+#
+# == Copyright
+# Copyright (c) 2005 Daniel J. Berger.
+# Licensed under the same terms as Ruby itself.
+#
+require "facade"
+require "ftools"
+require "fileutils"
+
+class Pathname < String
+   extend Facade
+   facade File
+   facade Dir
+   
+   if PLATFORM.match("mswin32")
+      require "Win32API"
+      @@PathStripToRoot  = Win32API.new("shlwapi","PathStripToRoot","P","L")
+      @@PathIsUNC        = Win32API.new("shlwapi","PathIsUNC","P","L")
+      @@PathIsURL        = Win32API.new("shlwapi","PathIsURL","P","L")
+      @@PathCanonicalize = Win32API.new("shlwapi","PathCanonicalize","PP","L")
+      @@PathAppend       = Win32API.new("shlwapi","PathAppend","PP","L")     
+      @@PathIsRoot       = Win32API.new("shlwapi","PathIsRoot","P","L")
+      @@PathIsDirectory  = Win32API.new("shlwapi","PathIsDirectory","P","L")
+      @@PathIsRelative   = Win32API.new("shlwapi","PathIsRelative","P","L")
+      @@PathFileExists   = Win32API.new("shlwapi","PathFileExists","P","L")
+      @@PathUndecorate   = Win32API.new("shlwapi","PathUndecorate","P","L")
+
+      @@PathGetDriveNumber =
+         Win32API.new("shlwapi","PathGetDriveNumber","P","L")
+   
+      @@PathCreateFromUrl  =
+         Win32API.new("shlwapi", "PathCreateFromUrl", "PPPL", "L")
+   
+      @@PathRemoveBackslash =
+         Win32API.new("shlwapi", "PathRemoveBackslash", "P", "P")
+   end
+
+   VERSION  = "1.1.0"
+   MAX_PATH = 260
+   
+   # Creates and returns a new Pathname object.
+   #
+   # On Win32 systems, all forward slashes are replaced with backslashes.
+   def initialize(path)
+      if path.length > MAX_PATH
+         msg = "string too long.  maximum string length is " + MAX_PATH.to_s
+         raise PathnameError, msg
+      end
+
+      @sep   = File::ALT_SEPARATOR || File::SEPARATOR
+      @win32 = PLATFORM.match("mswin32")
+
+      # Handle File URL's for Windows
+      if @win32
+         if @@PathIsURL.call(path) > 0
+            buf = 0.chr * MAX_PATH
+            len = [buf.length].pack("l")
+            if @@PathCreateFromUrl.call(path, buf, len, 0) >= 0
+               path = buf.strip
+            else
+               raise PathnameError, "invalid file url: #{path}"
+            end
+         end
+      end
+
+      # Convert forward slashes to backslashes on Win32
+      path = path.tr("/", @sep) if @win32
+      super(path)
+   end
+
+   # Win32 only
+   #
+   # Removes the decoration from a path string.  For example,
+   # C:\Path\File[5].txt would become C:\Path\File.txt.
+   def undecorate
+      unless @win32
+         raise NotImplementedError, "not supported on this platform"
+      end
+      buf = 0.chr * MAX_PATH
+      buf[0..self.length-1] = self
+      @@PathUndecorate.call(buf)
+      Pathname.new(buf.split(0.chr).first)
+   end
+
+   # Removes trailing slash, if present.
+   def pstrip
+      if @win32
+         @@PathRemoveBackslash.call(self)
+         self.strip!
+      else
+         if self[-1] == @sep
+            self.strip!
+            self.chop!
+         end
+      end
+      self
+   end
+
+   # Splits a pathname into pieces based on the path separator.  For example,
+   # "/foo/bar/baz" would return a three element array of ['foo','bar','baz'].
+   def to_a
+      array = split(@sep) # Split string by path separator
+      array.delete("")    # Remove empty elements
+      array
+   end
+   
+   # Yields each component of the path name to a block.
+   def each
+      self.to_a.each{ |element| yield element }
+   end
+
+   # Returns the root directory of the path, or '.' if there is no root
+   # directory.
+   #
+   # On Unix, this means the '/' character.  On Win32 systems, this can
+   # refer to the drive letter, or the server and share path if the path
+   # is a UNC path.
+   def root
+      dir = "."   
+      if @win32
+         buf = 0.chr * MAX_PATH
+         buf[0..self.length-1] = self
+      
+         if @@PathStripToRoot.call(buf) > 0
+            dir = Pathname.new(buf.split(0.chr).first)
+         end
+      else
+         dir = File.dirname(self)
+         while dir != "/" && dir != "."
+            dir = File.dirname(dir)
+         end
+      end
+      dir = "." if dir.empty?
+      dir
+   end
+
+   # Returns whether or not the path consists only of a root directory.
+   def root?
+      if @win32
+         @@PathIsRoot.call(self) > 0
+      else
+         self == root
+      end
+   end
+   
+   # Win32 only
+   #
+   # Determines if the string is a valid Universal Naming Convention (UNC)
+   # for a server and share path.
+   def unc?
+      unless @win32
+         raise NotImplementedError, "not supported on this platform"
+      end
+
+      @@PathIsUNC.call(self) > 0
+   end
+   
+   # Win32 only
+   #
+   # Returns the drive number that corresponds to the root, or nil if not
+   # applicable.
+   #
+   # For example, Pathname.new("C:\\foo").drive_number would return 2.
+   def drive_number
+      unless @win32
+         raise NotImplementedError, "not supported on this platform"
+      end
+
+      num = @@PathGetDriveNumber.call(self)
+      num >= 0 ? num : nil
+   end
+
+   # Pathnames may only be compared against other Pathnames, not strings.
+   def <=>(string)
+      return nil unless string.kind_of?(Pathname)
+      super
+   end
+
+   # Adds two Pathname objects together, or a Pathname and a String.  It
+   # also automatically cleans the Pathname.
+   #
+   # Example:
+   #    path1 = '/foo/bar'
+   #    path2 = '../baz'
+   #    path1 + path2 # '/foo/baz'
+   #
+   # Adding a root path to an existing path merely replaces the current
+   # path.  Adding '.' to an existing path does nothing.
+   def +(string)
+      unless string.kind_of?(Pathname)
+         string = Pathname.new(string)
+      end
+
+      # Any path plus "." is the same directory
+      return self if string == "."
+      
+      # Use the builtin PathAppend method if on Windows - much easier
+      if @win32
+         buf = 0.chr * MAX_PATH
+         buf[0..self.length-1] = self
+         @@PathAppend.call(buf, string << 0.chr)
+         buf.strip!
+         return Pathname.new(buf) # PathAppend cleans automatically
+      end
+      
+      # If the string is an absolute directory, return it
+      return string if string.absolute?
+
+      array = self.to_a + string.to_a
+      new_string = array.join(@sep)
+      
+      unless self.relative? || @win32
+         new_string = @sep + new_string   # Add root path back if needed
+      end
+      
+      Pathname.new(new_string).clean
+   end
+
+   # Returns whether or not the path is an absolute path.
+   def absolute?
+      !relative?
+   end
+   
+   # Returns whether or not the path is a relative path.
+   def relative?
+      if @win32
+         @@PathIsRelative.call(self) > 0
+      else
+         root == "."
+      end
+   end
+
+   # Removes unnecessary '.' paths and ellides '..' paths appropriately.
+   def clean
+      return self if self.empty?
+
+      if @win32
+         path = 0.chr * MAX_PATH
+         if @@PathCanonicalize.call(path, self) > 0
+            return Pathname.new(path.split(0.chr).first)
+         else
+            return self
+         end
+      end
+
+      final = []
+      self.to_a.each{ |element|
+         next if element == "."
+         final.push(element)
+         if element == ".." && self != ".."
+            2.times{ final.pop }
+         end
+      }
+      final = final.join(@sep)
+      final = root + final if root != "."
+      final = "." if final.empty?
+      Pathname.new(final)
+   end
+   alias :cleanpath :clean
+
+   #-- Find facade
+
+   # Pathname#find is an iterator to traverse a directory tree in a depth first
+   # manner. It yields a Pathname for each file under the directory passed to
+   # Pathname.new.
+   #
+   # Since it is implemented by the Find module, Find.prune can be used to
+   # control the traverse.
+   #
+   # If +self+ is ".", yielded pathnames begin with a filename in the current
+   # current directory, not ".".
+   #
+   def find(&block)
+      require "find"
+      if self == "."
+         Find.find(self){ |f| yield Pathname.new(f.sub(%r{\A\./}, '')) }
+      else
+         Find.find(self) {|f| yield Pathname.new(f) }
+      end
+   end
+
+   #-- IO methods not handled by facade
+   
+   # IO.foreach
+   def foreach(*args, &block)
+      IO.foreach(self, *args, &block)
+   end
+
+   # IO.read
+   def read(*args)
+      IO.read(self, *args)
+   end
+
+   # IO.readlines
+   def readlines(*args)
+      IO.readlines(self, *args)  
+   end
+
+   # IO.sysopen
+   def sysopen(*args)
+      IO.sysopen(self, *args)
+   end
+
+   #-- Dir methods not handled by facade
+
+   # Dir.glob
+   def glob(*args)
+      if block_given?
+         Dir.glob(*args){ |file| yield Pathname.new(file) }
+      else
+         Dir.glob(*args).map{ |file| Pathname.new(file) }
+      end
+   end
+
+   # Dir.chdir
+   def chdir(&block)
+      Dir.chdir(self, &block)
+   end
+
+   # Dir.entries
+   def entries
+      Dir.entries(self).map{ |file| Pathname.new(file) }
+   end
+
+   # Dir.mkdir
+   def mkdir(*args)
+      Dir.mkdir(self, *args)
+   end
+
+   # Dir.opendir
+   def opendir(&block)
+      Dir.open(self, &block)
+   end
+
+   #-- File methods not handled by facade
+
+   # File.chmod
+   def chmod(mode)
+      File.chmod(mode, self)
+   end
+
+   # File.lchmod
+   def lchmod(mode)
+      File.lchmod(mode, self)
+   end
+
+   # File.chown
+   def chown(owner, group)
+      File.chown(owner, group, self)
+   end
+
+   # File.lchown
+   def lchown(owner, group)
+      File.lchown(owner, group, self)
+   end
+
+   # File.fnmatch
+   def fnmatch(pattern, *args)
+      File.fnmatch(pattern, self, *args)
+   end
+
+   # File.fnmatch?
+   def fnmatch?(pattern, *args)
+      File.fnmatch?(pattern, self, *args)
+   end
+
+   # File.link
+   def link(old)
+      File.link(old, self)
+   end
+
+   # File.open
+   def open(*args, &block)
+      File.open(self, *args, &block)
+   end
+
+   # File.rename
+   def rename(name)
+      File.rename(self, name)
+   end
+
+   # File.symlink
+   def symlink(old)
+      File.symlink(old, self)
+   end
+
+   # File.truncate
+   def truncate(length)
+      File.truncate(self, length)
+   end
+
+   # File.utime
+   def utime(atime, mtime)
+      File.utime(atime, mtime, self)
+   end
+
+   # File.basename
+   def basename(*args)
+      File.basename(self, *args)
+   end
+
+   # File.expand_path
+   def expand_path(*args)
+      File.expand_path(self, *args)
+   end
+
+   #--
+   # ftools facade
+   #++
+
+   # ftools File.copy
+   def copy(*args)
+      File.copy(self, *args)
+   end
+
+   #--
+   # FileUtils facade.  Note that methods already covered by File and Dir
+   # are not defined here (pwd, mkdir, etc).
+   #++
+
+   # FileUtils.cd
+   def cd(*args, &block)
+      FileUtils.cd(self, *args, &block)
+   end
+
+   # FileUtils.mkdir_p
+   def mkdir_p(*args)
+      FileUtils.mkdir_p(self, *args)
+   end
+   alias mkpath   mkdir_p
+
+   # FileUtils.ln
+   def ln(*args)
+      FileUtils.ln(self, *args)
+   end
+
+   # FileUtils.ln_s
+   def ln_s(*args)
+      FileUtils.ln_s(self, *args)
+   end
+
+   # FileUtils.ln_sf
+   def ln_sf(*args)
+      FileUtils.ln_sf(self, *args)
+   end
+
+   # FileUtils.cp
+   def cp(*args)
+      FileUtils.cp(self, *args)
+   end
+
+   # FileUtils.cp_r
+   def cp_r(*args)
+      FileUtils.cp_r(self, *args)
+   end
+
+   # FileUtils.mv
+   def mv(*args)
+      FileUtils.mv(self, *args)
+   end
+
+   # FileUtils.rm
+   def rm(*args)
+      FileUtils.rm(self, *args)
+   end
+   alias remove rm
+
+   # FileUtils.rm_f
+   def rm_f(*args)
+      FileUtils.rm_f(self, *args)
+   end
+
+   # FileUtils.rm_r
+   def rm_r(*args)
+      FileUtils.rm_r(self, *args)
+   end
+
+   # FileUtils.rm_rf
+   def rm_rf(*args)
+      FileUtils.rm_rf(self, *args)
+   end
+   alias rmtree rm_rf
+
+   # FileUtils.install
+   def install(*args)
+      FileUtils.install(self, *args)
+   end
+
+   # FileUtils.touch
+   def touch(*args)
+      FileUtils.touch(*args)
+   end
+
+   # FileUtils.compare_file
+   def compare_file(file)
+      FileUtils.compare_file(self, file)
+   end
+
+   # FileUtils.uptodate?
+   def uptodate?(*args)
+      FileUtils.uptodate(self, *args)
+   end
+
+   # FileUtils.copy_file
+   def copy_file(*args)
+      FileUtils.copy_file(self, *args)
+   end
+
+   # FileUtils.remove_dir
+   def remove_dir(*args)
+      FileUtils.remove_dir(self, *args)
+   end
+
+   # FileUtils.remove_file
+   def remove_file(*args)
+      FileUtils.remove_dir(self, *args)
+   end
+   
+   # FileUtils.copy_entry
+   def copy_entry(*args)
+      FileUtils.copy_entry(self, *args)
+   end
+end