Class: Tins::Find::Finder

Inherits:
Object show all
Defined in:
lib/tins/find.rb

Defined Under Namespace

Modules: PathExtension

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(opts = {}) ⇒ Finder

Returns a new instance of Finder.



57
58
59
60
61
62
 
# File 'lib/tins/find.rb', line 57

def initialize(opts = {})
  @show_hidden     = opts.fetch(:show_hidden)     { true }
  @raise_errors    = opts.fetch(:raise_errors)    { false }
  @follow_symlinks = opts.fetch(:follow_symlinks) { true }
  opts[:suffix].full? { |s| @suffix = [*s] }
end

Instance Attribute Details

Returns the value of attribute follow_symlinks.



68
69
70
 
# File 'lib/tins/find.rb', line 68

def follow_symlinks
  @follow_symlinks
end

#raise_errors ⇒ Object

Returns the value of attribute raise_errors.



66
67
68
 
# File 'lib/tins/find.rb', line 66

def raise_errors
  @raise_errors
end

#show_hidden ⇒ Object

Returns the value of attribute show_hidden.



64
65
66
 
# File 'lib/tins/find.rb', line 64

def show_hidden
  @show_hidden
end

#suffix ⇒ Object

Returns the value of attribute suffix.



70
71
72
 
# File 'lib/tins/find.rb', line 70

def suffix
  @suffix
end

Instance Method Details

#find(*paths) ⇒ Object 



76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/tins/find.rb', line 76

def find(*paths)
  block_given? or return enum_for(__method__, *paths)
  paths.collect! { |d| d.dup }
  while path = paths.shift
    path = prepare_path(path)
    catch(:prune) do
      stat = path.finder_stat or next
      visit_path?(path) and yield path
      if stat.directory?
        ps = protect_from_errors { Dir.entries(path) } or next
        ps.sort!
        ps.reverse_each do |p|
          next if p == "." or p == ".."
          next if !@show_hidden && p.start_with?('.')
          p = File.join(path, p)
          paths.unshift p.untaint
        end
      end
    end
  end
end

#prepare_path(path) ⇒ Object 



98
99
100
101
102
103
 
# File 'lib/tins/find.rb', line 98

def prepare_path(path)
  path = path.dup.taint
  path.extend PathExtension
  path.finder = self
  path
end

#protect_from_errors(errors = Find::EXPECTED_STANDARD_ERRORS) ⇒ Object 



105
106
107
108
109
110
 
# File 'lib/tins/find.rb', line 105

def protect_from_errors(errors = Find::EXPECTED_STANDARD_ERRORS)
  yield
rescue errors
  raise_errors and raise
  return
end

#visit_path?(path) ⇒ Boolean

Returns:

  • (Boolean) 


72
73
74
 
# File 'lib/tins/find.rb', line 72

def visit_path?(path)
  @suffix.nil? || @suffix.include?(path.suffix)
end