Update ash_animator/__init__.py

ash_animator/__init__.py

@@ -1,4 +1,41 @@
 
+# cache_setup.py
+
+import os
+import tempfile
+
+def setup_safe_cache(app_name="my_app"):
+    """
+    Redirects all common cache/config directories to a writable location
+    to avoid permission issues (e.g., in Docker, servers, CI).
+
+    Must be called before importing:
+    - matplotlib
+    - cartopy
+    - contextily
+    - any internal modules using those libraries
+    """
+
+    # Define root cache location
+    cache_root = os.path.join(tempfile.gettempdir(), f"{app_name}_cache")
+
+    # Map of environment variables to subdirectories
+    cache_paths = {
+        "XDG_CACHE_HOME": os.path.join(cache_root, "xdg_cache"),
+        "XDG_CONFIG_HOME": os.path.join(cache_root, "xdg_config"),
+        "MPLCONFIGDIR": os.path.join(cache_root, "matplotlib"),
+        "CARTOPY_USER_BACKGROUNDS": os.path.join(cache_root, "cartopy"),
+        "CARTOPY_CACHE_DIR": os.path.join(cache_root, "cartopy"),
+    }
+
+    # Apply environment variable overrides and ensure directories exist
+    for var, path in cache_paths.items():
+        os.environ[var] = path
+        os.makedirs(path, exist_ok=True)
+
+    print(f"✅ Cache directories set under: {cache_root}")
+
+setup_safe_cache("ash_animator")  # You can pass your app name 
 # Auto-generated __init__.py to import all modules
 from .basemaps import *
 from .converter import *