CLI — Aquilia Documentation
Comprehensive guide and documentation for CLI in the Aquilia framework. View API reference, examples, and implementation patterns.
Cache / CLI Cache CLI Aquilia exposes cache management via the aq cache command group. Commands are registered in aquilia/cli/__main__.py and implemented in aquilia/cli/commands/cache.py. Command Surface Command Description ))} aq cache check Loads cache config and prints key settings (backend, TTL, serializer, key prefix, and backend-specific details). For the Redis backend, it attempts a synchronous ping query to verify network connectivity. aq cache check aq cache check -v aq cache inspect Outputs cache configuration as JSON. It first attempts to load from the workspace module and falls back to ConfigLoader defaults. aq cache inspect aq cache inspect -v aq cache stats Builds a temporary CacheService and initializes it, then attempts to retrieve and display statistics from the active cache backend. aq cache stats aq cache stats -v Warning: The stats command expects the backend cache service to expose an info() call. Because CacheService uses stats(), this command output may be empty for some backends. aq cache clear Creates a temporary CacheService from config, initializes it, clears all entries or a single namespace, then shuts down the temporary service. # Clear all keys aq cache clear # Clear one namespace aq cache clear --namespace http Config Loading Logic def _load_cache_config() -> dict: # 1) workspace.py -> workspace.to_dict() -> cache or integrations.cache # 2) fallback ConfigLoader().get_cache_config() Operational Caveats • The check command expects nested config structures in the validation output paths, while standard cache configuration variables are flat. • CLI commands run in their own ephemeral process context. They do not hook into or share the in-memory cache allocations of separate running application server instances. )
Go to Homepage