puppet 3.8.7 → 4.0.0

data/lib/puppet/face/instrumentation_listener.rb

@@ -1,98 +0,0 @@
-require 'puppet/indirector/face'
-require 'puppet/util/instrumentation/listener'
-
-Puppet::Indirector::Face.define(:instrumentation_listener, '0.0.1') do
-  copyright "Puppet Labs", 2011
-  license   "Apache 2 license; see COPYING"
-
-  summary "Manage instrumentation listeners. DEPRECATED."
-  description <<-EOT
-    This subcommand enables/disables or list instrumentation listeners.
-    (DEPRECATED) This subcommand will be removed in Puppet 4.0.
-  EOT
-
-  get_action(:destroy).summary "Invalid for this subcommand."
-
-  find = get_action(:find)
-  find.summary "Retrieve a single listener."
-  find.render_as = :pson
-  find.returns <<-EOT
-    The status of an instrumentation listener
-  EOT
-  find.examples <<-EOT
-    Retrieve a given listener:
-
-    $ puppet instrumentation_listener find performance --terminus rest
-  EOT
-
-  search = get_action(:search)
-  search.summary "Retrieve all instrumentation listeners statuses."
-  search.arguments "<dummy_text>"
-  search.render_as = :pson
-  search.returns <<-EOT
-    The statuses of all instrumentation listeners
-  EOT
-  search.short_description <<-EOT
-    This retrieves all instrumentation listeners
-  EOT
-  search.notes <<-EOT
-    Although this action always returns all instrumentation listeners, it requires a dummy search
-    key; this is a known bug.
-  EOT
-  search.examples <<-EOT
-    Retrieve the state of the listeners running in the remote puppet master:
-
-    $ puppet instrumentation_listener search x --terminus rest
-  EOT
-
-  def manage(name, activate)
-    Puppet::Util::Instrumentation::Listener.indirection.terminus_class = :rest
-    listener = Puppet::Face[:instrumentation_listener, '0.0.1'].find(name)
-    if listener
-      listener.enabled = activate
-      Puppet::Face[:instrumentation_listener, '0.0.1'].save(listener)
-    end
-  end
-
-  action :enable do
-    summary "Enable a given instrumentation listener."
-    arguments "<listener>"
-    returns "Nothing."
-    description <<-EOT
-      Enable a given instrumentation listener. After being enabled the listener
-      will start receiving instrumentation notifications from the probes if those
-      are enabled.
-    EOT
-    examples <<-EOT
-      Enable the "performance" listener in the running master:
-
-      $ puppet instrumentation_listener enable performance --terminus rest
-    EOT
-
-    when_invoked do |name, options|
-      manage(name, true)
-    end
-  end
-
-  action :disable do
-    summary "Disable a given instrumentation listener."
-    arguments "<listener>"
-    returns "Nothing."
-    description <<-EOT
-      Disable a given instrumentation listener. After being disabled the listener
-      will stop receiving instrumentation notifications from the probes.
-    EOT
-    examples <<-EOT
-      Disable the "performance" listener in the running master:
-
-      $ puppet instrumentation_listener disable performance --terminus rest
-    EOT
-
-    when_invoked do |name, options|
-      manage(name, false)
-    end
-  end
-
-  get_action(:save).summary "API only: modify an instrumentation listener status."
-  get_action(:save).arguments "<listener>"
-end

data/lib/puppet/face/instrumentation_probe.rb

