# find.rb: the Find module for processing all files under a given directory.
# The +Find+ module supports the top-down traversal of a set of file paths.
# For example, to total the size of all files under your home directory,
# ignoring anything in a "dot" directory (e.g. $HOME/.ssh):
# Find.find(ENV["HOME"]) do |path|
# if FileTest.directory?(path)
# if File.basename(path)[0] == ?.
# Find.prune # Don't look any further into this directory.
# total_size += FileTest.size(path)
# Calls the associated block with the name of every file and directory listed
# as arguments, then recursively on their subdirectories, and so on.
# See the +Find+ module documentation for an example.
def find(*paths) # :yield: path
paths.collect!{|d| d.dup}
next unless File.exist? file
if File.lstat(file).directory? then
next if f == "." or f == ".."
if File::ALT_SEPARATOR and file =~ /^(?:[\/\\]|[A-Za-z]:[\/\\]?)$/ then
rescue Errno::ENOENT, Errno::EACCES
# Skips the current file or directory, restarting the loop with the next
# entry. If the current file is a directory, that directory will not be
# recursively entered. Meaningful only within the block associated with
# See the +Find+ module documentation for an example.
module_function :find, :prune