merge: testing → main (reconcile 2-week divergence)

decnet/geoip/paths.py

@@ -0,0 +1,19 @@
+"""Filesystem layout for GeoIP data.
+
+``GEOIP_ROOT`` is where providers drop their raw files and cache indexes.
+Default ``/var/lib/decnet/geoip`` — ``decnet init`` seeds the directory
+with ``decnet:decnet`` ownership, mode 0755. Override with
+``DECNET_GEOIP_ROOT`` for test harnesses.
+"""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+GEOIP_ROOT = Path(os.environ.get("DECNET_GEOIP_ROOT", "/var/lib/decnet/geoip"))
+
+
+def ensure_root() -> Path:
+    """Create ``GEOIP_ROOT`` if absent and return it. No-op if present."""
+    GEOIP_ROOT.mkdir(parents=True, exist_ok=True)
+    return GEOIP_ROOT