Module water_dir 

Management of the global Water home and per-project managed backend build cache.

Playground projects store generated backends under ~/.water/build_cache/<absolute-project-path>/managed_backends/ instead of scattering .water directories into user projects.

Structs

BuildCacheConfig

Cleanup policy for the global managed build cache.

BuildCacheEntryUsage

On-disk usage of one managed build-cache entry.

BuildCacheGcSummary

Summary of one managed build-cache garbage-collection pass.

BuildCacheUsageReport

What the managed build cache is currently spending disk on.

HomeDirError

The current user’s home directory could not be determined.

WaterConfig

Global Water CLI configuration persisted to ~/.water/config.toml.

Enums

BuildCacheGcOutcome

Result of attempting to garbage-collect stale managed build-cache entries.

Constants

CLI_COMMIT

The CLI commit hash embedded at build time.

Functions

build_cache_container_for

Return the whole managed cache container for a project directory, which need not exist.

build_cache_root

Return the global managed build-cache root at ~/.water/build_cache.

cleanup_stale_build_caches_for_project

Garbage-collect stale managed build-cache entries while preserving the current project’s cache.

ensure_global_config

Ensure ~/.water/config.toml exists and return the parsed configuration.

ensure_project_build_cache

Ensure the managed build-cache directory exists for a project and return it.

project_build_cache_dir

Return the managed build-cache directory for a project.

remove_project_build_cache

Remove the managed build cache for a project.

survey_build_cache_usage

Survey the managed build cache without removing anything.

water_home_dir

Return the Water home directory root at ~/.water.

water_home_dir_in

Return the Water home directory root at ~/.water for host.

write_global_config

Persist config to ~/.water/config.toml.