puppet 5.5.22 → 6.0.0

data/lib/puppet/vendor/load_semantic.rb

@@ -1 +0,0 @@
-$: << File.join([File.dirname(__FILE__), "semantic/lib"])

data/lib/puppet/vendor/load_semantic_puppet.rb

@@ -1 +0,0 @@
-$: << File.join([File.dirname(__FILE__), "semantic_puppet/lib"])

data/lib/puppet/vendor/semantic/lib/semantic.rb

@@ -1,5 +0,0 @@
-require 'puppet/vendor/semantic_puppet/lib/semantic_puppet'
-
-$stderr.puts "Warning: Puppet's internal vendored libraries are Private APIs and can change without warning. The 'semantic' library has been replaced with 'semantic_puppet'."
-
-Semantic = SemanticPuppet

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet.rb

@@ -1,11 +0,0 @@
-module SemanticPuppet
-  locales_path = File.absolute_path('../locales', File.dirname(__FILE__))
-  # Only create a translation repository of the relevant translations exist
-  if Puppet::FileSystem.exist?(File.join(locales_path, Puppet::GettextConfig.current_locale))
-    Puppet::GettextConfig.load_translations('semantic_puppet', locales_path, :po)
-  end
-
-  autoload :Version, 'semantic_puppet/version'
-  autoload :VersionRange, 'semantic_puppet/version_range'
-  autoload :Dependency, 'semantic_puppet/dependency'
-end

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/dependency.rb

@@ -1,181 +0,0 @@
-require 'semantic_puppet'
-
-module SemanticPuppet
-  module Dependency
-    extend self
-
-    autoload :Graph,         'semantic_puppet/dependency/graph'
-    autoload :GraphNode,     'semantic_puppet/dependency/graph_node'
-    autoload :ModuleRelease, 'semantic_puppet/dependency/module_release'
-    autoload :Source,        'semantic_puppet/dependency/source'
-
-    autoload :UnsatisfiableGraph, 'semantic_puppet/dependency/unsatisfiable_graph'
-
-    # @!group Sources
-
-    # @return [Array<Source>] a frozen copy of the {Source} list
-    def sources
-      (@sources ||= []).dup.freeze
-    end
-
-    # Appends a new {Source} to the current list.
-    # @param source [Source] the {Source} to add
-    # @return [void]
-    def add_source(source)
-      sources
-      @sources << source
-      nil
-    end
-
-    # Clears the current list of {Source}s.
-    # @return [void]
-    def clear_sources
-      sources
-      @sources.clear
-      nil
-    end
-
-    # @!endgroup
-
-    # Fetches a graph of modules and their dependencies from the currently
-    # configured list of {Source}s.
-    #
-    # @todo Return a specialized "Graph" object.
-    # @todo Allow for external constraints to be added to the graph.
-    # @see #sources
-    # @see #add_source
-    # @see #clear_sources
-    #
-    # @param modules [{ String => String }]
-    # @return [Graph] the root of a dependency graph
-    def query(modules)
-      constraints = Hash[modules.map { |k, v| [ k, VersionRange.parse(v) ] }]
-
-      graph = Graph.new(constraints)
-      fetch_dependencies(graph)
-      return graph
-    end
-
-    # Given a graph result from {#query}, this method will resolve the graph of
-    # dependencies, if possible, into a flat list of the best suited modules. If
-    # the dependency graph does not have a suitable resolution, this method will
-    # raise an exception to that effect.
-    #
-    # @param graph [Graph] the root of a dependency graph
-    # @return [Array<ModuleRelease>] the list of releases to act on
-    def resolve(graph)
-      catch :next do
-        return walk(graph, graph.dependencies.dup)
-      end
-      raise UnsatisfiableGraph.new(graph)
-    end
-
-    # Fetches all available releases for the given module name.
-    #
-    # @param name [String] the module name to find releases for
-    # @return [Array<ModuleRelease>] the available releases
-    def fetch_releases(name)
-      releases = {}
-
-      sources.each do |source|
-        source.fetch(name).each do |dependency|
-          releases[dependency.version] ||= dependency
-        end
-      end
-
-      return releases.values
-    end
-
-    private
-
-    # Iterates over a changing set of dependencies in search of the best
-    # solution available. Fitness is specified as meeting all the constraints
-    # placed on it, being {ModuleRelease#satisfied? satisfied}, and having the
-    # greatest version number (with stability being preferred over prereleases).
-    #
-    # @todo Traversal order is not presently guaranteed.
-    #
-    # @param graph [Graph] the root of a dependency graph
-    # @param dependencies [{ String => Array<ModuleRelease> }] the dependencies
-    # @param considering [Array<GraphNode>] the set of releases being tested
-    # @return [Array<GraphNode>] the list of releases to use, if successful
-    def walk(graph, dependencies, *considering)
-      return considering if dependencies.empty?
-
-      # Selecting a dependency from the collection...
-      name = dependencies.keys.sort.first
-      deps = dependencies.delete(name)
-
-      # ... (and stepping over it if we've seen it before) ...
-      unless (deps & considering).empty?
-        return walk(graph, dependencies, *considering)
-      end
-
-      # ... we'll iterate through the list of possible versions in order.
-      preferred_releases(deps).reverse_each do |dep|
-
-        # We should skip any releases that violate any module's constraints.
-        unless [graph, *considering].all? { |x| x.satisfies_constraints?(dep) }
-          next
-        end
-
-        # We should skip over any releases that violate graph-level constraints.
-        potential_solution = considering.dup << dep
-        unless graph.satisfies_graph? potential_solution
-          next
-        end
-
-        catch :next do
-          # After adding any new dependencies and imposing our own constraints
-          # on existing dependencies, we'll mark ourselves as "under
-          # consideration" and recurse.
-          merged = dependencies.merge(dep.dependencies) { |_,a,b| a & b }
-
-          # If all subsequent dependencies resolved well, the recursive call
-          # will return a completed dependency list. If there were problems
-          # resolving our dependencies, we'll catch `:next`, which will cause
-          # us to move to the next possibility.
-          return walk(graph, merged, *potential_solution)
-        end
-      end
-
-      # Once we've exhausted all of our possible versions, we know that our
-      # last choice was unusable, so we'll unwind the stack and make a new
-      # choice.
-      throw :next
-    end
-
-    # Given a {ModuleRelease}, this method will iterate through the current
-    # list of {Source}s to find the complete list of versions available for its
-    # dependencies.
-    #
-    # @param node [GraphNode] the node to fetch details for
-    # @return [void]
-    def fetch_dependencies(node, cache = {})
-      node.dependency_names.each do |name|
-        unless cache.key?(name)
-          cache[name] = fetch_releases(name)
-          cache[name].each { |dep| fetch_dependencies(dep, cache) }
-        end
-
-        node << cache[name]
-      end
-    end
-
-    # Given a list of potential releases, this method returns the most suitable
-    # releases for exploration. Only {ModuleRelease#satisfied? satisfied}
-    # releases are considered, and releases with stable versions are preferred.
-    #
-    # @param releases [Array<ModuleRelease>] a list of potential releases
-    # @return [Array<ModuleRelease>] releases open for consideration
-    def preferred_releases(releases)
-      satisfied = releases.select { |x| x.satisfied? }
-
-      if satisfied.any? { |x| x.version.stable? }
-        return satisfied.select { |x| x.version.stable? }
-      else
-        return satisfied
-      end
-    end
-  end
-end

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/dependency/graph.rb

