puppetlabs/puppet · error · ArgumentError

Found multiple files for plan '%{plan_name}' but only one is

Error message

Found multiple files for plan '%{plan_name}' but only one is allowed

What it means

Error "Found multiple files for plan '%{plan_name}' but only one is allowed" thrown in puppetlabs/puppet.

Source

Thrown at lib/puppet/pops/loader/generic_plan_instantiator.rb:12

# frozen_string_literal: true

module Puppet::Pops
module Loader
# The GenericPlanInstantiator dispatches to either PuppetPlanInstantiator or a
# yaml_plan_instantiator injected through the Puppet context, depending on
# the type of the plan.
#
class GenericPlanInstantiator
  def self.create(loader, typed_name, source_refs)
    if source_refs.length > 1
      raise ArgumentError, _("Found multiple files for plan '%{plan_name}' but only one is allowed") % { plan_name: typed_name.name }
    end

    source_ref = source_refs[0]
    code_string = Puppet::FileSystem.read(source_ref, :encoding => 'utf-8')

    instantiator = if source_ref.end_with?('.pp')
                     Puppet::Pops::Loader::PuppetPlanInstantiator
                   else
                     Puppet.lookup(:yaml_plan_instantiator) do
                       raise Puppet::DevError, _("No instantiator is available to load plan from %{source_ref}") % { source_ref: source_ref }
                     end
                   end

    instantiator.create(loader, typed_name, source_ref, code_string)
  end
end
end
end

View on GitHub (pinned to e227c27540)

When it happens

Trigger: Thrown at lib/puppet/pops/loader/generic_plan_instantiator.rb:12 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of puppetlabs/puppet@e227c27540 (2026-08-21). Data as JSON: /api/errors/1abc175334486095. Report an issue: GitHub.