puppet 5.3.7 → 5.4.0

data/lib/puppet/bindings.rb

@@ -1,148 +0,0 @@
-# This class allows registration of named bindings that are later contributed to a layer via
-# a binding scheme.
-#
-# The intended use is for a .rb file to be placed in confdir's or module's `lib/bindings` directory structure, with a
-# name corresponding to the symbolic bindings name.
-#
-# Here are two equivalent examples, the first using chained methods (which is compact for simple cases), and the
-# second which uses a block.
-#
-# @example MyModule's lib/bindings/mymodule/default.rb
-#   Puppet::Bindings.newbindings('mymodule::default') do
-#     bind.integer.named('meaning of life').to(42)
-#   end
-#
-# @example Using blocks
-#   Puppet::Bindings.newbindings('mymodule::default') do
-#     bind do
-#       integer
-#       name 'meaning of life'
-#       to 42
-#     end
-#   end
-#
-# If access is needed to the scope, this can be declared as a block parameter.
-# @example MyModule's lib/bindings/mymodule/default.rb with scope
-#   Puppet::Bindings.newbindings('mymodule::default') do |scope|
-#     bind.integer.named('meaning of life').to("#{scope['::fqdn']} also think it is 42")
-#   end
-#
-# If late evaluation is wanted, this can be achieved by binding a puppet expression.
-# @example binding a puppet expression
-#   Puppet::Bindings.newbindings('mymodule::default') do |scope|
-#     bind.integer.named('meaning of life').to(puppet_string("${::fqdn} also think it is 42")
-#   end
-#
-# It is allowed to define methods in the block given to `newbindings`, these can be used when
-# producing bindings. (Care should naturally be taken to not override any of the already defined methods).
-# @example defining method to be used while creating bindings
-#   Puppet::Bindings.newbindings('mymodule::default') do
-#     def square(x)
-#       x * x
-#     end
-#     bind.integer.named('meaning of life squared').to(square(42))
-#   end
-#
-# For all details see {Puppet::Pops::Binder::BindingsFactory}, which is used behind the scenes.
-# @api public
-#
-class Puppet::Bindings
-  extend Enumerable
-
-  Environment = Puppet::Node::Environment
-
-  # Constructs and registers a {Puppet::Pops::Binder::Bindings::NamedBindings NamedBindings} that later can be contributed
-  # to a bindings layer in a bindings configuration via a URI. The name is symbolic, fully qualified with module name, and at least one
-  # more qualifying name (where the name `default` is used in the default bindings configuration.
-  #
-  # The given block is called with a `self` bound to an instance of {Puppet::Pops::Binder::BindingsFactory::BindingsContainerBuilder}
-  # which most notably has a `#bind` method which it turn calls a block bound to an instance of
-  # {Puppet::Pops::Binder::BindingsFactory::BindingsBuilder}.
-  # Depending on the use-case a direct chaining method calls or nested blocks may be used.
-  #
-  # @example simple bindings
-  #   Puppet::Bindings.newbindings('mymodule::default') do
-  #     bind.name('meaning of life').to(42)
-  #     bind.integer.named('port').to(8080)
-  #     bind.integer.named('apache::port').to(8080)
-  #   end
-  #
-  # The block form is more suitable for longer, more complex forms of bindings.
-  #
-  def self.newbindings(name, &block)
-    register_proc(name, block)
-  end
-
-  def self.register_proc(name, block)
-    adapter = NamedBindingsAdapter.adapt(Puppet.lookup(:current_environment))
-    adapter[name] = block
-  end
-
-  # Registers a named_binding under its name
-  # @param named_bindings [Puppet::Pops::Binder::Bindings::NamedBindings] The named bindings to register.
-  # @api public
-  #
-  def self.register(named_bindings)
-    adapter = NamedBindingsAdapter.adapt(Puppet.lookup(:current_environment))
-    adapter[named_bindings.name] = named_bindings
-  end
-
-  def self.resolve(scope, name)
-    entry = get(name)
-    return entry unless entry.is_a?(Proc)
-    named_bindings = Puppet::Pops::Binder::BindingsFactory.safe_named_bindings(name, scope, &entry).model
-    adapter = NamedBindingsAdapter.adapt(Puppet.lookup(:current_environment))
-    adapter[named_bindings.name] = named_bindings
-    named_bindings
-  end
-
-  # Returns the named bindings with the given name, or nil if no such bindings have been registered.
-  # @param name [String] The fully qualified name of a binding to get
-  # @return [Proc, Puppet::Pops::Binder::Bindings::NamedBindings] a Proc producing named bindings, or a named bindings directly
-  # @api public
-  #
-  def self.get(name)
-    adapter = NamedBindingsAdapter.adapt(Puppet.lookup(:current_environment))
-    adapter[name]
-  end
-
-  def self.[](name)
-    get(name)
-  end
-
-  # Supports Enumerable iteration (k,v) over the named bindings hash.
-  def self.each
-    adapter = NamedBindingsAdapter.adapt(Puppet.lookup(:current_environment))
-    adapter.each_pair {|k,v| yield k,v }
-  end
-
-  # A NamedBindingsAdapter holds a map of name to Puppet::Pops::Binder::Bindings::NamedBindings.
-  # It is intended to be used as an association between an Environment and named bindings.
-  #
-  class NamedBindingsAdapter < Puppet::Pops::Adaptable::Adapter
-    def initialize()
-      @named_bindings = {}
-    end
-
-    def [](name)
-      @named_bindings[name]
-    end
-
-    def has_name?(name)
-      @named_bindings.has_key?
-    end
-
-    def []=(name, value)
-      unless value.is_a?(Puppet::Pops::Binder::Bindings::NamedBindings) || value.is_a?(Proc)
-        #TRANSLATORS 'NameBindings' is a class name and should not be translated, 'Proc' refers to a Ruby proc.
-        raise ArgumentError, _("Given value must be a NamedBindings, or a Proc producing one, got: %{class_name}.") % { class_name: value.class }
-      end
-      @named_bindings[name] = value
-    end
-
-    def each_pair(&block)
-      @named_bindings.each_pair(&block)
-    end
-  end
-
-end

