Class: PuppetParser

Inherits:
Object
  • Object
show all
Defined in:
lib/puppet-check/puppet_parser.rb

Overview

executes diagnostics on puppet files

Class Method Summary collapse

Class Method Details

.manifest(files, future, style, pl_args) ⇒ Object

checks puppet (.pp)



7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/puppet-check/puppet_parser.rb', line 7

def self.manifest(files, future, style, pl_args)
  require 'puppet/face'

  # prepare the Puppet settings for the error checking
  Puppet.initialize_settings unless Puppet.settings.app_defaults_initialized?
  Puppet[:parser] = 'future' if future && (Puppet::PUPPETVERSION.to_i < 4)

  files.each do |file|
    # setup error logging and collection
    errors = []
    Puppet::Util::Log.newdestination(Puppet::Test::LogCollector.new(errors))

    # check puppet syntax
    begin
      Puppet::Face[:parser, :current].validate(file)
    # this is the actual error that we need to rescue Puppet::Face from
    rescue SystemExit
      # puppet 5.4-5.x has a new validator output format and eof errors have fake dir env info
      if Puppet::PUPPETVERSION.to_f >= 5.4
        next PuppetCheck.settings[:error_files].push("#{file}:\n#{errors.map(&:to_s).join("\n").gsub(/file: #{File.absolute_path(file)}(, |\))/, '').gsub(/Could not parse.*: /, '')}")
      # puppet 5.0-5.2 can only do one error per line and outputs fake dir env info
      elsif Puppet::PUPPETVERSION.to_f >= 5.0 && Puppet::PUPPETVERSION.to_f < 5.3
        next PuppetCheck.settings[:error_files].push("#{file}:\n#{errors.map(&:to_s).join("\n").gsub("#{File.absolute_path(file)}:", '').gsub(/Could not parse.*: /, '')}")
      end
      # puppet < 5 and 5.3 parser output style
      next PuppetCheck.settings[:error_files].push("#{file}:\n#{errors.map(&:to_s).join("\n").gsub("#{File.absolute_path(file)}:", '')}")
    end

    # initialize warnings with output from the parser if it exists, since the output is warnings if Puppet::Face did not trigger a SystemExit
    warnings = "#{file}:"
    unless errors.empty?
      # puppet 5.4-5.x has a new validator output format
      warnings << if Puppet::PUPPETVERSION.to_f >= 5.4
                    "\n#{errors.map(&:to_s).join("\n").gsub("file: #{File.absolute_path(file)}, ", '')}"
                  # puppet <= 5.3 validator output format
                  else
                    "\n#{errors.map(&:to_s).join("\n").gsub("#{File.absolute_path(file)}:", '')}"
                  end
    end
    Puppet::Util::Log.close_all

    # check puppet style
    if style
      require 'puppet-lint'
      require 'puppet-lint/optparser'

      # check for invalid arguments to PuppetLint
      begin
        PuppetLint::OptParser.build.parse!(pl_args.clone)
      rescue OptionParser::InvalidOption
        raise "puppet-lint: invalid option supplied among #{pl_args.join(' ')}"
      end

      # prepare the PuppetLint object for style checks
      puppet_lint = PuppetLint.new
      puppet_lint.file = file
      puppet_lint.run

      # collect the warnings
      if puppet_lint.warnings?
        puppet_lint.problems.each { |values| warnings << "\n#{values[:line]}:#{values[:column]}: #{values[:message]}" }
      end
    end
    next PuppetCheck.settings[:warning_files].push(warnings) unless warnings == "#{file}:"
    PuppetCheck.settings[:clean_files].push(file.to_s)
  end
end

.template(files) ⇒ Object

checks puppet template (.epp)



76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/puppet-check/puppet_parser.rb', line 76

def self.template(files)
  require 'puppet/pops'

  files.each do |file|
    # puppet before version 4 cannot check template syntax
    next PuppetCheck.settings[:ignored_files].push("#{file}: ignored due to Puppet < 4") if Puppet::PUPPETVERSION.to_i < 4

    # check puppet template syntax
    begin
      # credits to gds-operations/puppet-syntax for the parser function call
      Puppet::Pops::Parser::EvaluatingParser::EvaluatingEppParser.new.parse_file(file)
    rescue StandardError => err
      PuppetCheck.settings[:error_files].push("#{file}:\n#{err.to_s.gsub("#{file}:", '')}")
    else
      PuppetCheck.settings[:clean_files].push(file.to_s)
    end
  end
end