henitai 0.2.0 → 0.2.1

data/sig/henitai.rbs

@@ -76,14 +76,6 @@ module Henitai
   module Integration::ChildDebugSupport
     private
 
-    def run_rspec_runner: (Array[String]) -> untyped
-    def build_rspec_runner: () -> untyped
-    def configure_rspec_runner: (untyped) -> void
-    def load_rspec_spec_files: (Array[String]) -> void
-    def run_rspec_specs: (untyped) -> untyped
-    def debug_child_timeout_dump: (Integer) -> void
-    def install_debug_timeout_trap: () -> void
-    def debug_child_thread_dump: (String) -> void
     def debug_child_puts: (String) -> void
     def debug_child?: () -> bool
     def debug_child_rspec_trace: (
@@ -97,14 +89,55 @@ module Henitai
     def debug_child_activation_end: (untyped, test_files: Array[String]) -> void
     def debug_child_mutant_meta: (Mutant) -> void
     def debug_child_activation_check: () -> void
-    def suppress_simplecov!: () -> void
-    def suppress_coverage!: () -> void
     def loaded_feature_map: (Array[String]) -> Array[[String, bool]]
     def loaded_feature?: (String) -> bool
     def rspec_world_example_count: () -> Integer?
     def pause: (Float) -> void
   end
 
+  module Integration::ChildRuntimeControl
+    private
+
+    def suppress_simplecov!: () -> void
+    def suppress_coverage!: () -> void
+    def debug_child_timeout_dump: (Integer) -> void
+    def install_debug_timeout_trap: () -> void
+    def debug_child_thread_dump: (String) -> void
+  end
+
+  module Integration::RspecChildRunner
+    private
+
+    def run_rspec_runner: (Array[String]) -> untyped
+    def build_rspec_runner: () -> untyped
+    def configure_rspec_runner: (untyped) -> void
+    def load_rspec_spec_files: (Array[String]) -> void
+    def run_rspec_specs: (untyped) -> untyped
+  end
+
+  module Integration::RspecTestSelection
+    REQUIRE_DIRECTIVE_PATTERN: Regexp
+
+    def select_tests: (Subject) -> Array[String]
+
+    private
+
+    def spec_files: () -> Array[String]
+    def fallback_spec_files: (Subject) -> Array[String]
+    def excluded_spec_files: () -> Array[String]
+    def rspec_exclude_patterns: () -> Array[String]
+    def rspec_config_lines: () -> Array[String]
+    def rspec_config_path: () -> String
+    def selection_patterns: (Subject) -> Array[String]
+    def requires_source_file?: (String, String) -> bool
+    def requires_source_file_transitively?: (String, String, ?Array[String]) -> bool
+    def required_files: (String) -> Array[String]
+    def resolve_required_file: (String, String, String) -> String?
+    def relative_candidates: (String, String) -> Array[String]
+    def require_candidates: (String, String) -> Array[String]
+    def expand_candidates: (String, String) -> Array[String]
+  end
+
   class Configuration
     DEFAULT_TIMEOUT: Float
     DEFAULT_OPERATORS: Symbol
@@ -118,6 +151,7 @@ module Henitai
 
     attr_reader integration: untyped
     attr_reader includes: Array[String]
+    attr_reader excludes: Array[String]
     attr_reader operators: Symbol
     attr_reader timeout: Float
     attr_reader ignore_patterns: Array[untyped]
@@ -295,6 +329,7 @@ module Henitai
 
     class Base
       include ChildDebugSupport
+      include ChildRuntimeControl
 
       def select_tests: (Subject) -> Array[String]
       def test_files: () -> Array[String]
@@ -314,7 +349,6 @@ module Henitai
       def cleanup_child_process: (Integer) -> void
       def suppress_simplecov!: () -> void
       def suppress_coverage!: () -> void
-      def run_tests: (Array[String]) -> Integer
       def debug_child?: () -> bool
       def debug_child_puts: (String) -> void
       def debug_child_rspec_trace: (test_files: Array[String], rspec_options: Array[String], rspec_argv: Array[String]) -> void
@@ -327,13 +361,24 @@ module Henitai
       def loaded_feature_map: (Array[String]) -> Array[[String, bool]]
       def loaded_feature?: (String) -> bool
       def rspec_world_example_count: () -> Integer?
-      def run_child_activation_and_tests: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
       def with_non_interactive_stdin: () { () -> untyped } -> untyped
       def subprocess_env: () -> Hash[String, String]
       def scenario_log_support: () -> ScenarioLogSupport
       def with_subprocess_env: () { () -> untyped } -> untyped
       def restore_subprocess_env: (Hash[String, String?]) -> void
-      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
+    end
+
+    module MutantRunSupport
+      def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
+      def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def scenario_log_paths: (String) -> Hash[Symbol, String]
+      def build_result: (untyped, Hash[Symbol, String]) -> ScenarioExecutionResult
+      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
+      def mutant_log_name: (Mutant) -> String
+
+      private
+
+      def run_child_activation_and_tests: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
     end
 
     class ScenarioLogSupport
@@ -374,58 +419,28 @@ module Henitai
     end
 
     class RspecProcessRunner
-      def run_mutant: (Rspec, mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
-      def run_suite: (Rspec, Array[String], timeout: Float) -> ScenarioExecutionResult
-      def spawn_mutant: (Rspec, mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> ChildHandle
+      def run_mutant: (Base, mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def run_suite: (Base, Array[String], timeout: Float) -> ScenarioExecutionResult
+      def spawn_mutant: (Base, mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> ChildHandle
     end
 
     class Rspec < Base
-      REQUIRE_DIRECTIVE_PATTERN: Regexp
+      include MutantRunSupport
+      include RspecChildRunner
+      include RspecTestSelection
+
       DEFAULT_SUITE_TIMEOUT: Float
 
-      def select_tests: (Subject) -> Array[String]
       def test_files: () -> Array[String]
-      def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
-      def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
       def run_suite: (Array[String], ?timeout: Float) -> ScenarioExecutionResult
       def per_test_coverage_supported?: () -> bool
+      def suite_command: (Array[String]) -> Array[String]
+      def rspec_suite_runner_script: () -> String
+      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
 
       private
 
-      def mutant_log_name: (Mutant) -> String
-      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
-      def suppress_simplecov!: () -> void
-      def suppress_coverage!: () -> void
-      def install_debug_timeout_trap: () -> void
-      def debug_child_thread_dump: (String) -> void
-      def debug_child_example_count: (String) -> void
-      def suite_command: (Array[String]) -> Array[String]
-      def rspec_suite_runner_script: () -> String
-      def build_result: (untyped, Hash[Symbol, String]) -> ScenarioExecutionResult
-      def scenario_status: (untyped) -> Symbol
-      def exit_status_for: (untyped) -> Integer?
-      def read_log_file: (String) -> String
-      def write_combined_log: (String, String, String) -> void
-      def combined_log: (String, String) -> String
-      def scenario_log_paths: (String) -> Hash[Symbol, String]
       def run_tests: (Array[String]) -> Integer
-      def with_subprocess_env: () { () -> untyped } -> untyped
-      def spec_files: () -> Array[String]
-      def fallback_spec_files: (Subject) -> Array[String]
-      def excluded_spec_files: () -> Array[String]
-      def rspec_exclude_patterns: () -> Array[String]
-      def rspec_config_lines: () -> Array[String]
-      def rspec_config_path: () -> String
-      def selection_patterns: (Subject) -> Array[String]
-      def requires_source_file?: (String, String) -> bool
-      def requires_source_file_transitively?: (String, String, ?Array[String]) -> bool
-      def required_files: (String) -> Array[String]
-      def resolve_required_file: (String, String, String) -> String?
-      def loaded_feature_map: (Array[String]) -> Array[[String, bool]]
-      def loaded_feature?: (String) -> bool
-      def relative_candidates: (String, String) -> Array[String]
-      def require_candidates: (String, String) -> Array[String]
-      def expand_candidates: (String, String) -> Array[String]
     end
 
     module CoverageRuntimeSuppressors
@@ -441,20 +456,28 @@ module Henitai
       def start: (*untyped) -> nil
     end
 
-    class Minitest < Rspec
+    class Minitest < Base
+      include MutantRunSupport
+      include RspecTestSelection
+
+      DEFAULT_SUITE_TIMEOUT: Float
+
+      def test_files: () -> Array[String]
+      def per_test_coverage_supported?: () -> bool
       def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
       def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
+      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
       def run_suite: (Array[String], ?timeout: Float) -> ScenarioExecutionResult
 
       private
 
-      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
       def run_tests: (Array[String]) -> Integer
       def preload_environment: () -> void
       def setup_load_path: () -> void
       def suppress_minitest_autorun!: () -> nil
       def suppress_simplecov!: () -> void
       def subprocess_env: () -> Hash[String, String]
+      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
       def cleanup_suite_process: (Integer?, untyped) -> void
       def spec_files: () -> Array[String]
     end
@@ -480,9 +503,18 @@ module Henitai
   end
 
   class MutantHistoryStore
+    attr_reader path: String
+
     def initialize: (path: String) -> void
     def record: (untyped, version: String, ?recorded_at: Time) -> void
     def trend_report: () -> Hash[Symbol, untyped]
+
+    module Sql
+      RUNS_TABLE: String
+      MUTANTS_TABLE: String
+      INSERT_RUN: String
+      UPSERT_MUTANT: String
+    end
   end
 
   class EquivalenceDetector
@@ -522,13 +554,41 @@ module Henitai
   end
 
   class ProcessWorkerRunner
-    SCHEDULER_POLL_INTERVAL: Float
+    attr_reader worker_count: Integer
+    attr_reader runtime: untyped
+    attr_reader wakeup: untyped
+
+    def initialize: (worker_count: Integer, ?runtime: untyped, ?wakeup: untyped) -> void
+    def flaky_retry_count: () -> Integer
+    def shutdown_requested?: () -> bool
+    def request_shutdown: () -> void
+    def run: (Array[Mutant], untyped, untyped, untyped?, ?Hash[Symbol, untyped]) -> Array[ScenarioExecutionResult]
+  end
+
+  class SlotScheduler
     PROCESS_DRAIN_WINDOW: Float
 
     Slot: untyped
 
-    def initialize: (worker_count: Integer) -> void
-    def run: (Array[Mutant], untyped, untyped, untyped?, ?Hash[Symbol, untyped]) -> Array[ScenarioExecutionResult]
+    attr_reader flaky_retry_count: Integer
+    attr_reader results: Array[ScenarioExecutionResult]
+
+    def initialize: (
+      integration: untyped,
+      config: untyped,
+      progress_reporter: untyped?,
+      options: Hash[Symbol, untyped],
+      host: untyped
+    ) -> void
+    def enqueue: (Array[Mutant]) -> Array[Mutant]
+    def done?: () -> bool
+    def fill_idle_slots: () -> void
+    def reap_all_completed_children: () -> void
+    def next_event_timeout: () -> Float?
+    def check_timeouts: () -> void
+    def draining_slots?: () -> bool
+    def drain_draining_slots: () -> void
+    def interrupt_active_slots: () -> void
   end
 
   class StaticFilter
@@ -563,8 +623,6 @@ module Henitai
   end
 
   class Mutant::Activator
-    SERIALIZER_METHODS: Hash[Symbol, Symbol]
-
     def self.activate!: (untyped) -> Symbol?
     def self.activation_source_for: (Mutant) -> String?
     def initialize: () -> void
@@ -578,6 +636,22 @@ module Henitai
     def method_source: (Mutant) -> String
     def body_source: (Mutant) -> String
     def parameter_source: (Mutant) -> String
+    def replace_node: (untyped, untyped, untyped) -> untyped
+    def same_node?: (untyped, untyped) -> bool
+    def replace_child: (untyped, untyped, untyped) -> untyped
+    def method_body: (untyped) -> untyped
+    def source_file_from_ast: (Subject) -> String?
+    def node_location_signature: (untyped) -> Array[untyped]?
+    def compile_safe_unparse: (untyped) -> String
+  end
+
+  class Mutant::ParameterSource
+    SERIALIZER_METHODS: Hash[Symbol, Symbol]
+
+    def build: (untyped) -> String
+
+    private
+
     def method_arguments: (untyped) -> untyped
     def parameter_fragment: (untyped) -> String?
     def argument_parameter_fragment: (untyped) -> String
@@ -589,26 +663,21 @@ module Henitai
     def block_parameter_fragment: (untyped) -> String
     def forward_parameter_fragment: (untyped) -> String
     def prefixed_parameter: (untyped, String) -> String
-    def replace_node: (untyped, untyped, untyped) -> untyped
-    def same_node?: (untyped, untyped) -> bool
-    def replace_child: (untyped, untyped, untyped) -> untyped
-    def method_body: (untyped) -> untyped
-    def source_file_from_ast: (Subject) -> String?
-    def node_location_signature: (untyped) -> Array[untyped]?
     def compile_safe_unparse: (untyped) -> String
   end
 
   module Reporter
-    def self.run_all: (names: Array[String], result: Result, config: Configuration) -> void
+    def self.run_all: (names: Array[String], result: Result, config: Configuration, ?history_store: MutantHistoryStore?) -> void
     def self.reporter_class: (String) -> untyped
 
     class Base
-      def initialize: (config: Configuration) -> void
+      def initialize: (config: Configuration, ?history_store: MutantHistoryStore?) -> void
       def report: (Result) -> void
 
       private
 
       def config: () -> Configuration
+      def history_store: () -> MutantHistoryStore?
     end
 
     class Terminal < Base
@@ -656,9 +725,8 @@ module Henitai
       def session_snapshot_path: (String) -> String
       def session_recipe_path: (String) -> String
       def canonical_path: () -> String
-      def report_path: () -> String
       def write_history_report: () -> void
-      def history_store_path: () -> String
+      def default_history_store: () -> MutantHistoryStore
       def history_report_path: () -> String
     end
 
@@ -719,7 +787,7 @@ module Henitai
     attr_reader session_id: String
     attr_reader git_sha: String?
 
-    def initialize: (mutants: Array[Mutant], started_at: Time, finished_at: Time, ?thresholds: Hash[Symbol, Integer]?, ?partial_rerun: bool, ?survivor_stats: Hash[Symbol, untyped]?, ?session_id: String, ?git_sha: String?) -> void
+    def initialize: (mutants: Array[Mutant], started_at: Time, finished_at: Time, ?thresholds: Hash[Symbol, Integer]?, ?partial_rerun: bool, ?survivor_stats: Hash[Symbol, untyped]?, ?session_id: String, ?git_sha: String?, ?source_provider: ^(String) -> String) -> void
     def partial_rerun?: () -> bool
     def killed: () -> Integer
     def survived: () -> Integer
@@ -814,6 +882,10 @@ module Henitai
     def history_store: () -> untyped
     def history_store_path: () -> String
     def source_files: () -> Array[String]
+    def included_source_files: () -> Array[String]
+    def reject_excluded: (Array[String]) -> Array[String]
+    def excluded_source_files: () -> Array[String]
+    def filter_changed: (Array[String]) -> Array[String]
     def pattern_subjects: () -> Array[Subject]
     def unique_subjects: (Array[Subject]) -> Array[Subject]
     def normalize_path: (String) -> String
@@ -821,6 +893,7 @@ module Henitai
     private
 
     def build_result: (Array[Mutant], Time, Time) -> Result
+    def source_provider: () -> ^(String) -> String
     def persist_history: (Result, Time) -> void
     def bootstrap_coverage: (Array[String], ?Array[String]?) -> void
     def bootstrap_mutants: (Array[String]) -> Thread
@@ -828,8 +901,20 @@ module Henitai
     def with_reports_dir: () { () -> untyped } -> untyped
     def result_thresholds: () -> Hash[Symbol, Integer]?
     def survivor_rerun?: () -> bool
-    def apply_survivor_selection: (Array[Mutant]) -> Array[Mutant]
+    def survivor_strategy: () -> SurvivorRerunStrategy
+    def safe_head_sha: () -> String?
+  end
+
+  class SurvivorRerunStrategy
+    attr_reader survivor_stats: Hash[Symbol, untyped]?
+
+    def initialize: (survivors_from: String?, config: Configuration, git_diff_analyzer: untyped) -> void
+    def active?: () -> bool
     def try_recipe_run: () -> Array[Mutant]?
+    def apply_selection: (Array[Mutant]) -> Array[Mutant]
+
+    private
+
     def load_survivor_report: () -> SurvivorLoader::Report
     def run_from_recipes: (SurvivorLoader::Report, Array[String]?) -> Array[Mutant]?
     def recipe_fast_path_safe?: (SurvivorLoader::Report, Array[String]?) -> bool
@@ -843,10 +928,10 @@ module Henitai
     def dirty_source_files?: (Array[String]?, ?git_sha: String?) -> bool
     def committed_changed_files: (String?) -> Array[String]
     def in_include_root?: (String, Array[String]) -> bool
+    def normalize_path: (String) -> String
     def warn_survivor_drift: (SurvivorSelector) -> void
     def build_survivor_stats: (SurvivorSelector, Array[Mutant], Hash[Symbol, Array[Mutant]]) -> Hash[Symbol, untyped]
     def test_filter: (SurvivorLoader::Report, ?dirty_source_files: bool) -> SurvivorTestFilter
-    def safe_head_sha: () -> String?
   end
 
   class CoverageBootstrapper

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: henitai
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Martin Otten
@@ -104,8 +104,16 @@ files:
 - lib/henitai/arid_node_filter.rb
 - lib/henitai/available_cpu_count.rb
 - lib/henitai/cli.rb
+- lib/henitai/cli/clean_command.rb
+- lib/henitai/cli/command_support.rb
+- lib/henitai/cli/init_command.rb
+- lib/henitai/cli/operator_command.rb
+- lib/henitai/cli/options.rb
+- lib/henitai/cli/run_command.rb
 - lib/henitai/configuration.rb
 - lib/henitai/configuration_validator.rb
+- lib/henitai/configuration_validator/rules.rb
+- lib/henitai/configuration_validator/scalars.rb
 - lib/henitai/coverage_bootstrapper.rb
 - lib/henitai/coverage_formatter.rb
 - lib/henitai/coverage_report_reader.rb
@@ -114,14 +122,25 @@ files:
 - lib/henitai/execution_engine.rb
 - lib/henitai/git_diff_analyzer.rb
 - lib/henitai/integration.rb
+- lib/henitai/integration/base.rb
+- lib/henitai/integration/child_debug_support.rb
+- lib/henitai/integration/child_runtime_control.rb
+- lib/henitai/integration/coverage_suppression.rb
+- lib/henitai/integration/minitest.rb
+- lib/henitai/integration/mutant_run_support.rb
+- lib/henitai/integration/rspec_child_runner.rb
 - lib/henitai/integration/rspec_process_runner.rb
+- lib/henitai/integration/rspec_test_selection.rb
+- lib/henitai/integration/scenario_log_support.rb
 - lib/henitai/minitest_coverage_hook.rb
 - lib/henitai/minitest_coverage_reporter.rb
 - lib/henitai/minitest_simplecov.rb
 - lib/henitai/mutant.rb
 - lib/henitai/mutant/activator.rb
+- lib/henitai/mutant/parameter_source.rb
 - lib/henitai/mutant_generator.rb
 - lib/henitai/mutant_history_store.rb
+- lib/henitai/mutant_history_store/sql.rb
 - lib/henitai/mutant_identity.rb
 - lib/henitai/operator.rb
 - lib/henitai/operators.rb
@@ -156,6 +175,9 @@ files:
 - lib/henitai/runner.rb
 - lib/henitai/sampling_strategy.rb
 - lib/henitai/scenario_execution_result.rb
+- lib/henitai/slot_scheduler.rb
+- lib/henitai/slot_scheduler/draining.rb
+- lib/henitai/slot_scheduler/process_control.rb
 - lib/henitai/source_parser.rb
 - lib/henitai/static_filter.rb
 - lib/henitai/stillborn_filter.rb
@@ -163,6 +185,7 @@ files:
 - lib/henitai/subject_resolver.rb
 - lib/henitai/survivor_activation_cache.rb
 - lib/henitai/survivor_loader.rb
+- lib/henitai/survivor_rerun_strategy.rb
 - lib/henitai/survivor_selector.rb
 - lib/henitai/survivor_test_filter.rb
 - lib/henitai/syntax_validator.rb
@@ -181,7 +204,7 @@ metadata:
   changelog_uri: https://github.com/martinotten/henitai/blob/main/CHANGELOG.md
   documentation_uri: https://github.com/martinotten/henitai/blob/main/README.md
   homepage_uri: https://github.com/martinotten/henitai
-  source_code_uri: https://github.com/martinotten/henitai/tree/v0.1.10
+  source_code_uri: https://github.com/martinotten/henitai/tree/v0.2.1
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: