Module: Evilution Private

Defined in:
lib/evilution.rb,
lib/evilution/version.rb,
sig/evilution.rbs

Overview

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

Evilution has no public Ruby API. The entire Evilution:: namespace is internal and may change in any release, including patches. The stable, SemVer-governed contract is the CLI, .evilution.yml config keys, session JSON files, the MCP tool schemas, and process exit codes. See docs/public_api.md and docs/versioning.md.

Defined Under Namespace

Modules: AST, ChildOutput, Compare, Coverage, Equivalent, Feedback, GemDetector, Git, Integration, Isolation, LoadPath, MCP, Memory, Mutator, Parallel, ParallelDbWarning, ProcessCleanup, RailsDetector, Reporter, Result, Session, TempDirTracker Classes: Baseline, CLI, Cache, Config, ConfigError, CoverageExampleFilter, DisableComment, Error, ExampleFilter, Hooks, IsolationError, Mutation, ParseError, ProcessSupervisor, RelatedSpecHeuristic, Runner, SourceAstCache, SpecAstCache, SpecResolver, SpecSelector, Subject

Constant Summary collapse

PROJECT_ROOT =

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.

Captured at load time, before any isolator can chdir into a per-mutation sandbox. Used as the anchor for resolving project-relative paths (spec files, source files for eval) from inside a chdir'd child so the CWD sandbox (EV-wqxu / GH #1278) cannot break spec resolution or eval FILE.

Dir.pwd.freeze
VERSION =

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.

Returns:

  • (String) 
"1.1.0"

Class Method Summary collapse

Class Method Details

.in_isolated_worker! ⇒ 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.

Flag set by isolators (Evilution::Isolation::Fork in the forked child, Evilution::Isolation::InProcess around the test_command) so spec resolution and source eval anchor relative paths to PROJECT_ROOT instead of Dir.pwd. Without this gate, a caller that intentionally chdirs to a different project (e.g. a fixture layout in tests) would have its lookups inadvertently fall back to the evilution dev tree.



157
158
159
 
# File 'lib/evilution.rb', line 157

def self.in_isolated_worker!
  @in_isolated_worker = true
end

.in_isolated_worker? ⇒ 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:

  • (Boolean) 


161
162
163
 
# File 'lib/evilution.rb', line 161

def self.in_isolated_worker?
  @in_isolated_worker == true
end

.project_base_dir ⇒ 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.

Base directory for resolving project-relative paths. An isolated worker has chdir'd into a per-mutation sandbox (EV-wqxu / GH #1278), so callers in that context must anchor against PROJECT_ROOT rather than Dir.pwd — otherwise spec files, source eval FILE, and $LOAD_PATH entries resolve into the sandbox and break the run. In any other context (normal use, tests that intentionally chdir into a fixture project layout, etc.) the caller's Dir.pwd remains the truth.



180
181
182
 
# File 'lib/evilution.rb', line 180

def self.project_base_dir
  in_isolated_worker? ? PROJECT_ROOT : Dir.pwd
end

.with_isolated_worker ⇒ 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. 



165
166
167
168
169
170
171
 
# File 'lib/evilution.rb', line 165

def self.with_isolated_worker
  previous = @in_isolated_worker
  @in_isolated_worker = true
  yield
ensure
  @in_isolated_worker = previous
end