puppet-retrospec 1.5.0 → 1.6.0

data/vendor/gems/puppet-4.5.2/lib/puppet/plugins/data_providers/registry.rb

@@ -1,84 +0,0 @@
-module Puppet::Plugins::DataProviders
-  class Registry
-    def self.register_extensions(extensions)
-      extensions.multibind(PER_MODULE_DATA_PROVIDER_KEY).name(PER_MODULE_DATA_PROVIDER_KEY).hash_of(PER_MODULE_DATA_PROVIDER_TYPE)
-      extensions.multibind(ENV_DATA_PROVIDERS_KEY).name(ENV_DATA_PROVIDERS_KEY).hash_of(ENV_DATA_PROVIDERS_TYPE)
-      extensions.multibind(MODULE_DATA_PROVIDERS_KEY).name(MODULE_DATA_PROVIDERS_KEY).hash_of(MODULE_DATA_PROVIDERS_TYPE)
-      extensions.multibind(PATH_BASED_DATA_PROVIDER_FACTORIES_KEY).name(PATH_BASED_DATA_PROVIDER_FACTORIES_KEY).hash_of(PATH_BASED_DATA_PROVIDER_FACTORIES_TYPE)
-    end
-
-    def self.hash_of_per_module_data_provider
-      @@HASH_OF_PER_MODULE_DATA_PROVIDERS ||= Puppet::Pops::Types::TypeFactory.hash_of(PER_MODULE_DATA_PROVIDER_TYPE)
-    end
-
-    def self.hash_of_module_data_providers
-      @@HASH_OF_MODULE_DATA_PROVIDERS ||= Puppet::Pops::Types::TypeFactory.hash_of(
-        Puppet::Pops::Types::TypeFactory.type_of(MODULE_DATA_PROVIDERS_TYPE))
-    end
-
-    def self.hash_of_environment_data_providers
-      @@HASH_OF_ENV_DATA_PROVIDERS ||= Puppet::Pops::Types::TypeFactory.hash_of(
-        Puppet::Pops::Types::TypeFactory.type_of(ENV_DATA_PROVIDERS_TYPE))
-    end
-
-    def self.hash_of_path_based_data_provider_factories
-      @@HASH_OF_PATH_BASED_DATA_PROVIDER_FACTORIES ||= Puppet::Pops::Types::TypeFactory.hash_of(
-        Puppet::Pops::Types::TypeFactory.type_of(PATH_BASED_DATA_PROVIDER_FACTORIES_TYPE))
-    end
-
-    # Registers a 'none' environment data provider, and a 'none' module data provider as the defaults.
-    # This is only done to allow that something binds to 'none' rather than removing the entire binding (which
-    # has the same effect).
-    #
-    def self.register_defaults(default_bindings)
-      default_bindings.bind do
-        name('none')
-        in_multibind(ENV_DATA_PROVIDERS_KEY)
-        to_instance(ENV_DATA_PROVIDERS_TYPE)
-      end
-
-      default_bindings.bind do
-        name('function')
-        in_multibind(ENV_DATA_PROVIDERS_KEY)
-        to_instance('Puppet::DataProviders::FunctionEnvDataProvider')
-      end
-
-      default_bindings.bind do
-        name('hiera')
-        in_multibind(ENV_DATA_PROVIDERS_KEY)
-        to_instance('Puppet::DataProviders::HieraEnvDataProvider')
-      end
-
-      default_bindings.bind do
-        name('none')
-        in_multibind(MODULE_DATA_PROVIDERS_KEY)
-        to_instance(MODULE_DATA_PROVIDERS_TYPE)
-      end
-
-      default_bindings.bind do
-        name('function')
-        in_multibind(MODULE_DATA_PROVIDERS_KEY)
-        to_instance('Puppet::DataProviders::FunctionModuleDataProvider')
-      end
-
-      default_bindings.bind do
-        name('hiera')
-        in_multibind(MODULE_DATA_PROVIDERS_KEY)
-        to_instance('Puppet::DataProviders::HieraModuleDataProvider')
-      end
-
-      default_bindings.bind do
-        name('json')
-        in_multibind(PATH_BASED_DATA_PROVIDER_FACTORIES_KEY)
-        to_instance('Puppet::DataProviders::JsonDataProviderFactory')
-      end
-
-      default_bindings.bind do
-        name('yaml')
-        in_multibind(PATH_BASED_DATA_PROVIDER_FACTORIES_KEY)
-        to_instance('Puppet::DataProviders::YamlDataProviderFactory')
-      end
-    end
-  end
-end
-