@@ -1,60 +0,0 @@
-require 'semantic_puppet/dependency'
-
-module SemanticPuppet
-  module Dependency
-    class Graph
-      include GraphNode
-
-      attr_reader :modules
-
-      # Create a new instance of a dependency graph.
-      #
-      # @param modules [{String => VersionRange}] the required module
-      #        set and their version constraints
-      def initialize(modules = {})
-        @modules = modules.keys
-
-        modules.each do |name, range|
-          add_constraint('initialize', name, range.to_s) do |node|
-            range === node.version
-          end
-
-          add_dependency(name)
-        end
-      end
-
-      # Constrains graph solutions based on the given block.  Graph constraints
-      # are used to describe fundamental truths about the tooling or module
-      # system (e.g.: module names contain a namespace component which is
-      # dropped during install, so module names must be unique excluding the
-      # namespace).
-      #
-      # @example Ensuring a single source for all modules
-      #     @graph.add_constraint('installed', mod.name) do |nodes|
-      #       nodes.count { |node| node.source } == 1
-      #     end
-      #
-      # @see #considering_solution?
-      #
-      # @param source [String, Symbol] a name describing the source of the
-      #               constraint
-      # @yieldparam nodes [Array<GraphNode>] the nodes to test the constraint
-      #             against
-      # @yieldreturn [Boolean] whether the node passed the constraint
-      # @return [void]
-      def add_graph_constraint(source, &block)
-        constraints[:graph] << [ source, block ]
-      end
-
-      # Checks the proposed solution (or partial solution) against the graph's
-      # constraints.
-      #
-      # @see #add_graph_constraint
-      #
-      # @return [Boolean] true if none of the graph constraints are violated
-      def satisfies_graph?(solution)
-        constraints[:graph].all? { |_, check| check[solution] }
-      end
-    end
-  end
-end

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/dependency/graph_node.rb

