Sha256: 3620b782bfe81ff6e0888e263b9f865100af39fed1518b11d034364a33956658

Contents?: true

Size: 1.71 KB

Versions: 315

Compression:

Stored size: 1.71 KB

Contents

# Select and show a list of resources of a given type.
Puppet::Face.define(:catalog, '0.0.1') do
  action :select do
    summary "Retrieve a catalog and filter it for resources of a given type."
    arguments "<host> <resource_type>"
    returns <<-'EOT'
      A list of resource references ("Type[title]"). When used from the API,
      returns an array of Puppet::Resource objects excised from a catalog.
    EOT
    description <<-'EOT'
      Retrieves a catalog for the specified host, then searches it for all
      resources of the requested type.
    EOT
    notes <<-'NOTES'
      By default, this action will retrieve a catalog from Puppet's compiler
      subsystem; you must call the action with `--terminus rest` if you wish
      to retrieve a catalog from the puppet master.

      FORMATTING ISSUES: This action cannot currently render useful yaml;
      instead, it returns an entire catalog. Use json instead.
    NOTES
    examples <<-'EOT'
      Ask the puppet master for a list of managed file resources for a node:

      $ puppet catalog select --terminus rest somenode.magpie.lan file
    EOT
    when_invoked do |host, type, options|
      # REVISIT: Eventually, type should have a default value that triggers
      # the non-specific behaviour.  For now, though, this will do.
      # --daniel 2011-05-03
      catalog = Puppet::Resource::Catalog.indirection.find(host)

      if type == '*'
        catalog.resources
      else
        type = type.downcase
        catalog.resources.reject { |res| res.type.downcase != type }
      end
    end

    when_rendering :console do |value|
      if value.nil? then
        "no matching resources found"
      else
        value.map {|x| x.to_s }.join("\n")
      end
    end
  end
end

Version data entries

315 entries across 315 versions & 5 rubygems

Version Path
puppet-retrospec-1.8.0 vendor/pup410/lib/puppet/face/catalog/select.rb
puppet-retrospec-1.7.0 vendor/pup410/lib/puppet/face/catalog/select.rb
puppet-4.10.12 lib/puppet/face/catalog/select.rb
puppet-4.10.12-x86-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.12-x64-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.12-universal-darwin lib/puppet/face/catalog/select.rb
puppet-4.10.11 lib/puppet/face/catalog/select.rb
puppet-4.10.11-x86-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.11-x64-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.11-universal-darwin lib/puppet/face/catalog/select.rb
puppet-4.10.10 lib/puppet/face/catalog/select.rb
puppet-4.10.10-x86-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.10-x64-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.10-universal-darwin lib/puppet/face/catalog/select.rb
puppet-retrospec-1.6.1 vendor/pup410/lib/puppet/face/catalog/select.rb
puppet-retrospec-1.6.0 vendor/pup410/lib/puppet/face/catalog/select.rb
puppet-4.10.9 lib/puppet/face/catalog/select.rb
puppet-4.10.9-x86-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.9-x64-mingw32 lib/puppet/face/catalog/select.rb
puppet-4.10.9-universal-darwin lib/puppet/face/catalog/select.rb