data/vendor/gems/puppet-4.5.2/lib/puppet/pops.rb

@@ -1,136 +0,0 @@
-module Puppet
-  # The Pops language system. This includes the parser, evaluator, AST model, and
-  # Binder.
-  #
-  # @todo Explain how a user should use this to parse and evaluate the puppet
-  #   language.
-  #
-  # @note Warning: Pops is still considered experimental, as such the API may
-  #   change at any time.
-  #
-  # @api public
-  module Pops
-    require 'semantic'
-
-    require 'puppet/pops/patterns'
-    require 'puppet/pops/utils'
-
-    require 'puppet/pops/adaptable'
-    require 'puppet/pops/adapters'
-
-    require 'puppet/pops/visitable'
-    require 'puppet/pops/visitor'
-
-    require 'puppet/pops/containment'
-
-    require 'puppet/pops/issues'
-    require 'puppet/pops/semantic_error'
-    require 'puppet/pops/label_provider'
-    require 'puppet/pops/validation'
-    require 'puppet/pops/issue_reporter'
-    require 'puppet/pops/lookup'
-    require 'puppet/pops/lookup/interpolation'
-    require 'puppet/pops/lookup/invocation'
-    require 'puppet/pops/lookup/sub_lookup'
-    require 'puppet/pops/lookup/explainer'
-
-    require 'puppet/pops/model/model'
-
-    # (the Types module initializes itself)
-    require 'puppet/pops/types/types'
-    require 'puppet/pops/types/string_converter'
-
-    require 'puppet/pops/merge_strategy'
-
-    module Model
-      require 'puppet/pops/model/tree_dumper'
-      require 'puppet/pops/model/ast_transformer'
-      require 'puppet/pops/model/factory'
-      require 'puppet/pops/model/model_tree_dumper'
-      require 'puppet/pops/model/model_label_provider'
-    end
-
-    module Binder
-      module SchemeHandler
-        # the handlers are auto loaded via bindings
-      end
-      module Producers
-        require 'puppet/pops/binder/producers'
-      end
-
-      require 'puppet/pops/binder/binder'
-      require 'puppet/pops/binder/bindings_model'
-      require 'puppet/pops/binder/binder_issues'
-      require 'puppet/pops/binder/bindings_checker'
-      require 'puppet/pops/binder/bindings_factory'
-      require 'puppet/pops/binder/bindings_label_provider'
-      require 'puppet/pops/binder/bindings_validator_factory'
-      require 'puppet/pops/binder/injector_entry'
-      require 'puppet/pops/binder/key_factory'
-      require 'puppet/pops/binder/injector'
-      require 'puppet/pops/binder/bindings_composer'
-      require 'puppet/pops/binder/bindings_model_dumper'
-      require 'puppet/pops/binder/system_bindings'
-      require 'puppet/pops/binder/bindings_loader'
-
-      module Config
-        require 'puppet/pops/binder/config/binder_config'
-        require 'puppet/pops/binder/config/binder_config_checker'
-        require 'puppet/pops/binder/config/issues'
-        require 'puppet/pops/binder/config/diagnostic_producer'
-      end
-    end
-
-    module Evaluator
-      require 'puppet/pops/evaluator/literal_evaluator'
-      require 'puppet/pops/evaluator/callable_signature'
-      require 'puppet/pops/evaluator/runtime3_converter'
-      require 'puppet/pops/evaluator/runtime3_support'
-      require 'puppet/pops/evaluator/evaluator_impl'
-      require 'puppet/pops/evaluator/epp_evaluator'
-      require 'puppet/pops/evaluator/collector_transformer'
-      require 'puppet/pops/evaluator/puppet_proc'
-      module Collectors
-        require 'puppet/pops/evaluator/collectors/abstract_collector'
-        require 'puppet/pops/evaluator/collectors/fixed_set_collector'
-        require 'puppet/pops/evaluator/collectors/catalog_collector'
-        require 'puppet/pops/evaluator/collectors/exported_collector'
-      end
-    end
-
-    module Parser
-      require 'puppet/pops/parser/eparser'
-      require 'puppet/pops/parser/parser_support'
-      require 'puppet/pops/parser/locator'
-      require 'puppet/pops/parser/locatable'
-      require 'puppet/pops/parser/lexer2'
-      require 'puppet/pops/parser/evaluating_parser'
-      require 'puppet/pops/parser/epp_parser'
-      require 'puppet/pops/parser/code_merger'
-    end
-
-    module Validation
-      require 'puppet/pops/validation/checker4_0'
-      require 'puppet/pops/validation/validator_factory_4_0'
-    end
-
-    # Subsystem for puppet functions defined in ruby.
-    #
-    # @api public
-    module Functions
-      require 'puppet/pops/functions/function'
-      require 'puppet/pops/functions/dispatch'
-      require 'puppet/pops/functions/dispatcher'
-    end
-
-    module Migration
-      require 'puppet/pops/migration/migration_checker'
-    end
-  end
-
-  require 'puppet/parser/ast/pops_bridge'
-  require 'puppet/bindings'
-  require 'puppet/functions'
-  require 'puppet/loaders'
-end
-require 'puppet/plugins/data_providers'