@@ -1,79 +0,0 @@
-require 'puppet/indirector/face'
-require 'puppet/util/instrumentation/indirection_probe'
-
-Puppet::Indirector::Face.define(:instrumentation_probe, '0.0.1') do
-  copyright "Puppet Labs", 2011
-  license   "Apache 2 license; see COPYING"
-
-  summary "Manage instrumentation probes. Deprecated"
-  description <<-EOT
-    This subcommand enables/disables or list instrumentation listeners.
-    (DEPRECATED) This subcommand will be removed in Puppet 4.0.
-  EOT
-
-  get_action(:find).summary "Invalid for this subcommand."
-
-  search = get_action(:search)
-  search.summary "Retrieve all probe statuses."
-  search.arguments "<dummy_text>"
-  search.render_as = :pson
-  search.returns <<-EOT
-    The statuses of all instrumentation probes
-  EOT
-  search.short_description <<-EOT
-    This retrieves all instrumentation probes
-  EOT
-  search.notes <<-EOT
-    Although this action always returns all instrumentation probes, it requires a dummy search
-    key; this is a known bug.
-  EOT
-  search.examples <<-EOT
-    Retrieve the state of the probes running in the remote puppet master:
-
-    $ puppet instrumentation_probe search x --terminus rest
-  EOT
-
-  action :enable do
-    summary "Enable all instrumentation probes."
-    arguments "<dummy>"
-    returns "Nothing."
-    description <<-EOT
-      Enable all instrumentation probes. After being enabled, all enabled listeners
-      will start receiving instrumentation notifications from the probes.
-    EOT
-    examples <<-EOT
-      Enable the probes for the running master:
-
-      $ puppet instrumentation_probe enable x --terminus rest
-    EOT
-
-    when_invoked do |name, options|
-      Puppet::Face[:instrumentation_probe, '0.0.1'].save(nil)
-    end
-  end
-
-  action :disable do
-    summary "Disable all instrumentation probes."
-    arguments "<dummy>"
-    returns "Nothing."
-    description <<-EOT
-      Disable all instrumentation probes. After being disabled, no listeners
-      will receive instrumentation notifications.
-    EOT
-    examples <<-EOT
-      Disable the probes for the running master:
-
-      $ puppet instrumentation_probe disable x --terminus rest
-    EOT
-
-    when_invoked do |name, options|
-      Puppet::Face[:instrumentation_probe, '0.0.1'].destroy(nil)
-    end
-  end
-
-  get_action(:save).summary "API only: enable all instrumentation probes."
-  get_action(:save).arguments "<dummy>"
-
-  get_action(:destroy).summary "API only: disable all instrumentation probes."
-  get_action(:destroy).arguments "<dummy>"
-end

data/lib/puppet/face/secret_agent.rb

@@ -1,54 +0,0 @@
-require 'puppet/face'
-
-Puppet::Face.define(:secret_agent, '0.0.1') do
-  copyright "Puppet Labs", 2011
-  license   "Apache 2 license; see COPYING"
-
-  summary "Mimics puppet agent."
-  description <<-'EOT'
-    This subcommand currently functions as a proof of concept, demonstrating how
-    the Faces API exposes Puppet's internal systems to application logic;
-    compare the actual code for puppet agent. It will eventually replace puppet
-    agent entirely, and can provide a template for users who wish to implement
-    agent-like functionality with non-standard application logic.
-  EOT
-
-  action(:synchronize) do
-    default
-    summary "Run secret_agent once."
-    description <<-'EOT'
-      Mimics a single run of puppet agent. This action does not currently
-      daemonize, but can download plugins, submit facts, retrieve and apply a
-      catalog, and submit a report to the puppet master.
-    EOT
-    returns <<-'EOT'
-      Verbose logging from the completed run. When used from the Ruby API:
-      returns a Puppet::Transaction::Report object.
-    EOT
-    examples <<-'EOT'
-      Trigger a Puppet run with the configured puppet master:
-
-      $ puppet secret_agent
-    EOT
-    notes <<-'EOT'
-      This action requires that the puppet master's `auth.conf` file allow save
-      access to the `facts` REST terminus. Puppet agent does not use this
-      facility, and it is turned off by default. See
-      <http://docs.puppetlabs.com/guides/rest_auth_conf.html> for more details.
-    EOT
-
-    when_invoked do |options|
-      Puppet::Face[:plugin, '0.0.1'].download
-
-      Puppet::Face[:facts, '0.0.1'].upload
-
-      Puppet::Face[:catalog, '0.0.1'].download
-
-      report  = Puppet::Face[:catalog, '0.0.1'].apply
-
-      Puppet::Face[:report, '0.0.1'].submit(report)
-
-      return report
-    end
-  end
-end

