canvod-store 0.2.0__py3-none-any.whl

canvod/store/__init__.py

@@ -0,0 +1,23 @@
+"""canvod-store: Icechunk storage for GNSS VOD data.
+
+This package provides versioned storage for GNSS VOD data using Icechunk.
+Manages both RINEX observation storage and VOD analysis results.
+"""
+
+from canvod.store.manager import GnssResearchSite
+from canvod.store.reader import IcechunkDataReader
+from canvod.store.store import (
+    MyIcechunkStore,
+    create_rinex_store,
+    create_vod_store,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "GnssResearchSite",
+    "IcechunkDataReader",
+    "MyIcechunkStore",
+    "create_rinex_store",
+    "create_vod_store",
+]

canvod/store/file_registry.py

@@ -0,0 +1,35 @@
+"""File registry (ingest ledger) helpers for Icechunk-backed stores.
+
+This module manages the per-file tracking table stored at
+``{group}/metadata/table`` inside an Icechunk store. Each row records
+a single ingested file: its hash, temporal range, filename, path, etc.
+
+**Not to be confused with** ``canvod.store_metadata`` (the separate package),
+which manages store-level provenance: identity, creator, environment,
+software versions, STAC/DataCite/ACDD compliance, etc.
+
+Terminology
+-----------
+- **File registry** (this module): *which files* went into a store group.
+- **Store metadata** (``canvod.store_metadata``): *who/what/when/how* about
+  the store as a whole.
+"""
+
+from typing import Any
+
+from canvodpy.logging import get_logger
+
+
+class FileRegistryManager:
+    """Manage file registry table CRUD, backups, and deduplication for groups.
+
+    Parameters
+    ----------
+    logger : Any, optional
+        Logger-like object to use. Defaults to the configured context logger.
+    """
+
+    def __init__(self, logger: Any | None = None) -> None:
+        self._logger = logger or get_logger(__name__)
+
+    # TODO: Future refactor — extract metadata table methods from MyIcechunkStore.

canvod/store/grid_adapters/__init__.py

@@ -0,0 +1,9 @@
+"""Grid adapters for hemisphere grid storage in Icechunk."""
+
+# These will be enabled when canvod-grids is migrated
+# from canvod.store.grid_adapters.complete_grid_vod_workflow import (
+#     store_grid_to_vod_store,
+#     load_grid_from_vod_store,
+# )
+
+__all__ = []