Sha256: 2ce0ed52e994284751bc65ea3b3966200a08176f145fecedcd81017d4e5ffb90

Contents?: true

Size: 1.1 KB

Versions: 12

Compression:

Stored size: 1.1 KB

Contents

# frozen_string_literal: true

require 'puppet-strings/yard/handlers/helpers'
require 'puppet-strings/yard/handlers/puppet/base'
require 'puppet-strings/yard/parsers'
require 'puppet-strings/yard/code_objects'

# Implements the handler for Puppet Data Type Alias.
class PuppetStrings::Yard::Handlers::Puppet::DataTypeAliasHandler < PuppetStrings::Yard::Handlers::Puppet::Base
  handles PuppetStrings::Yard::Parsers::Puppet::DataTypeAliasStatement

  process do
    # Register the object
    object = PuppetStrings::Yard::CodeObjects::DataTypeAlias.new(statement)
    register object

    # Log a warning if missing documentation
    log.warn "Missing documentation for Puppet type alias '#{object.name}' at #{statement.file}:#{statement.line}." if object.docstring.empty? && object.tags.empty?

    # Mark the class as public if it doesn't already have an api tag
    object.add_tag YARD::Tags::Tag.new(:api, 'public') unless object.has_tag? :api

    # Warn if a summary longer than 140 characters was provided
    PuppetStrings::Yard::Handlers::Helpers.validate_summary_tag(object) if object.has_tag? :summary
  end
end

Version data entries

12 entries across 12 versions & 1 rubygems

Version Path
puppet-strings-4.1.3 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-4.1.2 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-4.1.1 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-4.1.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-4.0.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-4.0.0.rc.1 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-3.0.1 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-3.0.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-2.9.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-2.8.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-2.7.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb
puppet-strings-2.6.0 lib/puppet-strings/yard/handlers/puppet/data_type_alias_handler.rb