tests.test_cache module

Tests for the global binary cache.

tests.test_cache.test_cache_dir_env_override(monkeypatch, tmp_path)

REPOMATIC_CACHE_DIR env var overrides platform default.

tests.test_cache.test_cache_dir_env_override_tilde(monkeypatch)

REPOMATIC_CACHE_DIR with ~ expands to home directory.

tests.test_cache.test_cache_dir_darwin(monkeypatch)

macOS uses ~/Library/Caches/repomatic.

tests.test_cache.test_cache_dir_linux_xdg(monkeypatch)

Linux with XDG_CACHE_HOME uses $XDG_CACHE_HOME/repomatic.

tests.test_cache.test_cache_dir_linux_default(monkeypatch)

Linux without XDG_CACHE_HOME uses ~/.cache/repomatic.

tests.test_cache.test_cache_dir_windows_localappdata(monkeypatch)

Windows uses %LOCALAPPDATA%/repomatic/Cache.

tests.test_cache.test_cache_dir_from_config(monkeypatch, tmp_path)

cache.dir in [tool.repomatic] overrides platform default.

tests.test_cache.test_cache_dir_env_beats_config(monkeypatch, tmp_path)

REPOMATIC_CACHE_DIR env var takes precedence over config.

tests.test_cache.test_max_age_days_from_config(monkeypatch)

cache.max-age in [tool.repomatic] overrides field default.

tests.test_cache.test_max_age_days_env_beats_config(monkeypatch)

REPOMATIC_CACHE_MAX_AGE env var takes precedence over config.

tests.test_cache.test_cached_binary_path_structure(cache_env)

Cache path follows bin/{tool}/{version}/{platform}/{executable}.

tests.test_cache.test_get_cached_binary_not_cached(cache_env)

Returns None when the binary is not in the cache.

tests.test_cache.test_get_cached_binary_exists(cache_env)

Returns the path when the binary exists and is executable.

tests.test_cache.test_get_cached_binary_not_executable(cache_env)

Returns None when the file exists but is not executable.

tests.test_cache.test_store_binary_creates_cache_entry(tmp_path, cache_env)

store_binary copies the source file into the cache.

tests.test_cache.test_store_binary_overwrites_existing(tmp_path, cache_env)

store_binary replaces an existing cached binary atomically.

tests.test_cache.test_store_binary_triggers_auto_purge(tmp_path, cache_env)

store_binary calls auto_purge after storing.

tests.test_cache.test_store_binary_stamps_store_time(monkeypatch, tmp_path, cache_env)

A source carrying an old archive mtime is not self-purged on store.

shutil.copy2 preserves the source mtime, which for a binary extracted from a release archive is the upstream build date. auto_purge ages entries by mtime, so without a fresh timestamp the auto_purge call inside store_binary would delete the entry it just stored.

tests.test_cache.test_store_binary_unwritable_cache_returns_none(tmp_path, cache_env)

An unwritable cache root degrades to None instead of raising.

Matches the fail-soft contract of store_response and store_config: the caller falls back to its staging copy.

tests.test_cache.test_cache_info_empty(cache_env)

Returns empty list when cache is empty.

tests.test_cache.test_cache_info_lists_entries(tmp_path, cache_env)

Returns all cached entries with correct metadata.

tests.test_cache.test_clear_cache_all(tmp_path, cache_env)

clear_cache() removes all entries.

tests.test_cache.test_clear_cache_specific_tool(tmp_path, cache_env)

clear_cache(tool=…) removes only matching tool.

tests.test_cache.test_clear_cache_max_age(tmp_path, cache_env)

clear_cache(max_age_days=…) removes only old entries.

tests.test_cache.test_clear_cache_prunes_empty_dirs(tmp_path, cache_env)

clear_cache removes empty parent directories after deletion.

tests.test_cache.test_auto_purge_removes_old_entries(monkeypatch, tmp_path, cache_env)

auto_purge removes entries older than REPOMATIC_CACHE_MAX_AGE.

tests.test_cache.test_auto_purge_disabled_when_zero(tmp_path, cache_env)

auto_purge does nothing when REPOMATIC_CACHE_MAX_AGE=0.

tests.test_cache.test_auto_purge_keeps_fresh_entries(monkeypatch, tmp_path, cache_env)

auto_purge keeps entries newer than the threshold.

tests.test_cache.test_max_age_days_default(monkeypatch)

Returns CacheConfig.max_age when env var is not set.

tests.test_cache.test_max_age_days_custom(monkeypatch)

Reads integer from REPOMATIC_CACHE_MAX_AGE.

tests.test_cache.test_max_age_days_zero_disables(monkeypatch)

REPOMATIC_CACHE_MAX_AGE=0 disables auto-purge.

tests.test_cache.test_max_age_days_invalid_fallback(monkeypatch)

Invalid value falls back to default with a warning.

tests.test_cache.test_prune_empty_dirs(tmp_path)

Removes empty nested directories but preserves root.

tests.test_cache.test_prune_empty_dirs_preserves_nonempty(tmp_path)

Preserves directories that contain files.

tests.test_cache.test_store_and_get_cached_response(cache_env)

Round-trip: store a response, then retrieve it.

tests.test_cache.test_get_cached_response_zero_ttl(cache_env)

TTL=0 bypasses cache entirely.

tests.test_cache.test_get_cached_response_negative_ttl(cache_env)

Negative TTL bypasses cache entirely.

tests.test_cache.test_get_cached_response_missing(cache_env)

Returns None when no cached response exists.

tests.test_cache.test_get_cached_response_stale(cache_env)

Returns None when cached response is older than max_age_seconds.

tests.test_cache.test_store_response_nested_key(cache_env)

Keys with slashes create nested directories.

tests.test_cache.test_http_cache_info_lists_entries(cache_env)

http_cache_info returns all cached responses.

tests.test_cache.test_http_cache_info_empty(cache_env)

Returns empty list when HTTP cache is empty.

tests.test_cache.test_clear_http_cache_all(cache_env)

clear_http_cache() removes all HTTP entries.

tests.test_cache.test_clear_http_cache_by_namespace(cache_env)

clear_http_cache(namespace=…) removes only matching namespace.

tests.test_cache.test_clear_http_cache_by_age(cache_env)

clear_http_cache(max_age_days=…) removes only old entries.