data/lib/puppet/feature/pson.rb

@@ -1,4 +0,0 @@
-Puppet.features.add(:pson) do
-  Puppet.deprecation_warning "There is no need to check for pson support. It is always available."
-  true
-end

data/lib/puppet/feature/rails.rb

@@ -1,47 +0,0 @@
-require 'puppet/util/feature'
-
-Puppet.features.add(:rails) do
-  begin
-    # Turn off the constant watching parts of ActiveSupport, which have a huge
-    # cost in terms of the system watching loaded code to figure out if it was
-    # a missing content, and which we don't actually *use* anywhere.
-    #
-    # In fact, we *can't* depend on the feature: we don't require
-    # ActiveSupport, just load it if we use rails, if we depend on a feature
-    # that it offers. --daniel 2012-07-16
-    require 'active_support'
-    begin
-      require 'active_support/dependencies'
-      ActiveSupport::Dependencies.unhook!
-      ActiveSupport::Dependencies.mechanism = :require
-    rescue LoadError, ScriptError, StandardError => e
-      # ignore any failure - worst case we run without disabling the CPU
-      # sucking features, so are slower but ... not actually failed, just
-      # because some random future version of ActiveRecord changes.
-      Puppet.debug("disabling ActiveSupport::Dependencies failed: #{e}")
-    end
-
-    require 'active_record'
-    require 'active_record/version'
-  rescue LoadError
-    if Puppet::FileSystem.exist?("/usr/share/rails")
-      count = 0
-      Dir.entries("/usr/share/rails").each do |dir|
-        libdir = File.join("/usr/share/rails", dir, "lib")
-        if Puppet::FileSystem.exist?(libdir) and ! $LOAD_PATH.include?(libdir)
-          count += 1
-          $LOAD_PATH << libdir
-        end
-      end
-
-      retry if count > 0
-    end
-  end
-
-  unless (Puppet::Util.activerecord_version >= 2.1)
-    Puppet.info "ActiveRecord 2.1 or later required for StoreConfigs"
-    false
-  else
-    true
-  end
-end

data/lib/puppet/feature/rdoc1.rb

@@ -1,16 +0,0 @@
-require 'puppet/util/feature'
-
-# We have a version of RDoc compatible with our module documentation tool.
-# That is to say, we have the version that comes with Ruby 1.8.7 and earlier,
-# and not the version that comes with Ruby 1.9.1 or later.
-#
-# 1.8 => require 'rdoc/rdoc'; p RDoc::RDoc::VERSION_STRING
-#        => "RDoc V1.0.1 - 20041108"
-# 1.9 => require 'rdoc'; p RDoc::VERSION
-#        => "3.9.4"  # 1.9.2 has 2.5, 1.9.3 has 3.9
-#
-# Anything above that whole 1.0.1 thing is no good for us, and since that
-# ships with anything in the 1.8 series that we care about (eg: .5, ,7) we can
-# totally just use that as a proxy for the correct version of rdoc being
-# available. --daniel 2012-03-08
-Puppet.features.add(:rdoc1) { RUBY_VERSION[0,3] == "1.8" }

data/lib/puppet/feature/rubygems.rb

@@ -1,7 +0,0 @@
-require 'puppet/util/feature'
-
-Puppet.features.add(:rubygems) do
-  Puppet.deprecation_warning "Puppet.features.rubygems? is deprecated. Require rubygems in your application's entry point if you need it."
-
-  require 'rubygems'
-end

data/lib/puppet/feature/stomp.rb