data/vendor/gems/puppet-4.5.2/lib/puppet/pops/adaptable.rb

@@ -1,204 +0,0 @@
-# Adaptable is a mix-in module that adds adaptability to a class.
-# This means that an adapter can
-# associate itself with an instance of the class and store additional data/have behavior.
-#
-# This mechanism should be used when there is a desire to keep implementation concerns separate.
-# In Ruby it is always possible to open and modify a class or instance to teach it new tricks, but it
-# is however not possible to do this for two different versions of some service at the same time.
-# The Adaptable pattern is also good when only a few of the objects of some class needs to have extra
-# information (again possible in Ruby by adding instance variables dynamically). In fact, the implementation
-# of Adaptable does just that; it adds an instance variable named after the adapter class and keeps an
-# instance of this class in this slot.
-#
-# @note the implementation details; the fact that an instance variable is used to keep the adapter
-#   instance data should not
-#   be exploited as the implementation of _being adaptable_ may change in the future.
-# @api private
-#
-module Puppet::Pops
-module Adaptable
-  # Base class for an Adapter.
-  #
-  # A typical adapter just defines some accessors.
-  #
-  # A more advanced adapter may need to setup the adapter based on the object it is adapting.
-  # @example Making Duck adaptable
-  #   class Duck
-  #     include Puppet::Pops::Adaptable
-  #   end
-  # @example Giving a Duck a nick name
-  #   class NickNameAdapter < Puppet::Pops::Adaptable::Adapter
-  #     attr_accessor :nick_name
-  #   end
-  #   d = Duck.new
-  #   NickNameAdapter.adapt(d).nick_name = "Daffy"
-  #   NickNameAdapter.get(d).nick_name # => "Daffy"
-  #
-  # @example Giving a Duck a more elaborate nick name
-  #   class NickNameAdapter < Puppet::Pops::Adaptable::Adapter
-  #     attr_accessor :nick_name, :object
-  #     def initialize o
-  #       @object = o
-  #       @nick_name = "Yo"
-  #     end
-  #     def nick_name
-  #       "#{@nick_name}, the #{o.class.name}"
-  #     end
-  #     def NickNameAdapter.create_adapter(o)
-  #       x = new o
-  #       x
-  #     end
-  #   end
-  #   d = Duck.new
-  #   n = NickNameAdapter.adapt(d)
-  #   n.nick_name # => "Yo, the Duck"
-  #   n.nick_name = "Daffy"
-  #   n.nick_name # => "Daffy, the Duck"
-  # @example Using a block to set values
-  #   NickNameAdapter.adapt(o) { |a| a.nick_name = "Buddy!" }
-  #   NickNameAdapter.adapt(o) { |a, o| a.nick_name = "You're the best #{o.class.name} I met."}
-  #
-  class Adapter
-    # Returns an existing adapter for the given object, or nil, if the object is not
-    # adapted.
-    #
-    # @param o [Adaptable] object to get adapter from
-    # @return [Adapter<self>] an adapter of the same class as the receiver of #get
-    # @return [nil] if the given object o has not been adapted by the receiving adapter
-    # @raise [ArgumentError] if the object is not adaptable
-    #
-    def self.get(o)
-      attr_name = self_attr_name
-      if o.instance_variable_defined?(attr_name)
-        o.instance_variable_get(attr_name)
-      else
-        nil
-      end
-    end
-
-    # Returns an existing adapter for the given object, or creates a new adapter if the
-    # object has not been adapted, or the adapter has been cleared.
-    #
-    # @example Using a block to set values
-    #   NickNameAdapter.adapt(o) { |a| a.nick_name = "Buddy!" }
-    #   NickNameAdapter.adapt(o) { |a, o| a.nick_name = "Your the best #{o.class.name} I met."}
-    # @overload adapt(o)
-    # @overload adapt(o, {|adapter| block})
-    # @overload adapt(o, {|adapter, o| block})
-    # @param o [Adaptable] object to add adapter to
-    # @yieldparam adapter [Adapter<self>] the created adapter
-    # @yieldparam o [Adaptable] optional, the given adaptable
-    # @param block [Proc] optional, evaluated in the context of the adapter (existing or new)
-    # @return [Adapter<self>] an adapter of the same class as the receiver of the call
-    # @raise [ArgumentError] if the given object o is not adaptable
-    #
-    def self.adapt(o, &block)
-      attr_name = self_attr_name
-      adapter = if o.instance_variable_defined?(attr_name) && value = o.instance_variable_get(attr_name)
-        value
-      else
-        associate_adapter(create_adapter(o), o)
-      end
-      if block_given?
-        case block.arity
-          when 1
-            block.call(adapter)
-          else
-            block.call(adapter, o)
-        end
-      end
-      adapter
-    end
-
-    # Creates a new adapter, associates it with the given object and returns the adapter.
-    #
-    # @example Using a block to set values
-    #   NickNameAdapter.adapt_new(o) { |a| a.nick_name = "Buddy!" }
-    #   NickNameAdapter.adapt_new(o) { |a, o| a.nick_name = "Your the best #{o.class.name} I met."}
-    # This is used when a fresh adapter is wanted instead of possible returning an
-    # existing adapter as in the case of {Adapter.adapt}.
-    # @overload adapt_new(o)
-    # @overload adapt_new(o, {|adapter| block})
-    # @overload adapt_new(o, {|adapter, o| block})
-    # @yieldparam adapter [Adapter<self>] the created adapter
-    # @yieldparam o [Adaptable] optional, the given adaptable
-    # @param o [Adaptable] object to add adapter to
-    # @param block [Proc] optional, evaluated in the context of the new adapter
-    # @return [Adapter<self>] an adapter of the same class as the receiver of the call
-    # @raise [ArgumentError] if the given object o is not adaptable
-    #
-    def self.adapt_new(o, &block)
-      adapter = associate_adapter(create_adapter(o), o)
-      if block_given?
-        case block.arity
-        when 1
-          block.call(adapter)
-        else
-          block.call(adapter, o)
-        end
-      end
-      adapter
-    end
-
-    # Clears the adapter set in the given object o. Returns any set adapter or nil.
-    # @param o [Adaptable] the object where the adapter should be cleared
-    # @return [Adapter] if an adapter was set
-    # @return [nil] if the adapter has not been set
-    #
-    def self.clear(o)
-      attr_name = self_attr_name
-      if o.instance_variable_defined?(attr_name)
-        o.send(:remove_instance_variable, attr_name)
-      else
-        nil
-      end
-    end
-
-    # This base version creates an instance of the class (i.e. an instance of the concrete subclass
-    # of Adapter). A Specialization may want to create an adapter instance specialized for the given target
-    # object.
-    # @param o [Adaptable] The object to adapt. This implementation ignores this variable, but a
-    #   specialization may want to initialize itself differently depending on the object it is adapting.
-    # @return [Adapter<self>] instance of the subclass of Adapter receiving the call
-    #
-    def self.create_adapter(o)
-      new
-    end
-
-    # Associates the given adapter with the given target object
-    # @param adapter [Adapter] the adapter to associate with the given object _o_
-    # @param o [Adaptable] the object to adapt
-    # @return [adapter] the given adapter
-    #
-    def self.associate_adapter(adapter, o)
-      attr_name = :"@#{instance_var_name(adapter.class.name)}"
-      o.instance_variable_set(attr_name, adapter)
-      adapter
-    end
-
-    DOUBLE_COLON = '::'
-    USCORE = '_'
-
-    # Returns a suitable instance variable name given a class name.
-    # The returned string is the fully qualified name of a class with '::' replaced by '_' since
-    # '::' is not allowed in an instance variable name.
-    # @param name [String] the fully qualified name of a class
-    # @return [String] the name with all '::' replaced by '_'
-    # @api private
-    #
-    def self.instance_var_name(name)
-      name.split(DOUBLE_COLON).join(USCORE)
-    end
-
-    # Returns a suitable instance variable name for the _name_ of this instance. The name is created by calling
-    # Adapter#instance_var_name and then cached.
-    # @return [String] the instance variable name for _name_
-    # @api private
-    #
-    def self.self_attr_name
-      @attr_name_sym ||= :"@#{instance_var_name(self.name)}"
-    end
-  end
-end
-end
-

