Class: Mutant::Config Private

Inherits:
Object
  • Object
show all
Includes:
Unparser::Adamantium
Defined in:
lib/mutant.rb,
lib/mutant/config.rb,
lib/mutant/config/coverage_criteria.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.

Standalone configuration of a mutant execution.

Does not reference any “external” volatile state. The configuration applied to current environment is being represented by the Mutant::Env object.

Defined Under Namespace

Classes: CoverageCriteria

Constant Summary collapse

DEFAULT =

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

new(
  coverage_criteria: Config::CoverageCriteria::EMPTY,
  expression_parser: Expression::Parser.new([
    Expression::Method,
    Expression::Methods,
    Expression::Namespace::Exact,
    Expression::Namespace::Recursive
  ]),
  fail_fast:         false,
  hooks:             EMPTY_ARRAY,
  includes:          EMPTY_ARRAY,
  integration:       nil,
  isolation:         Mutant::Isolation::Fork.new(WORLD),
  jobs:              nil,
  matcher:           Matcher::Config::DEFAULT,
  mutation_timeout:  nil,
  reporter:          Reporter::CLI.build(WORLD.stdout),
  requires:          EMPTY_ARRAY,
  zombie:            false
)
MORE_THAN_ONE_CONFIG_FILE =

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

"Found more than one candidate for use as implicit config file: %s\n"
CANDIDATES =

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

%w[
  .mutant.yml
  config/mutant.yml
  mutant.yml
].freeze
PATHNAME_ARRAY =

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

Transform::Array.new(
  Transform::Sequence.new(
    [
      Transform::STRING,
      Transform::Exception.new(ArgumentError, Pathname.public_method(:new))
    ]
  )
)

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.env ⇒ Config

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 configuration from the environment

Returns:



107
108
109
 
# File 'lib/mutant/config.rb', line 107

def self.env
  DEFAULT.with(jobs: Etc.nprocessors)
end

.load_config_file(world) ⇒ Either<String,Config>

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.

Load config file

Parameters:

Returns:



72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/mutant/config.rb', line 72

def self.load_config_file(world)
  files = CANDIDATES
    .map(&world.pathname.public_method(:new))
    .select(&:readable?)

  if files.one?
    load_contents(files.first).fmap(&DEFAULT.public_method(:with))
  elsif files.empty?
    Either::Right.new(DEFAULT)
  else
    Either::Left.new(MORE_THAN_ONE_CONFIG_FILE % files.join(', '))
  end
end

Instance Method Details

#expand_defaults ⇒ Config

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.

Expand config with defaults

Returns:



89
90
91
92
93
94
 
# File 'lib/mutant/config.rb', line 89

def expand_defaults
  with(
    coverage_criteria: CoverageCriteria::DEFAULT.merge(coverage_criteria),
    jobs:              jobs || 1
  )
end

#merge(other) ⇒ Config

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.

Merge with other config

rubocop:disable Metrics/AbcSize rubocop:disable Metrics/MethodLength

Parameters:

Returns:



49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/mutant/config.rb', line 49

def merge(other)
  other.with(
    coverage_criteria: coverage_criteria.merge(other.coverage_criteria),
    fail_fast:         fail_fast || other.fail_fast,
    hooks:             hooks + other.hooks,
    includes:          includes + other.includes,
    integration:       other.integration || integration,
    jobs:              other.jobs || jobs,
    matcher:           matcher.merge(other.matcher),
    mutation_timeout:  other.mutation_timeout || mutation_timeout,
    requires:          requires + other.requires,
    zombie:            zombie || other.zombie
  )
end