Module: Poise::Helpers::DefinedIn

Included in:
Inversion::Provider, Provider, Resource
Defined in:
lib/poise/helpers/defined_in.rb

Overview

A mixin to track where a resource or provider was defined. This can provide either the filename of the class or the cookbook it was defined in.

Examples:

class MyProvider < Chef::provider
  include Poise::Helpers::DefinedIn

  def action_create
    template '...' do
      # ...
      cookbook new_resource.poise_defined_in
    end
  end
end

Since:

  • 2.0.0

Constant Summary collapse

POISE_LIB_ROOT =

Path to the root of Poise's code.

See Also:

  • #poise_defined!

Since:

  • 2.0.0

::File.expand_path('../..', __FILE__)
CHEF_LIB_ROOT =

Path to the root of Chef's code.

See Also:

  • #poise_defined!

Since:

  • 2.0.0

::Gem::Specification.find_by_name('chef').gem_dir

Class Method Summary collapse

Class Method Details

.poise_defined!(caller_array)

This method returns an undefined value.

Record that the class/module was defined. Called automatically by Ruby for all normal cases.

Parameters:

  • caller_array (Array<String>) —

    A strack trace returned by #caller.

Since:

  • 2.0.0



87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/poise/helpers/defined_in.rb', line 87

def poise_defined!(caller_array)
  # Only try to set this once.
  return if @poise_defined_in
  # Parse out just the filenames.
  caller_array = caller_array.map {|line| line.split(/:/, 2).first }
  # Find the first non-poise, non-chef line. This assumes Halite
  # transformation which I'm not thrilled about.
  caller_path = caller_array.find do |line|
    !line.start_with?(POISE_LIB_ROOT) && !line.start_with?(CHEF_LIB_ROOT)
  end
  Chef::Log.debug("[#{self.name}] Recording poise_defined_in as #{caller_path}")
  @poise_defined_in = caller_path
end

.poise_defined_in ⇒ String

The file this class or module was defined in, or nil if it isn't found.

Returns:

  • (String)

Raises:

Since:

  • 2.0.0



62
63
64
65
 
# File 'lib/poise/helpers/defined_in.rb', line 62

def poise_defined_in
  raise Poise::Error.new("Unable to determine location of #{self.name}") unless @poise_defined_in
  @poise_defined_in
end

.poise_defined_in_cookbook(run_context, file = nil) ⇒ String

The cookbook this class or module was defined in. Can pass a file to check that instead.

Parameters:

  • run_context (Chef::RunContext) —

    Run context to check cookbooks in.

  • file (String, nil) (defaults to: nil) —

    Optional file path to check instead of the path this class was defined in.

Returns:

  • (String)

Since:

  • 2.0.0



74
75
76
77
78
79
80
 
# File 'lib/poise/helpers/defined_in.rb', line 74

def poise_defined_in_cookbook(run_context, file=nil)
  file ||= poise_defined_in
  Poise.debug("[#{self.name}] Checking cookbook name for #{file}")
  Poise::Utils.find_cookbook_name(run_context, file).tap do |cookbook|
    Poise.debug("[#{self.name}] found cookbook #{cookbook.inspect}")
  end
end