RubyGems - puppet-retrospec - Versions diffs - 1.5.0 → 1.6.0 - Mend

puppet-retrospec 1.5.0 → 1.6.0

Files changed (1848) hide show

data/vendor/gems/puppet-4.5.2/lib/puppet/application/key.rb DELETED

@@ -1,4 +0,0 @@
-require 'puppet/application/indirection_base'
-class Puppet::Application::Key < Puppet::Application::IndirectionBase
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/application/lookup.rb DELETED

@@ -1,342 +0,0 @@
-require 'puppet/application'
-require 'puppet/pops'
-require 'puppet/node'
-require 'puppet/parser/compiler'
-class Puppet::Application::Lookup < Puppet::Application
-  RUN_HELP = "Run 'puppet lookup --help' for more details".freeze
-  DEEP_MERGE_OPTIONS = '--knock-out-prefix, --sort-merged-arrays, and --merge-hash-arrays'.freeze
-  run_mode :master
-  # Options for lookup
-  option('--merge TYPE') do |arg|
-    options[:merge] = arg
-  end
-  option('--debug', '-d')
-  option('--verbose', '-v')
-  option('--render-as FORMAT') do |format|
-    options[:render_as] = format.downcase.to_sym
-  end
-  option('--type TYPE_STRING') do |arg|
-    options[:type] = arg
-  end
-  option('--compile', '-c')
-  option('--knock-out-prefix PREFIX_STRING') do |arg|
-    options[:prefix] = arg
-  end
-  option('--sort-merge-arrays')
-  option('--merge-hash-arrays')
-  option('--explain')
-  option('--explain-options')
-  option('--default VALUE') do |arg|
-    options[:default_value] = arg
-  end
-  # not yet supported
-  option('--trusted')
-  # Options for facts/scope
-  option('--node NODE_NAME') do |arg|
-    options[:node] = arg
-  end
-  option('--facts FACT_FILE') do |arg|
-    if %w{.yaml .yml .json}.include?(arg.match(/\.[^.]*$/)[0])
-      options[:fact_file] = arg
-    else
-      raise "The --fact file only accepts yaml and json files.\n#{RUN_HELP}"
-    end
-  end
-  # Sets up the 'node_cache_terminus' default to use the Write Only Yaml terminus :write_only_yaml.
-  # If this is not wanted, the setting ´node_cache_terminus´ should be set to nil.
-  # @see Puppet::Node::WriteOnlyYaml
-  # @see #setup_node_cache
-  # @see puppet issue 16753
-  #
-  def app_defaults
-    super.merge({
-      :node_cache_terminus => :write_only_yaml,
-      :facts_terminus => 'yaml'
-    })
-  end
-  def setup_logs
-    # This sets up logging based on --debug or --verbose if they are set in `options`
-    set_log_level
-    # This uses console for everything that is not a compilation
-    Puppet::Util::Log.newdestination(:console)
-  end
-  def setup_terminuses
-    require 'puppet/file_serving/content'
-    require 'puppet/file_serving/metadata'
-    Puppet::FileServing::Content.indirection.terminus_class = :file_server
-    Puppet::FileServing::Metadata.indirection.terminus_class = :file_server
-    Puppet::FileBucket::File.indirection.terminus_class = :file
-  end
-  def setup
-    setup_logs
-    exit(Puppet.settings.print_configs ? 0 : 1) if Puppet.settings.print_configs?
-    Puppet.settings.use :main, :master, :ssl, :metrics
-    setup_terminuses
-  end
-  def help
-    <<-'HELP'
-puppet-lookup(8) -- Data in modules lookup function
-========
-SYNOPSIS
---------
-The lookup command is used for debugging and testing a given data
-configuration. For a given data key, lookup will produce either a
-value or an explanation of how that value was obtained on the standard
-output stream with the specified rendering format. Lookup is designed
-to be run on a puppet master or a node in a masterless setup.
-USAGE
------
-puppet lookup [--help] [--type <TYPESTRING>] [--merge unique|hash|deep]
-  [--knock-out-prefix <PREFIX-STRING>] [--sort-merged-arrays]
-  [--merge-hash-arrays] [--explain]
-  [--default <VALUE>] [--node <NODE-NAME>] [--facts <FILE>]
-  [--compile]
-  [--render-as s|json|yaml|binary|msgpack] <keys>
-DESCRIPTION
------------
-The lookup command is a CLI interface for the puppet lookup function.
-When given one or more keys, the lookup command will return the first
-value found when run from the puppet master or a masterless node.
-When an explanation has not been requested and
-lookup is simply looking up a value, the application will exit with 0
-if a value was found and 1 otherwise. When an explanation is requested,
-lookup will always exit with 0 unless there is a major error.
-The other options are as passed into the lookup function, and the effect
-they have on the lookup is described in more detail in the header
-for the lookup function:
-http://links.puppetlabs.com/lookup-docs
-OPTIONS
--------
-These options and their effects are decribed in more detail in
-the puppet lookup function linked to above.
-* --help:
-  Print this help message.
-* --type <TYPESTRING>:
-  Assert that the value has the specified type.
-* --merge unique|hash|deep:
-  Specify the merge strategy. 'hash' performs a simple hash-merge by
-  overwriting keys of lower lookup priority. 'unique' appends everything
-  to an array containing no nested arrays and where all duplicates have been
-  removed. 'deep' Performs a deep merge on values of Array and Hash type. There
-  are additional option flags that can be used with 'deep'.
-* --knock-out-prefix <PREFIX-STRING>
-  Can be used with the 'deep' merge strategy. Specify string value to signify
-  prefix which deletes elements from existing element.
-* --sort-merged-arrays
-  Can be used with the 'deep' merge strategy. When this flag is used all
-  merged arrays will be sorted.
-* --merge-hash-arrays
-  Can be used with the 'deep' merge strategy. When this flag is used arrays
-  and hashes will be merged.
-* --explain
-  Print an explanation for the details of how the lookup performed rather
-  than the value returned for the key. The explaination will describe how
-  the result was obtained or why lookup failed to obtain the result.
-* --explain-options
-  Explain if a lookup_options hash will be used and how it was assembled
-  when performing a lookup.
-* --default <VALUE>
-  A value produced if no value was found in the lookup.
-* --node <NODE-NAME>
-  Specify node which defines the scope in which the lookup will be performed.
-  If a node is not given, lookup will default to the machine from which the
-  lookup is being run (which should be the master).
-* --facts <FILE>
-  Specify a .json, or .yaml file holding key => value mappings that will
-  override the facts for the current node. Any facts not specified by the
-  user will maintain their original value.
-* --compile
-  Perform a full catalog compilation prior to the lookup. This is meaningful when
-  the catalog changes global variables that are referenced in interpolated values.
-  No catalog compilation takes place unless this flag is given.
-* --render-as s|json|yaml|binary|msgpack
-  Determines how the results will be rendered to the standard output where
-  s means plain text. The default when lookup is producing a value is yaml
-  and the default when producing an explanation is s.
-EXAMPLE
--------
-  If you wanted to lookup 'key_name' within the scope of the master, you would
-  call lookup like this:
-  $ puppet lookup key_name
-  If you wanted to lookup 'key_name' within the scope of the agent.local node,
-  you would call lookup like this:
-  $ puppet lookup --node agent.local key_name
-  If you wanted to get the first value found for 'key_name_one' and 'key_name_two'
-  within the scope of the agent.local node while merging values and knocking out
-  the prefix 'foo' while merging, you would call lookup like this:
-  $ puppet lookup --node agent.local --merge deep --knock-out-prefix foo key_name_one key_name_two
-  If you wanted to lookup 'key_name' within the scope of the agent.local node,
-  and return a default value of 'bar' if nothing was found, you would call
-  lookup like this:
-  $ puppet lookup --node agent.local --default bar key_name
-  If you wanted to see an explanation of how the value for 'key_name' would be
-  obtained in the context of the agent.local node, you would call lookup like this:
-  $ puppet lookup --node agent.local --explain key_name
-COPYRIGHT
----------
-Copyright (c) 2015 Puppet Labs, LLC Licensed under the Apache 2.0 License
-    HELP
-  end
-  def main
-    keys = command_line.args
-    #unless options[:node]
-    #  raise "No node was given via the '--node' flag for the scope of the lookup.\n#{RUN_HELP}"
-    #end
-    if (options[:sort_merge_arrays] || options[:merge_hash_arrays] || options[:prefix]) && options[:merge] != 'deep'
-      raise "The options #{DEEP_MERGE_OPTIONS} are only available with '--merge deep'\n#{RUN_HELP}"
-    end
-    use_default_value = !options[:default_value].nil?
-    merge_options = nil
-    merge = options[:merge]
-    unless merge.nil?
-      strategies = Puppet::Pops::MergeStrategy.strategy_keys
-      unless strategies.include?(merge.to_sym)
-        strategies = strategies.map {|k| "'#{k}'"}
-        raise "The --merge option only accepts #{strategies[0...-1].join(', ')}, or #{strategies.last}\n#{RUN_HELP}"
-      end
-      if merge == 'deep'
-        merge_options = {'strategy' => 'deep',
-          'sort_merge_arrays' => !options[:sort_merge_arrays].nil?,
-          'merge_hash_arrays' => !options[:merge_hash_arrays].nil?}
-        if options[:prefix]
-          merge_options.merge!({'knockout_prefix' => options[:prefix]})
-        end
-      else
-        merge_options = {'strategy' => merge}
-      end
-    end
-    explain_data = !!options[:explain]
-    explain_options = !!options[:explain_options]
-    only_explain_options = explain_options && !explain_data
-    if keys.empty?
-      if only_explain_options
-        # Explain lookup_options for lookup of an unqualified value.
-        keys = Puppet::Pops::Lookup::GLOBAL
-      else
-        raise 'No keys were given to lookup.'
-      end
-    end
-    explain = explain_data || explain_options
-    # Format defaults to text (:s) when producing an explanation and :yaml when producing the value
-    format = options[:render_as] || (explain ? :s : :yaml)
-    renderer = Puppet::Network::FormatHandler.format(format == :json ? :pson : format)
-    raise "Unknown rendering format '#{format}'" if renderer.nil?
-    generate_scope do |scope|
-      lookup_invocation = Puppet::Pops::Lookup::Invocation.new(scope, {}, {}, explain ? Puppet::Pops::Lookup::Explainer.new(explain_options, only_explain_options) : nil)
-      begin
-        type = options.include?(:type) ? Puppet::Pops::Types::TypeParser.new.parse(options[:type], scope) : nil
-        result = Puppet::Pops::Lookup.lookup(keys, type, options[:default_value], use_default_value, merge_options, lookup_invocation)
-        puts renderer.render(result) unless explain
-      rescue Puppet::DataBinding::LookupError
-        exit(1) unless explain
-      end
-      puts format == :s ? lookup_invocation.explainer.to_s : renderer.render(lookup_invocation.explainer.to_hash) if explain
-    end
-  end
-  def generate_scope
-    if options[:node]
-      node = options[:node]
-    else
-      node = Puppet[:node_name_value]
-      # If we want to lookup the node we are currently on
-      # we must returning these settings to their default values
-      Puppet.settings[:facts_terminus] = 'facter'
-      Puppet.settings[:node_cache_terminus] = nil
-    end
-    node = Puppet::Node.indirection.find(node) unless node.is_a?(Puppet::Node) # to allow unit tests to pass a node instance
-    fact_file = options[:fact_file]
-    if fact_file
-      original_facts = node.parameters
-      if fact_file.end_with?("json")
-        given_facts = JSON.parse(Puppet::FileSystem.read(fact_file, :encoding => 'utf-8'))
-      else
-        given_facts = YAML.load(Puppet::FileSystem.read(fact_file, :encoding => 'utf-8'))
-      end
-      unless given_facts.instance_of?(Hash)
-        raise "Incorrect formatted data in #{fact_file} given via the --facts flag"
-      end
-      node.parameters = original_facts.merge(given_facts)
-    end
-    Puppet[:code] = 'undef' unless options[:compile]
-    compiler = Puppet::Parser::Compiler.new(node)
-    compiler.compile { |catalog| yield(compiler.topscope); catalog }
-  end
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/application/man.rb DELETED

