Class: Puppet::Pops::Validation::Factory Abstract

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

Overview

This class is abstract.

Subclass must implement #checker, and #label_provider

This class is an abstract base implementation of a _model validation factory_ that creates a validator instance and associates it with a fully configured DiagnosticProducer.

A validator is responsible for validating a model. There may be different versions of validation available for one and the same model; e.g. different semantics for different puppet versions, or different types of validation configuration depending on the context/type of validation that should be performed (static, vs. runtime, etc.).

This class is abstract and must be subclassed. The subclass must implement the methods #label_provider and #checker. It is also expected that the subclass will override the severity_producer and configure the issues that should be reported as errors (i.e. if they should be ignored, produce a warning, or a deprecation warning).

Direct Known Subclasses

ValidatorFactory_4_0

Instance Method Summary collapse

Instance Method Details

#checker(diagnostic_producer) ⇒ Object

This method is abstract.

Produces the checker to use.

Raises:

  • (NoMethodError)


70
71
72
# File 'lib/puppet/pops/validation.rb', line 70

def checker(diagnostic_producer)
  raise NoMethodError, "checker"
end

#diagnostic_producer(acceptor) ⇒ DiagnosticProducer

Produces the diagnostics producer to use given an acceptor of issues.

Parameters:

  • acceptor (Acceptor)

    the acceptor is the receiver of all detected issues

Returns:



49
50
51
# File 'lib/puppet/pops/validation.rb', line 49

def diagnostic_producer(acceptor)
  DiagnosticProducer.new(acceptor, severity_producer(), label_provider())
end

#label_providerObject

This method is abstract.

Produces the label provider to use.

Raises:

  • (NoMethodError)


80
81
82
# File 'lib/puppet/pops/validation.rb', line 80

def label_provider
  raise NoMethodError, "label_provider"
end

#severity_producerSeverityProducer

Produces the SeverityProducer to use Subclasses should implement and add specific overrides

Returns:

  • (SeverityProducer)

    a severity producer producing error, warning or ignore per issue



60
61
62
# File 'lib/puppet/pops/validation.rb', line 60

def severity_producer
  SeverityProducer.new
end

#validator(acceptor) ⇒ #validate

Produces a validator with the given acceptor as the recipient of produced diagnostics. The acceptor is where detected issues are received (and typically collected).

Parameters:

  • acceptor (Acceptor)

    the acceptor is the receiver of all detected issues

Returns:

  • (#validate)

    a validator responding to ‘validate(model)`



38
39
40
# File 'lib/puppet/pops/validation.rb', line 38

def validator(acceptor)
  checker(diagnostic_producer(acceptor))
end