@@ -1,5 +0,0 @@
-require 'puppet/util/feature'
-
-# We want this to load if possible, but it's not automatically
-# required.
-Puppet.features.add(:stomp, :libs => %{stomp})

data/lib/puppet/file_collection/lookup.rb

@@ -1,10 +0,0 @@
-require 'puppet/file_collection'
-
-module Puppet::FileCollection::Lookup
-  # Yeah, this is all the external interface that was added to the folks who
-  # included this really was.  Thankfully.
-  #
-  # See the comments in `puppet/file_collection.rb` for the annotated version,
-  # or just port your code away from this by adding the accessors on your own.
-  attr_accessor :line, :file
-end

data/lib/puppet/file_collection.rb

@@ -1,19 +0,0 @@
-# This was a simple way to turn file names into singletons,
-#
-# The theory was, like:
-# 1. Turn filenames into singletons.
-# 2. ????
-# 3. Huge memory savings!
-#
-# In practice it used several MB more memory overall, and it cost more CPU
-# time, and it added complexity to the code.  Which was awesome.
-#
-# So, I gutted it.  It doesn't do anything any more, but we retain the
-# external form that people included so that they don't explode so much.
-#
-# This should be removed from the system after a graceful deprecation period,
-# probably about the time that a version of Puppet containing this change is
-# the last supported version. --daniel 2012-07-17
-class Puppet::FileCollection
-  require 'puppet/file_collection/lookup'
-end

data/lib/puppet/file_system/file18.rb

@@ -1,5 +0,0 @@
-class Puppet::FileSystem::File18 < Puppet::FileSystem::FileImpl
-  def binread(path)
-    ::File.open(path, 'rb') { |f| f.read }
-  end
-end

data/lib/puppet/functions/defined.rb

