Invalidate every CandidatePath cache inside an R6 object

Walks the public fields of `obj` depth-first. Every field that is a [CandidatePath] has its cache cleared via `$invalidate()`. Every field that is another R6 object is recursed into, so embedded objects (e.g. a [RegistryStudy] held inside a [TTEPlan]) are also invalidated.

Usage

invalidate_candidate_paths(obj)

Arguments

obj

An R6 object to walk.

Value

`invisible(obj)`.

Details

Active bindings are deliberately skipped during the walk: accessing a `$dir_foo` active binding would call `$resolve()` on the underlying [CandidatePath] and immediately re-populate the cache we are trying to clear. We reach the [CandidatePath] instances via their backing public fields instead.

This is called from `$save()` on both [RegistryStudy] and [TTEPlan] before serialization, so the on-disk qs2 file never carries host-specific resolved paths. After loading on a different host, first access re-walks the candidate list and caches the path valid on that host.

See also

[CandidatePath], [first_existing_path()], [RegistryStudy], [TTEPlan].

Other multi_host_paths: CandidatePath, first_existing_path()