@@ -1,4 +0,0 @@
-require 'puppet/application/face_base'
-class Puppet::Application::Man < Puppet::Application::FaceBase
-end

data/vendor/gems/puppet-4.5.2/lib/puppet/application/master.rb DELETED

@@ -1,321 +0,0 @@
-require 'puppet/application'
-require 'puppet/daemon'
-require 'puppet/util/pidlock'
-class Puppet::Application::Master < Puppet::Application
-  run_mode :master
-  option("--debug", "-d")
-  option("--verbose", "-v")
-  # internal option, only to be used by ext/rack/config.ru
-  option("--rack")
-  option("--compile host",  "-c host") do |arg|
-    options[:node] = arg
-  end
-  option("--logdest DEST",  "-l DEST") do |arg|
-    handle_logdest_arg(arg)
-  end
-  option("--parseonly") do |args|
-    puts "--parseonly has been removed. Please use 'puppet parser validate <manifest>'"
-    exit 1
-  end
-  def help
-    <<-'HELP'
-puppet-master(8) -- The puppet master daemon
-========
-SYNOPSIS
---------
-The central puppet server. Functions as a certificate authority by
-default.
-USAGE
------
-puppet master [-D|--daemonize|--no-daemonize] [-d|--debug] [-h|--help]
-  [-l|--logdest syslog|<FILE>|console] [-v|--verbose] [-V|--version]
-  [--compile <NODE-NAME>]
-DESCRIPTION
------------
-This command starts an instance of puppet master, running as a daemon
-and using Ruby's built-in Webrick webserver. Puppet master can also be
-managed by other application servers; when this is the case, this
-executable is not used.
-OPTIONS
--------
-Note that any Puppet setting that's valid in the configuration file is also a
-valid long argument. For example, 'server' is a valid setting, so you can
-specify '--server <servername>' as an argument. Boolean settings translate into
-'--setting' and '--no-setting' pairs.
-See the configuration file documentation at
-https://docs.puppetlabs.com/puppet/latest/reference/configuration.html for the
-full list of acceptable settings. A commented list of all settings can also be
-generated by running puppet master with '--genconfig'.
-* --daemonize:
-  Send the process into the background. This is the default.
-  (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-'
-  prefix for boolean settings on the command line.)
-* --no-daemonize:
-  Do not send the process into the background.
-  (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-'
-  prefix for boolean settings on the command line.)
-* --debug:
-  Enable full debugging.
-* --help:
-  Print this help message.
-* --logdest:
-  Where to send log messages. Choose between 'syslog' (the POSIX syslog
-  service), 'console', or the path to a log file. If debugging or verbosity is
-  enabled, this defaults to 'console'. Otherwise, it defaults to 'syslog'.
-  A path ending with '.json' will receive structured output in JSON format. The
-  log file will not have an ending ']' automatically written to it due to the
-  appending nature of logging. It must be appended manually to make the content
-  valid JSON.
-* --masterport:
-  The port on which to listen for traffic. The default port is 8140.
-  (This is a Puppet setting, and can go in puppet.conf.)
-* --verbose:
-  Enable verbosity.
-* --version:
-  Print the puppet version number and exit.
-* --compile:
-  Compile a catalogue and output it in JSON from the puppet master. Uses
-  facts contained in the $vardir/yaml/ directory to compile the catalog.
-EXAMPLE
--------
-  puppet master
-DIAGNOSTICS
------------
-When running as a standalone daemon, puppet master accepts the
-following signals:
-* SIGHUP:
-  Restart the puppet master server.
-* SIGINT and SIGTERM:
-  Shut down the puppet master server.
-* SIGUSR2:
-  Close file descriptors for log files and reopen them. Used with logrotate.
-AUTHOR
-------
-Luke Kanies
-COPYRIGHT
----------
-Copyright (c) 2012 Puppet Labs, LLC Licensed under the Apache 2.0 License
-    HELP
-  end
-  # Sets up the 'node_cache_terminus' default to use the Write Only Yaml terminus :write_only_yaml.
-  # If this is not wanted, the setting ´node_cache_terminus´ should be set to nil.
-  # @see Puppet::Node::WriteOnlyYaml
-  # @see #setup_node_cache
-  # @see puppet issue 16753
-  #
-  def app_defaults
-    super.merge({
-      :node_cache_terminus => :write_only_yaml,
-      :facts_terminus => 'yaml'
-    })
-  end
-  def preinit
-    Signal.trap(:INT) do
-      $stderr.puts "Canceling startup"
-      exit(0)
-    end
-    # save ARGV to protect us from it being smashed later by something
-    @argv = ARGV.dup
-  end
-  def run_command
-    if options[:node]
-      compile
-    else
-      main
-    end
-  end
-  def compile
-    begin
-      unless catalog = Puppet::Resource::Catalog.indirection.find(options[:node])
-        raise "Could not compile catalog for #{options[:node]}"
-      end
-      puts PSON::pretty_generate(catalog.to_resource, :allow_nan => true, :max_nesting => false)
-    rescue => detail
-      Puppet.log_exception(detail, "Failed to compile catalog for node #{options[:node]}: #{detail}")
-      exit(30)
-    end
-    exit(0)
-  end
-  def main
-    require 'etc'
-    # Make sure we've got a localhost ssl cert
-    Puppet::SSL::Host.localhost
-    # And now configure our server to *only* hit the CA for data, because that's
-    # all it will have write access to.
-    Puppet::SSL::Host.ca_location = :only if Puppet::SSL::CertificateAuthority.ca?
-    if Puppet.features.root?
-      if Puppet::Type.type(:user).new(:name => Puppet[:user]).exists?
-        begin
-          Puppet::Util.chuser
-        rescue => detail
-          Puppet.log_exception(detail, "Could not change user to #{Puppet[:user]}: #{detail}")
-          exit(39)
-        end
-      else
-        Puppet.err("Could not change user to #{Puppet[:user]}. User does not exist and is required to continue.")
-        exit(74)
-      end
-    end
-    if options[:rack]
-      Puppet.deprecation_warning("The Rack Puppet master server is deprecated and will be removed in a future release. Please use Puppet Server instead. See http://links.puppetlabs.com/deprecate-rack-webrick-servers for more information.")
-      start_rack_master
-    else
-      Puppet.deprecation_warning("The WEBrick Puppet master server is deprecated and will be removed in a future release. Please use Puppet Server instead. See http://links.puppetlabs.com/deprecate-rack-webrick-servers for more information.")
-      start_webrick_master
-    end
-  end
-  def setup_logs
-    set_log_level
-    if !options[:setdest]
-      if options[:node]
-        # We are compiling a catalog for a single node with '--compile' and logging
-        # has not already been configured via '--logdest' so log to the console.
-        Puppet::Util::Log.newdestination(:console)
-      elsif !(Puppet[:daemonize] or options[:rack])
-        # We are running a webrick master which has been explicitly foregrounded
-        # and '--logdest' has not been passed, assume users want to see logging
-        # and log to the console.
-        Puppet::Util::Log.newdestination(:console)
-      else
-        # No explicit log destination has been given with '--logdest' and we're
-        # either a daemonized webrick master or running under rack, log to syslog.
-        Puppet::Util::Log.newdestination(:syslog)
-      end
-    end
-  end
-  def setup_terminuses
-    require 'puppet/file_serving/content'
-    require 'puppet/file_serving/metadata'
-    Puppet::FileServing::Content.indirection.terminus_class = :file_server
-    Puppet::FileServing::Metadata.indirection.terminus_class = :file_server
-    Puppet::FileBucket::File.indirection.terminus_class = :file
-  end
-  def setup_ssl
-    # Configure all of the SSL stuff.
-    if Puppet::SSL::CertificateAuthority.ca?
-      Puppet::SSL::Host.ca_location = :local
-      Puppet.settings.use :ca
-      Puppet::SSL::CertificateAuthority.instance
-    else
-      Puppet::SSL::Host.ca_location = :none
-    end
-    Puppet::SSL::Oids.register_puppet_oids
-    Puppet::SSL::Oids.load_custom_oid_file(Puppet[:trusted_oid_mapping_file])
-  end
-  # Sets up a special node cache "write only yaml" that collects and stores node data in yaml
-  # but never finds or reads anything (this since a real cache causes stale data to be served
-  # in circumstances when the cache can not be cleared).
-  # @see puppet issue 16753
-  # @see Puppet::Node::WriteOnlyYaml
-  # @return [void]
-  def setup_node_cache
-    Puppet::Node.indirection.cache_class = Puppet[:node_cache_terminus]
-  end
-  def setup
-    raise Puppet::Error.new("Puppet master is not supported on Microsoft Windows") if Puppet.features.microsoft_windows?
-    setup_logs
-    exit(Puppet.settings.print_configs ? 0 : 1) if Puppet.settings.print_configs?
-    Puppet.settings.use :main, :master, :ssl, :metrics
-    setup_terminuses
-    setup_node_cache
-    setup_ssl
-  end
-  private
-  # Start a master that will be using WeBrick.
-  #
-  # This method will block until the master exits.
-  def start_webrick_master
-    require 'puppet/network/server'
-    daemon = Puppet::Daemon.new(Puppet::Util::Pidlock.new(Puppet[:pidfile]))
-    daemon.argv = @argv
-    daemon.server = Puppet::Network::Server.new(Puppet[:bindaddress], Puppet[:masterport])
-    daemon.daemonize if Puppet[:daemonize]
-    # Setup signal traps immediately after daemonization so we clean up the daemon
-    daemon.set_signal_traps
-    announce_start_of_master
-    daemon.start
-  end
-  # Start a master that will be used for a Rack container.
-  #
-  # This method immediately returns the Rack handler that must be returned to
-  # the calling Rack container
-  def start_rack_master
-    require 'puppet/network/http/rack'
-    announce_start_of_master
-    return Puppet::Network::HTTP::Rack.new()
-  end
-  def announce_start_of_master
-    Puppet.notice "Starting Puppet master version #{Puppet.version}"
-  end
-end