@@ -1,130 +0,0 @@
-# Determines whether
-# a given class or resource type is defined. This function can also determine whether a
-# specific resource has been declared, or whether a variable has been assigned a value
-# (including undef...as opposed to never having been assigned anything). Returns true
-# or false. Accepts class names, type names, resource references, and variable
-# reference strings of the form '$name'.  When more than one argument is
-# supplied, defined() returns true if any are defined.
-#
-# The `defined` function checks both native and defined types, including types
-# provided as plugins via modules. Types and classes are both checked using their names:
-#
-#     defined("file")
-#     defined("customtype")
-#     defined("foo")
-#     defined("foo::bar")
-#     defined('$name')
-#
-# Resource declarations are checked using resource references, e.g.
-# `defined( File['/tmp/myfile'] )`, or `defined( Class[myclass] )`.
-# Checking whether a given resource
-# has been declared is, unfortunately, dependent on the evaluation order of
-# the configuration, and the following code will not work:
-#
-#     if defined(File['/tmp/foo']) {
-#         notify { "This configuration includes the /tmp/foo file.":}
-#     }
-#     file { "/tmp/foo":
-#         ensure => present,
-#     }
-#
-# However, this order requirement refers to evaluation order only, and ordering of
-# resources in the configuration graph (e.g. with `before` or `require`) does not
-# affect the behavior of `defined`.
-#
-# You may also search using types:
-#
-#     defined(Resource['file','/some/file'])
-#     defined(File['/some/file'])
-#     defined(Class['foo'])
-#
-# The `defined` function does not answer if data types (e.g. `Integer`) are defined. If
-# given the string 'integer' the result is false, and if given a non CatalogEntry type,
-# an error is raised.
-#
-# The rules for asking for undef, empty strings, and the main class are different from 3.x
-# (non future parser) and 4.x (with future parser or in Puppet 4.0.0 and later):
-#
-#     defined('')     # 3.x => true,  4.x => false
-#     defined(undef)  # 3.x => true,  4.x => error
-#     defined('main') # 3.x => false, 4.x => true
-#
-# With the future parser, it is also possible to ask specifically if a name is
-# a resource type (built in or defined), or a class, by giving its type:
-#
-#     defined(Type[Class['foo']])
-#     defined(Type[Resource['foo']])
-#
-# Which is different from asking:
-#
-#     defined('foo')
-#
-# Since the later returns true if 'foo' is either a class, a built-in resource type, or a user defined
-# resource type, and a specific request like `Type[Class['foo']]` only returns true if `'foo'` is a class.
-#
-# @since 2.7.0
-# @since 3.6.0 variable reference and future parser types")
-# @since 3.8.1 type specific requests with future parser
-#
-Puppet::Functions.create_function(:'defined', Puppet::Functions::InternalFunction) do
-
-  dispatch :is_defined do
-    scope_param
-    required_repeated_param 'Variant[String, Type[CatalogEntry], Type[Type[CatalogEntry]]]', :vals
-  end
-
-  def is_defined(scope, *vals)
-    vals.any? do |val|
-      case val
-      when String
-        if val =~ /^\$(.+)$/
-          scope.exist?($1)
-        else
-          case val
-          when ''
-            next nil
-          when 'main'
-            # Find the main class (known as ''), it does not have to be in the catalog
-            scope.find_hostclass('')
-          else
-            # Find a resource type, definition or class definition
-            scope.find_resource_type(val) || scope.find_definition(val) || scope.find_hostclass(val)
-            #scope.compiler.findresource(:class, val)
-          end
-        end
-      when Puppet::Resource
-        # Find instance of given resource type and title that is in the catalog
-        scope.compiler.findresource(val.type, val.title)
-
-      when Puppet::Pops::Types::PResourceType
-        raise ArgumentError, 'The given resource type is a reference to all kind of types' if val.type_name.nil?
-        if val.title.nil?
-          scope.find_builtin_resource_type(val.type_name) || scope.find_definition(val.type_name)
-        else
-          scope.compiler.findresource(val.type_name, val.title)
-        end
-
-      when Puppet::Pops::Types::PHostClassType
-        raise  ArgumentError, 'The given class type is a reference to all classes' if val.class_name.nil?
-        scope.compiler.findresource(:class, val.class_name)
-
-      when Puppet::Pops::Types::PType
-        case val.type
-        when Puppet::Pops::Types::PResourceType
-          # It is most reasonable to take Type[File] and Type[File[foo]] to mean the same as if not wrapped in a Type
-          # Since the difference between File and File[foo] already captures the distinction of type vs instance.
-          is_defined(scope, val.type)
-
-        when Puppet::Pops::Types::PHostClassType
-          # Interpreted as asking if a class (and nothing else) is defined without having to be included in the catalog
-          # (this is the same as asking for just the class' name, but with the added certainty that it cannot be a defined type.
-          #
-          raise  ArgumentError, 'The given class type is a reference to all classes' if val.type.class_name.nil?
-          scope.find_hostclass(val.type.class_name)
-        end
-      else
-        raise ArgumentError, "Invalid argument of type '#{val.class}' to 'defined'"
-      end
-    end
-  end
-end

data/lib/puppet/indirector/active_record.rb

@@ -1,29 +0,0 @@
-require 'puppet/rails'
-require 'puppet/indirector'
-
-class Puppet::Indirector::ActiveRecord < Puppet::Indirector::Terminus
-  class << self
-    attr_accessor :ar_model
-  end
-
-  def self.use_ar_model(klass)
-    self.ar_model = klass
-  end
-
-  def ar_model
-    self.class.ar_model
-  end
-
-  def initialize
-    Puppet::Rails.init
-  end
-
-  def find(request)
-    return nil unless instance = ar_model.find_by_name(request.key)
-    instance.to_puppet
-  end
-
-  def save(request)
-    ar_model.from_puppet(request.instance).save
-  end
-end

data/lib/puppet/indirector/catalog/active_record.rb

