class Puppet::Pal::CatalogCompiler

A CatalogCompiler is a compiler that builds a catalog of resources and dependencies as a side effect of evaluating puppet language code. When the compilation of the given input manifest(s)/code string/file is finished the catalog is complete for encoding and use. It is also possible to evaluate more strings within the same compilation context to add or remove things from the catalog.

@api public

Public Instance Methods

catalog_data_hash() click to toggle source

Returns a hash representation of the compiled catalog.

@api public

   # File lib/puppet/pal/catalog_compiler.rb
43 def catalog_data_hash
44   catalog.to_data_hash
45 end
compile_additions() click to toggle source

Compiles the result of additional evaluation taking place in a PAL catalog compilation. This will evaluate all lazy constructs until all have been evaluated, and will the validate the result.

This should be called if evaluating string or files of puppet logic after the initial compilation taking place by giving PAL a manifest or code-string. This method should be called when a series of evaluation should have reached a valid state (there should be no dangling relationships (to resources that does not exist).

As an alternative the methods `evaluate_additions` can be called without any requirements on consistency and then calling `validate` at the end.

Can be called multiple times.

@return [Void]

   # File lib/puppet/pal/catalog_compiler.rb
82 def compile_additions
83   internal_compiler.compile_additions
84 end
evaluate(ast) click to toggle source

Evaluates an AST obtained from `parse_string` or `parse_file` in topscope. If the ast is a `Puppet::Pops::Model::Program` (what is returned from the `parse` methods, any definitions in the program (that is, any function, plan, etc. that is defined will be made available for use).

@param ast [Puppet::Pops::Model::PopsObject] typically the returned `Program` from the parse methods, but can be any `Expression` @returns [Object] whatever the ast evaluates to

   # File lib/puppet/pal/catalog_compiler.rb
54 def evaluate(ast)
55   if ast.is_a?(Puppet::Pops::Model::Program)
56     bridged = Puppet::Parser::AST::PopsBridge::Program.new(ast)
57     # define all catalog types
58     internal_compiler.environment.known_resource_types.import_ast(bridged, "")
59     bridged.evaluate(internal_compiler.topscope)
60   else
61     internal_evaluator.evaluate(topscope, ast)
62   end
63 end
evaluate_additions() click to toggle source

Evaluates all lazy constructs that were produced as a side effect of evaluating puppet logic. Can be called multiple times.

   # File lib/puppet/pal/catalog_compiler.rb
96 def evaluate_additions
97   internal_compiler.evaluate_additions
98 end
evaluate_ast_node() click to toggle source

Attempts to evaluate AST for node defnintions puppet.com/docs/puppet/latest/lang_node_definitions.html if there are any.

    # File lib/puppet/pal/catalog_compiler.rb
102 def evaluate_ast_node
103   internal_compiler.evaluate_ast_node
104 end
has_catalog?() click to toggle source

Returns true if this is a compiler that compiles a catalog. This implementation returns `true` @return [Boolean] true @api public

   # File lib/puppet/pal/catalog_compiler.rb
22 def has_catalog?
23   true
24 end
validate() click to toggle source

Validates the state of the catalog (without performing evaluation of any elements requiring lazy evaluation. Can be called multiple times.

   # File lib/puppet/pal/catalog_compiler.rb
89 def validate
90   internal_compiler.validate
91 end
with_json_encoding(pretty: true, exclude_virtual: true) { |json_catalog_encoder(catalog, pretty: pretty, exclude_virtual: exclude_virtual)| ... } click to toggle source

Calls a block of code and yields a configured `JsonCatalogEncoder` to the block. @example Get resulting catalog as pretty printed Json

Puppet::Pal.in_environment(...) do |pal|
  pal.with_catalog_compiler(...) do |compiler|
    compiler.with_json_encoding { |encoder| encoder.encode }
  end
end

@api public

   # File lib/puppet/pal/catalog_compiler.rb
36 def with_json_encoding(pretty: true, exclude_virtual: true)
37   yield JsonCatalogEncoder.new(catalog, pretty: pretty, exclude_virtual: exclude_virtual)
38 end

Private Instance Methods

catalog() click to toggle source

@api private

   # File lib/puppet/pal/catalog_compiler.rb
13 def catalog
14   internal_compiler.catalog
15 end