Module project_cache 

Structs

CacheLoadReport

CacheSaveReport

DiscoveredLibs

Discover existing LSP caches in lib sub-projects.

Functions

cache_dir

Public helper — returns the root of the on-disk cache directory for project_root. Used by the solidity.clearCache command handler.

changed_files_since_v2_cache

Return absolute paths of source files whose current hash differs from v2 cache metadata (including newly-added files missing from metadata).

discover_lib_caches

Backwards-compatible wrapper: returns only sub-projects that have an existing cache on disk.

discover_lib_sub_projects

Walks the configured libs directories looking for foundry.toml files. Returns sub-project roots partitioned into those with existing caches and those without.

load_lib_cache

Load a sub-project’s cache as a CachedBuild.

load_reference_cache

load_reference_cache_with_report

save_last_solc_input

Persist the last solc standard-JSON input to the cache directory so it can be inspected for debugging.

save_reference_cache

save_reference_cache_with_report

upsert_reference_cache_v2_with_report

Incrementally upsert v2 cache shards for changed files, serializing global metadata (path_to_abs, id_to_path_map, external_refs) from the merged in-memory CachedBuild (root-key entry in ast_cache).