@@ -1,39 +0,0 @@
-require 'puppet/rails/host'
-require 'puppet/indirector/active_record'
-require 'puppet/resource/catalog'
-
-class Puppet::Resource::Catalog::ActiveRecord < Puppet::Indirector::ActiveRecord
-  use_ar_model Puppet::Rails::Host
-
-  desc "A component of ActiveRecord storeconfigs. ActiveRecord-based storeconfigs
-    and inventory are deprecated. See http://links.puppetlabs.com/activerecord-deprecation"
-
-  def initialize
-    Puppet.deprecation_warning "ActiveRecord-based storeconfigs and inventory are deprecated. See http://links.puppetlabs.com/activerecord-deprecation"
-    super
-  end
-
-  # We don't retrieve catalogs from storeconfigs
-  def find(request)
-    nil
-  end
-
-  # Save the values from a Facts instance as the facts on a Rails Host instance.
-  def save(request)
-    catalog = request.instance
-
-    host = ar_model.find_by_name(catalog.name) || ar_model.create(:name => catalog.name)
-
-    host.railsmark "Saved catalog to database" do
-      host.merge_resources(catalog.vertices)
-      host.last_compile = Time.now
-
-      if node = Puppet::Node.indirection.find(catalog.name)
-        host.ip = node.parameters["ipaddress"]
-        host.environment = node.environment.to_s
-      end
-
-      host.save
-    end
-  end
-end

data/lib/puppet/indirector/catalog/queue.rb

@@ -1,9 +0,0 @@
-require 'puppet/resource/catalog'
-require 'puppet/indirector/queue'
-
-class Puppet::Resource::Catalog::Queue < Puppet::Indirector::Queue
-
-  desc "Part of async storeconfigs, requiring the puppet queue daemon. ActiveRecord-based storeconfigs
-    and inventory are deprecated. See http://links.puppetlabs.com/activerecord-deprecation"
-
-end

data/lib/puppet/indirector/couch.rb

@@ -1,78 +0,0 @@
-class Puppet::Indirector::Couch < Puppet::Indirector::Terminus
-
-  # The CouchRest database instance. One database instance per Puppet runtime
-  # should be sufficient.
-  #
-  def self.db; @db ||= CouchRest.database! Puppet[:couchdb_url] end
-  def db; self.class.db end
-
-  def find(request)
-    attributes_of get(request)
-  end
-
-  def initialize(*args)
-    raise "Couch terminus not supported without couchrest gem" unless Puppet.features.couchdb?
-    super
-  end
-
-  # Create or update the couchdb document with the request's data hash.
-  #
-  def save(request)
-    raise ArgumentError, "PUT does not accept options" unless request.options.empty?
-    update(request) || create(request)
-  end
-
-  private
-
-  # RKH:TODO: Do not depend on error handling, check if the document exists
-  # first. (Does couchrest support this?)
-  #
-  def get(request)
-    db.get(id_for(request))
-  rescue RestClient::ResourceNotFound
-    Puppet.debug "No couchdb document with id: #{id_for(request)}"
-    return nil
-  end
-
-  def update(request)
-    doc = get request
-    return unless doc
-    doc.merge!(hash_from(request))
-    doc.save
-    true
-  end
-
-  def create(request)
-    db.save_doc hash_from(request)
-  end
-
-  # The attributes hash that is serialized to CouchDB as JSON. It includes
-  # metadata that is used to help aggregate data in couchdb. Add
-  # model-specific attributes in subclasses.
-  #
-  def hash_from(request)
-    {
-      "_id"         => id_for(request),
-      "puppet_type" => document_type_for(request)
-    }
-  end
-
-  # The couchdb response stripped of metadata, used to instantiate the model
-  # instance that is returned by save.
-  #
-  def attributes_of(response)
-    response && response.reject{|k,v| k =~ /^(_rev|puppet_)/ }
-  end
-
-  def document_type_for(request)
-    request.indirection_name
-  end
-
-  # The id used to store the object in couchdb. Implemented in subclasses.
-  #
-  def id_for(request)
-    raise NotImplementedError
-  end
-
-end
-