summaryrefslogtreecommitdiffstats
path: root/lib/puppet/file_serving/fileset.rb
blob: 4155685d6ace3b43fc5983c6135928f7b1d59ece (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
#
#  Created by Luke Kanies on 2007-10-22.
#  Copyright (c) 2007. All rights reserved.

require 'find'
require 'puppet/file_serving'
require 'puppet/file_serving/metadata'

# Operate recursively on a path, returning a set of file paths.
class Puppet::FileServing::Fileset
    attr_reader :path, :ignore, :links
    attr_accessor :recurse, :recurselimit, :checksum_type

    # Produce a hash of files, with merged so that earlier files
    # with the same postfix win.  E.g., /dir1/subfile beats /dir2/subfile.
    # It's a hash because we need to know the relative path of each file,
    # and the base directory.
    #   This will probably only ever be used for searching for plugins.
    def self.merge(*filesets)
        result = {}

        filesets.each do |fileset|
            fileset.files.each do |file|
                result[file] ||= fileset.path
            end
        end

        result
    end

    # Return a list of all files in our fileset.  This is different from the
    # normal definition of find in that we support specific levels
    # of recursion, which means we need to know when we're going another
    # level deep, which Find doesn't do.
    def files
        files = perform_recursion

        # Now strip off the leading path, so each file becomes relative, and remove
        # any slashes that might end up at the beginning of the path.
        result = files.collect { |file| file.sub(%r{^#{Regexp.escape(@path)}/*}, '') }

        # And add the path itself.
        result.unshift(".")

        result
    end

    # Should we ignore this path?
    def ignore?(path)
        return false if @ignore == [nil]

        # 'detect' normally returns the found result, whereas we just want true/false.
        ! @ignore.detect { |pattern| File.fnmatch?(pattern, path) }.nil?
    end

    def ignore=(values)
        values = [values] unless values.is_a?(Array)
        @ignore = values
    end

    def initialize(path, options = {})
        raise ArgumentError.new("Fileset paths must be fully qualified") unless File.expand_path(path) == path

        @path = path

        # Set our defaults.
        @ignore = []
        @links = :manage
        @recurse = false
        @recurselimit = :infinite

        if options.is_a?(Puppet::Indirector::Request)
            initialize_from_request(options)
        else
            initialize_from_hash(options)
        end

        raise ArgumentError.new("Fileset paths must exist") unless stat = stat(path)
        raise ArgumentError.new("Fileset recurse parameter must not be a number anymore, please use recurselimit") if @recurse.is_a?(Integer)
    end

    def links=(links)
        links = links.to_sym
        raise(ArgumentError, "Invalid :links value '#{links}'") unless [:manage, :follow].include?(links)
        @links = links
        @stat_method = links == :manage ? :lstat : :stat
    end

    # Should we recurse further?  This is basically a single
    # place for all of the logic around recursion.
    def recurse?(depth)
        # recurse if told to, and infinite recursion or current depth not at the limit
        self.recurse and (self.recurselimit == :infinite or depth <= self.recurselimit)
    end

    def initialize_from_hash(options)
        options.each do |option, value|
            method = option.to_s + "="
            begin
                send(method, value)
            rescue NoMethodError
                raise ArgumentError, "Invalid option '#{option}'"
            end
        end
    end

    def initialize_from_request(request)
        [:links, :ignore, :recurse, :recurselimit, :checksum_type].each do |param|
            if request.options.include?(param) # use 'include?' so the values can be false
                value = request.options[param]
            elsif request.options.include?(param.to_s)
                value = request.options[param.to_s]
            end
            next if value.nil?
            value = true if value == "true"
            value = false if value == "false"
            value = Integer(value) if value.is_a?(String) and value =~ /^\d+$/
            send(param.to_s + "=", value)
        end
    end

    private

    # Pull the recursion logic into one place.  It's moderately hairy, and this
    # allows us to keep the hairiness apart from what we do with the files.
    def perform_recursion
        # Start out with just our base directory.
        current_dirs = [@path]

        next_dirs = []

        depth = 1

        result = []
        return result unless recurse?(depth)

        while dir_path = current_dirs.shift or ((depth += 1) and recurse?(depth) and current_dirs = next_dirs and next_dirs = [] and dir_path = current_dirs.shift)
            next unless stat = stat(dir_path)
            next unless stat.directory?

            Dir.entries(dir_path).each do |file_path|
                next if [".", ".."].include?(file_path)

                # Note that this also causes matching directories not
                # to be recursed into.
                next if ignore?(file_path)

                # Add it to our list of files to return
                result << File.join(dir_path, file_path)

                # And to our list of files/directories to iterate over.
                next_dirs << File.join(dir_path, file_path)
            end
        end

        return result
    end
    public
    # Stat a given file, using the links-appropriate method.
    def stat(path)
        unless defined?(@stat_method)
            @stat_method = self.links == :manage ? :lstat : :stat
        end

        begin
            return File.send(@stat_method, path)
        rescue
            # If this happens, it is almost surely because we're
            # trying to manage a link to a file that does not exist.
            return nil
        end
    end
end