@@ -1,117 +0,0 @@
-require 'semantic_puppet/dependency'
-require 'set'
-
-module SemanticPuppet
-  module Dependency
-    module GraphNode
-      include Comparable
-
-      def name
-      end
-
-      # Determines whether the modules dependencies are satisfied by the known
-      # releases.
-      #
-      # @return [Boolean] true if all dependencies are satisfied
-      def satisfied?
-        dependencies.none? { |_, v| v.empty? }
-      end
-
-      def children
-        @_children ||= {}
-      end
-
-      def populate_children(nodes)
-        if children.empty?
-          nodes = nodes.select { |node| satisfies_dependency?(node) }
-          nodes.each do |node|
-            children[node.name] = node
-            node.populate_children(nodes)
-          end
-          self.freeze
-        end
-      end
-
-      # @api internal
-      # @return [{ String => SortedSet<GraphNode> }] the satisfactory
-      #         dependency nodes
-      def dependencies
-        @_dependencies ||= Hash.new { |h, k| h[k] = SortedSet.new }
-      end
-
-      # Adds the given dependency name to the list of dependencies.
-      #
-      # @param name [String] the dependency name
-      # @return [void]
-      def add_dependency(name)
-        dependencies[name]
-      end
-
-      # @return [Array<String>] the list of dependency names
-      def dependency_names
-        dependencies.keys
-      end
-
-      def constraints
-        @_constraints ||= Hash.new { |h, k| h[k] = [] }
-      end
-
-      def constraints_for(name)
-        return [] unless constraints.has_key?(name)
-
-        constraints[name].map do |constraint|
-          {
-            :source      => constraint[0],
-            :description => constraint[1],
-            :test        => constraint[2],
-          }
-        end
-      end
-
-      # Constrains the named module to suitable releases, as determined by the
-      # given block.
-      #
-      # @example Version-locking currently installed modules
-      #     installed_modules.each do |m|
-      #       @graph.add_constraint('installed', m.name, m.version) do |node|
-      #         m.version == node.version
-      #       end
-      #     end
-      #
-      # @param source [String, Symbol] a name describing the source of the
-      #               constraint
-      # @param mod [String] the name of the module
-      # @param desc [String] a description of the enforced constraint
-      # @yieldparam node [GraphNode] the node to test the constraint against
-      # @yieldreturn [Boolean] whether the node passed the constraint
-      # @return [void]
-      def add_constraint(source, mod, desc, &block)
-        constraints["#{mod}"] << [ source, desc, block ]
-      end
-
-      def satisfies_dependency?(node)
-        dependencies.key?(node.name) && satisfies_constraints?(node)
-      end
-
-      # @param release [ModuleRelease] the release to test
-      def satisfies_constraints?(release)
-        constraints_for(release.name).all? { |x| x[:test].call(release) }
-      end
-
-      def << (nodes)
-        Array(nodes).each do |node|
-          next unless dependencies.key?(node.name)
-          if satisfies_dependency?(node)
-            dependencies[node.name] << node
-          end
-        end
-
-        return self
-      end
-
-      def <=>(other)
-        name <=> other.name
-      end
-    end
-  end
-end

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/dependency/module_release.rb

@@ -1,58 +0,0 @@
-require 'semantic_puppet/dependency'
-
-module SemanticPuppet
-  module Dependency
-    class ModuleRelease
-      include GraphNode
-
-      attr_reader :name, :version
-
-      # Create a new instance of a module release.
-      #
-      # @param source [SemanticPuppet::Dependency::Source]
-      # @param name [String]
-      # @param version [SemanticPuppet::Version]
-      # @param dependencies [{String => SemanticPuppet::VersionRange}]
-      def initialize(source, name, version, dependencies = {})
-        @source      = source
-        @name        = name.freeze
-        @version     = version.freeze
-
-        dependencies.each do |name, range|
-          add_constraint('initialize', name, range.to_s) do |node|
-            range === node.version
-          end
-
-          add_dependency(name)
-        end
-      end
-
-      def priority
-        @source.priority
-      end
-
-      def <=>(oth)
-        our_key   = [ priority, name, version ]
-        their_key = [ oth.priority, oth.name, oth.version ]
-
-        return our_key <=> their_key
-      end
-
-      def eql?(other)
-        other.is_a?(ModuleRelease) &&
-          @name.eql?(other.name) &&
-          @version.eql?(other.version) &&
-          dependencies.eql?(other.dependencies)
-      end
-      alias == eql?
-
-      def hash
-        @name.hash ^ @version.hash
-      end
-
-      def to_s
-        "#<#{self.class} #{name}@#{version}>"
-      end
-    end
-  end
-end

data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/dependency/source.rb

@@ -1,25 +0,0 @@
-require 'semantic_puppet/dependency'
-
-module SemanticPuppet
-  module Dependency
-    class Source
-      def self.priority
-        0
-      end
-
-      def priority
-        self.class.priority
-      end
-
-      def create_release(name, version, dependencies = {})
-        version = Version.parse(version) if version.is_a? String
-        dependencies = dependencies.inject({}) do |hash, (key, value)|
-          hash[key] = VersionRange.parse(value || '>= 0.0.0')
-          hash[key] ||= VersionRange::EMPTY_RANGE
-          hash
-        end
-        ModuleRelease.new(self, name, version, dependencies)
-      end
-    end
-  end
-end