Contents

# Created on 2008-01-19
# Copyright Luke Kanies

# A common module to handle tagging.
module Puppet::Util::Tagging
    # Add a tag to our current list.  These tags will be added to all
    # of the objects contained in this scope.
    def tag(*ary)
        @tags ||= []

        qualified = []

        ary.collect { |tag| tag.to_s.downcase }.each do |tag|
            fail(Puppet::ParseError, "Invalid tag %s" % tag.inspect) unless valid_tag?(tag)
            qualified << tag if tag.include?("::")
            @tags << tag unless @tags.include?(tag)
        end

        handle_qualified_tags( qualified )
    end

    # Are we tagged with the provided tag?
    def tagged?(*tags)
        not ( self.tags & tags.flatten.collect { |t| t.to_s } ).empty?
    end

    # Return a copy of the tag list, so someone can't ask for our tags
    # and then modify them.
    def tags
        @tags ||= []
        @tags.dup
    end

    def tags=(tags)
        @tags = []

        return if tags.nil? or tags == ""

        if tags.is_a?(String)
            tags = tags.strip.split(/\s*,\s*/)
        end

        tags.each do |t|
            tag(t)
        end
    end

    private

    def handle_qualified_tags( qualified )
        # LAK:NOTE See http://snurl.com/21zf8  [groups_google_com]
        qualified.collect { |name| x = name.split("::") }.flatten.each { |tag| @tags << tag unless @tags.include?(tag) }
    end

    def valid_tag?(tag)
        tag =~ /^\w[-\w:.]*$/
    end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
puppet-0.25.5	lib/puppet/util/tagging.rb
puppet-0.25.4	lib/puppet/util/tagging.rb
puppet-0.25.3	lib/puppet/util/tagging.rb
puppet-0.25.2	lib/puppet/util/tagging.rb