Contents

# frozen_string_literal: true

require 'puppet-strings/yard/code_objects'

# Implements a parameter directive (e.g. #@!puppet.type.property) for documenting Puppet resource types.
class PuppetStrings::Yard::Tags::PropertyDirective < YARD::Tags::Directive
  # Called to invoke the directive.
  # @return [void]
  def call
    return unless object&.respond_to?(:add_property)

    # Add a property to the resource
    property = PuppetStrings::Yard::CodeObjects::Type::Property.new(tag.name, tag.text)
    tag.types&.each do |value|
      property.add(value)
    end
    object.add_property property
  end

  # Registers the directive with YARD.
  # @return [void]
  def self.register!
    YARD::Tags::Library.define_directive('puppet.type.property', :with_types_and_name, self)
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
puppet-strings-3.0.1	lib/puppet-strings/yard/tags/property_directive.rb
puppet-strings-3.0.0	lib/puppet-strings/yard/tags/property_directive.rb