data/lib/puppet/configurer/downloader_factory.rb

@@ -1,44 +0,0 @@
-require 'puppet/configurer'
-
-# Factory for <tt>Puppet::Configurer::Downloader</tt> objects.
-#
-# Puppet's pluginsync facilities can be used to download modules
-# and external facts, each with a different destination directory
-# and related settings.
-#
-# @api private
-#
-class Puppet::Configurer::DownloaderFactory
-  def create_plugin_downloader(environment)
-    plugin_downloader = Puppet::Configurer::Downloader.new(
-      "plugin",
-      Puppet[:plugindest],
-      Puppet[:pluginsource],
-      Puppet[:pluginsignore],
-      environment
-    )
-  end
-
-  def create_plugin_facts_downloader(environment)
-    source_permissions = Puppet.features.microsoft_windows? ? :ignore : :use
-
-    plugin_fact_downloader = Puppet::Configurer::Downloader.new(
-      "pluginfacts",
-      Puppet[:pluginfactdest],
-      Puppet[:pluginfactsource],
-      Puppet[:pluginsignore],
-      environment,
-      source_permissions
-    )
-  end
-
-  def create_locales_downloader(environment)
-    locales_downloader = Puppet::Configurer::Downloader.new(
-      "locales",
-      Puppet[:localedest],
-      Puppet[:localesource],
-      Puppet[:pluginsignore] + " *.pot config.yaml",
-      environment
-    )
-  end
-end

data/spec/unit/configurer/downloader_factory_spec.rb