data/vendor/gems/puppet-4.5.2/lib/puppet/pops/adapters.rb

@@ -1,193 +0,0 @@
-# The Adapters module contains adapters for Documentation, Origin, SourcePosition, and Loader.
-#
-module Puppet::Pops
-module Adapters
-  # A documentation adapter adapts an object with a documentation string.
-  # (The intended use is for a source text parser to extract documentation and store this
-  # in DocumentationAdapter instances).
-  #
-  class DocumentationAdapter < Adaptable::Adapter
-    # @return [String] The documentation associated with an object
-    attr_accessor :documentation
-  end
-
-  # A SourcePosAdapter holds a reference to  a *Positioned* object (object that has offset and length).
-  # This somewhat complex structure makes it possible to correctly refer to a source position
-  # in source that is embedded in some resource; a parser only sees the embedded snippet of source text
-  # and does not know where it was embedded. It also enables lazy evaluation of source positions (they are
-  # rarely needed - typically just when there is an error to report.
-  #
-  # @note It is relatively expensive to compute line and position on line - it is not something that
-  #   should be done for every token or model object.
-  #
-  # @see Utils#find_adapter, Utils#find_closest_positioned
-  #
-  class SourcePosAdapter < Adaptable::Adapter
-    attr_accessor :locator
-    attr_reader :adapted
-
-    def self.create_adapter(o)
-      new(o)
-    end
-
-    def initialize(o)
-      @adapted = o
-    end
-
-    def locator
-      # The locator is always the parent locator, all positioned objects are positioned within their
-      # parent. If a positioned object also has a locator that locator is for its children!
-      #
-      @locator ||= find_locator(@adapted.eContainer)
-    end
-
-    def find_locator(o)
-      if o.nil?
-        raise ArgumentError, "InternalError: SourcePosAdapter for something that has no locator among parents"
-      end
-      case
-      when o.is_a?(Model::Program)
-        return o.locator
-      # TODO_HEREDOC use case of SubLocator instead
-      when o.is_a?(Model::SubLocatedExpression) && !(found_locator = o.locator).nil?
-        return found_locator
-      when adapter = self.class.get(o)
-        return adapter.locator
-      else
-        find_locator(o.eContainer)
-      end
-    end
-    private :find_locator
-
-    def offset
-      @adapted.offset
-    end
-
-    def length
-      @adapted.length
-    end
-
-    # Produces the line number for the given offset.
-    # @note This is an expensive operation
-    #
-    def line
-      # Optimization: manual inlining of locator accessor since this method is frequently called
-      (@locator ||= find_locator(@adapted.eContainer)).line_for_offset(offset)
-    end
-
-    # Produces the position on the line of the given offset.
-    # @note This is an expensive operation
-    #
-    def pos
-      locator.pos_on_line(offset)
-    end
-
-    # Extracts the text represented by this source position (the string is obtained from the locator)
-    def extract_text
-      locator.extract_text(offset, length)
-    end
-
-    def extract_tree_text
-      first = @adapted.offset
-      last = first + @adapted.length
-      @adapted.eAllContents.each do |m|
-        m_offset = m.offset
-        next if m_offset.nil?
-        first = m_offset if m_offset < first
-        m_last = m_offset + m.length
-        last = m_last if m_last > last
-      end
-      locator.extract_text(first, last-first)
-    end
-
-    # Produces an URI with path?line=n&pos=n. If origin is unknown the URI is string:?line=n&pos=n
-    def to_uri
-      f = locator.file
-      if f.nil? || f.empty?
-        f = 'string:'
-      else
-        f = Puppet::Util.path_to_uri(f).to_s
-      end
-      URI("#{f}?line=#{line.to_s}&pos=#{pos.to_s}")
-    end
-  end
-
-  # A LoaderAdapter adapts an object with a {Loader}. This is used to make further loading from the
-  # perspective of the adapted object take place in the perspective of this Loader.
-  #
-  # It is typically enough to adapt the root of a model as a search is made towards the root of the model
-  # until a loader is found, but there is no harm in duplicating this information provided a contained
-  # object is adapted with the correct loader.
-  #
-  # @see Utils#find_adapter
-  #
-  class LoaderAdapter < Adaptable::Adapter
-    # @return [Loader::Loader] the loader
-    attr_accessor :loader
-
-    # Finds the loader to use when loading originates from the source position of the given argument.
-    #
-    # @param instance [Model::PopsObject] The model object
-    # @param scope [Puppet::Parser::Scope] The scope to use
-    # @return [Loader,nil] the found loader or `nil` if it could not be found
-    #
-    def self.loader_for_model_object(model, scope)
-      # find the loader that loaded the code, or use the private_environment_loader (sees env + all modules)
-      adapter = Utils.find_adapter(model, self)
-      return adapter.loader unless adapter.nil?
-
-      if scope.nil?
-        loaders = Puppet.lookup(:loaders) { nil }
-        loaders.nil? ? nil : loaders.private_environment_loader
-      else
-        # Use source location to determine calling module, or use the private_environment_loader (sees env + all modules)
-        # This is necessary since not all .pp files are loaded by a Loader (see PUP-1833)
-        adapter = adapt_by_source(scope, model)
-        adapter.nil? ? scope.compiler.loaders.private_environment_loader : adapter.loader
-      end
-    end
-
-    # Attempts to find the module that `instance` originates from by looking at it's {SourcePosAdapter} and
-    # compare the `locator.file` found there with the module paths given in the environment found in the
-    # given `scope`. If the file is found to be relative to a path, then the first segment of the relative
-    # path is interpreted as the name of a module. The object that the {SourcePosAdapter} is adapted to
-    # will then be adapted to the private loader for that module and that adapter is returned.
-    #
-    # The method returns `nil` when no module could be found.
-    #
-    # @param scope
-    # @param instance
-    def self.adapt_by_source(scope, instance)
-      source_pos = Utils.find_adapter(instance, SourcePosAdapter)
-      unless source_pos.nil?
-        mod = find_module_for_file(scope.environment, source_pos.locator.file)
-        unless mod.nil?
-          adapter = LoaderAdapter.adapt(source_pos.adapted)
-          adapter.loader = scope.compiler.loaders.private_loader_for_module(mod.name)
-          return adapter
-        end
-      end
-      nil
-    end
-
-    def self.find_module_for_file(environment, file)
-      return nil if file.nil?
-      file_path = Pathname.new(file)
-      environment.modulepath.each do |path|
-        begin
-          relative_path = file_path.relative_path_from(Pathname.new(path)).to_s.split(File::SEPARATOR)
-        rescue ArgumentError
-          # file_path was not relative to the module_path. That's OK.
-          next
-        end
-        if relative_path.length > 1
-          mod = environment.module(relative_path[0])
-          return mod unless mod.nil?
-        end
-      end
-      nil
-    end
-    private_class_method :find_module_for_file
-  end
-end
-end