Class: RSpecTracer::Storage::LazySnapshot Private

Inherits:
Object
  • Object
show all
Defined in:
lib/rspec_tracer/storage/lazy_snapshot.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.

Lazy-reading view returned by ‘JsonBackend#load_graph`. Presents the same field surface as `Storage::Snapshot` but defers the disk read + deserialization for each field until the caller touches it.

Rationale: on a large cache (100 MB+), eager-reading every file at setup dominates warm-run startup (see issue #17 / B12). Engine at setup touches 10/15 fields; reporters never touch the previous snapshot; third-party tooling often reads one or two. The 3-5 fields the Engine does NOT touch at setup (duplicate_examples, reverse_dependency, env_dependency; examples_coverage is deferred to finalize per the seed refactor) save their full disk+parse cost for every run.

Duck-types ‘Snapshot`: every Struct member becomes a method here, `respond_to?` returns true for each, `to_h` materializes the whole thing. Callers doing `prev.send(field)` or `prev.field` work unchanged.

Thread-safety: the memoization Hash is not guarded. Engine is single-threaded per run; parallel_tests workers each own their own LazySnapshot instance. If a future caller reads fields from multiple threads, wrap with a Monitor at construct time.

Constant Summary collapse

LAZY_FIELDS =

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. 

(Snapshot.members - %i[schema_version run_id]).freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(schema_version:, run_id:, reader:) ⇒ LazySnapshot

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 a new instance of LazySnapshot.



34
35
36
37
38
39
 
# File 'lib/rspec_tracer/storage/lazy_snapshot.rb', line 34

def initialize(schema_version:, run_id:, reader:)
  @schema_version = schema_version
  @run_id = run_id
  @reader = reader
  @loaded = {}
end

Instance Attribute Details

#run_id ⇒ 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. 



32
33
34
 
# File 'lib/rspec_tracer/storage/lazy_snapshot.rb', line 32

def run_id
  @run_id
end

#schema_version ⇒ 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. 



32
33
34
 
# File 'lib/rspec_tracer/storage/lazy_snapshot.rb', line 32

def schema_version
  @schema_version
end

Instance Method Details

#to_h ⇒ 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.

Hash view matching ‘Struct#to_h` so callers composing snapshots (merge pipelines, reporter helpers) get the familiar shape. Forces every field to materialize, so only call this when the full cache is genuinely required.



53
54
55
 
# File 'lib/rspec_tracer/storage/lazy_snapshot.rb', line 53

def to_h
  Snapshot.members.to_h { |m| [m, public_send(m)] }
end

#to_snapshot ⇒ 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.

Materialize a full eager Snapshot. Use when an API requires the Struct type (Merger input, backends that accept Snapshot on save). Reads every field.



60
61
62
 
# File 'lib/rspec_tracer/storage/lazy_snapshot.rb', line 60

def to_snapshot
  Snapshot.new(**to_h)
end