1 # Function to print deprecation warnings, Logs a warning once for a given key. The uniqueness key - can appear once. The msg is the message text including any positional information that is formatted by the user/caller of the method It is affected by the puppet setting 'strict', which can be set to :error (outputs as an error message), :off (no message / error is displayed) and :warning (default, outputs a warning) *Type*: String, String.
4 Puppet::Functions.create_function(:deprecation) do
5 dispatch :deprecation do
7 param 'String', :message
10 def deprecation(key, message)
11 if defined? Puppet::Pops::PuppetStack.stacktrace()
12 stacktrace = Puppet::Pops::PuppetStack.stacktrace()
15 message = "#{message} at #{file}:#{line}"
17 # depending on configuration setting of strict
18 case Puppet.settings[:strict]
22 fail("deprecation. #{key}. #{message}")
24 unless ENV['STDLIB_LOG_DEPRECATIONS'] == 'false'
25 Puppet.deprecation_warning(message, key)