Class: Puppet::Pops::Validation::Acceptor Private

Inherits:
Object
  • Object
show all
Defined in:
lib/puppet/pops/validation.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

An acceptor of diagnostics. An acceptor of diagnostics is given each issue as they are found by a diagnostician/validator. An acceptor can collect all found issues, or decide to collect a few and then report, or give up as the first issue if found. This default implementation collects all diagnostics in the order they are produced, and can then answer questions about what was diagnosed.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Acceptor

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Initializes this diagnostics acceptor. By default, the acceptor is configured with a default severity producer. TODO add semantic_label_provider

Parameters:

  • severity_producer (SeverityProducer) —

    the severity producer to use to determine severity of an issue



366
367
368
369
370
 
# File 'lib/puppet/pops/validation.rb', line 366

def initialize()
  @diagnostics = []
  @error_count = 0
  @warning_count = 0
end

Instance Attribute Details

#diagnostics ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

All diagnostic in the order they were issued



353
354
355
 
# File 'lib/puppet/pops/validation.rb', line 353

def diagnostics
  @diagnostics
end

#error_count ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

The number of :error severity issues



359
360
361
 
# File 'lib/puppet/pops/validation.rb', line 359

def error_count
  @error_count
end

#warning_count ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

The number of :warning severity issues + number of :deprecation severity issues



356
357
358
 
# File 'lib/puppet/pops/validation.rb', line 356

def warning_count
  @warning_count
end

Instance Method Details

#accept(diagnostic) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add a diagnostic, or all diagnostics from another acceptor to the set of diagnostics

Parameters:



409
410
411
412
413
414
415
 
# File 'lib/puppet/pops/validation.rb', line 409

def accept(diagnostic)
  if diagnostic.is_a?(Acceptor)
    diagnostic.diagnostics.each {|d| self.send(d.severity, d)}
  else
    self.send(diagnostic.severity, diagnostic)
  end
end

#errors ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the diagnosed errors in the order thwy were reported.



388
389
390
 
# File 'lib/puppet/pops/validation.rb', line 388

def errors
  @diagnostics.select {|d| d.severity == :error }
end

#errors? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns true when errors have been diagnosed.

Returns:

  • (Boolean) 


373
374
375
 
# File 'lib/puppet/pops/validation.rb', line 373

def errors?
  @error_count > 0
end

#errors_and_warnings ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



398
399
400
 
# File 'lib/puppet/pops/validation.rb', line 398

def errors_and_warnings
  @diagnostics.select {|d| d.severity != :ignore }
end

#errors_or_warnings? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns true when errors and/or warnings have been diagnosed.

Returns:

  • (Boolean) 


383
384
385
 
# File 'lib/puppet/pops/validation.rb', line 383

def errors_or_warnings?
  errors? || warnings?
end

#ignored ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the ignored diagnostics in the order thwy were reported (if reported at all)



403
404
405
 
# File 'lib/puppet/pops/validation.rb', line 403

def ignored
  @diagnostics.select {|d| d.severity == :ignore }
end

#prune(&block) ⇒ Array<Diagnostic, nil] the removed set of diagnostics or nil if nothing was removed

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Prunes the contain diagnostics by removing those for which the given block returns true. The internal statistics is updated as a consequence of removing.

Returns:

  • (Array<Diagnostic, nil] the removed set of diagnostics or nil if nothing was removed) —

    Array<Diagnostic, nil] the removed set of diagnostics or nil if nothing was removed



421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
 
# File 'lib/puppet/pops/validation.rb', line 421

def prune(&block)
  removed = []
  @diagnostics.delete_if do |d|
    if should_remove = yield(d)
      removed << d
    end
    should_remove
  end
  removed.each do |d|
    case d.severity
    when :error
      @error_count -= 1
    when :warning
      @warning_count -= 1
    # there is not ignore_count
    end
  end
  removed.empty? ? nil : removed
end

#warnings ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the diagnosed warnings in the order thwy were reported. (This includes :warning and :deprecation severity)



394
395
396
 
# File 'lib/puppet/pops/validation.rb', line 394

def warnings
  @diagnostics.select {|d| d.severity == :warning || d.severity == :deprecation }
end

#warnings? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns true when warnings have been diagnosed.

Returns:

  • (Boolean) 


378
379
380
 
# File 'lib/puppet/pops/validation.rb', line 378

def warnings?
  @warning_count > 0
end