@@ -1,129 +0,0 @@
-#! /usr/bin/env ruby
-require 'spec_helper'
-require 'puppet/configurer'
-
-describe Puppet::Configurer::DownloaderFactory do
-  let(:factory)     { Puppet::Configurer::DownloaderFactory.new }
-  let(:environment) { Puppet::Node::Environment.create(:myenv, []) }
-
-  let(:plugin_downloader) do
-    factory.create_plugin_downloader(environment)
-  end
-
-  let(:facts_downloader) do
-    factory.create_plugin_facts_downloader(environment)
-  end
-
-  let(:locales_downloader) do
-    factory.create_locales_downloader(environment)
-  end
-
-  def ignores_source_permissions(downloader)
-    expect(downloader.file[:source_permissions]).to eq(:ignore)
-  end
-
-  def uses_source_permissions(downloader)
-    expect(downloader.file[:source_permissions]).to eq(:use)
-  end
-
-  context "when creating a plugin downloader for modules" do
-    it 'is named "plugin"' do
-      expect(plugin_downloader.name).to eq('plugin')
-    end
-
-    it 'downloads files into Puppet[:plugindest]' do
-      plugindest = File.expand_path("/tmp/pdest")
-      Puppet[:plugindest] = plugindest
-
-      expect(plugin_downloader.file[:path]).to eq(plugindest)
-    end
-
-    it 'downloads files from Puppet[:pluginsource]' do
-      Puppet[:pluginsource] = 'puppet:///myotherplugins'
-
-      expect(plugin_downloader.file[:source]).to eq([Puppet[:pluginsource]])
-    end
-
-    it 'ignores files from Puppet[:pluginsignore]' do
-      Puppet[:pluginsignore] = 'pignore'
-
-      expect(plugin_downloader.file[:ignore]).to eq(['pignore'])
-    end
-
-    it 'splits Puppet[:pluginsignore] on whitespace' do
-      Puppet[:pluginsignore] = ".svn CVS .git"
-
-      expect(plugin_downloader.file[:ignore]).to eq(%w[.svn CVS .git])
-    end
-
-    it "ignores source permissions" do
-      ignores_source_permissions(plugin_downloader)
-    end
-  end
-
-  context "when creating a plugin downloader for external facts" do
-    it 'is named "pluginfacts"' do
-      expect(facts_downloader.name).to eq('pluginfacts')
-    end
-
-    it 'downloads files into Puppet[:pluginfactdest]' do
-      plugindest = File.expand_path("/tmp/pdest")
-      Puppet[:pluginfactdest] = plugindest
-
-      expect(facts_downloader.file[:path]).to eq(plugindest)
-    end
-
-    it 'downloads files from Puppet[:pluginfactsource]' do
-      Puppet[:pluginfactsource] = 'puppet:///myotherfacts'
-
-      expect(facts_downloader.file[:source]).to eq([Puppet[:pluginfactsource]])
-    end
-
-    it 'ignores files from Puppet[:pluginsignore]' do
-      Puppet[:pluginsignore] = 'pignore'
-
-      expect(facts_downloader.file[:ignore]).to eq(['pignore'])
-    end
-
-    context "on POSIX", :if => Puppet.features.posix? do
-      it "uses source permissions" do
-        uses_source_permissions(facts_downloader)
-      end
-    end
-
-    context "on Windows", :if => Puppet.features.microsoft_windows? do
-      it "ignores source permissions during external fact pluginsync" do
-        ignores_source_permissions(facts_downloader)
-      end
-    end
-  end
-
-  context "when creating a plugin downloader for module translations" do
-    it 'is named "locales"' do
-      expect(locales_downloader.name).to eq('locales')
-    end
-
-    it 'downloads files into Puppet[:localedest]' do
-      localedest = File.expand_path("/tmp/ldest")
-      Puppet[:localedest] = localedest
-
-      expect(locales_downloader.file[:path]).to eq(localedest)
-    end
-
-    it 'downloads files from Puppet[:localesource]' do
-      Puppet[:localesource] = 'puppet:///myotherlocales'
-
-      expect(locales_downloader.file[:source]).to eq([Puppet[:localesource]])
-    end
-
-    it 'ignores files from Puppet[:pluginsignore], plus config.yaml' do
-      Puppet[:pluginsignore] = 'lignore'
-
-      expect(locales_downloader.file[:ignore]).to eq(['lignore', '*.pot', 'config.yaml'])
-    end
-
-    it "ignores source permissions" do
-      ignores_source_permissions(locales_downloader)
-    end
-  end
-end