rle-python 0.2.0__py3-none-any.whl

rle/core/__init__.py

@@ -0,0 +1,77 @@
+"""RLE core — IUCN Red List of Ecosystems analysis with local/cloud data access.
+
+This is the backend-agnostic core. It provides the RLE data model
+(``Ecosystems``, ``AOOGrid``, ``EOO``), the assessment business logic, and
+local + cloud-file (``gs://``, ``s3://`` via fsspec) data access.
+
+Earth Engine support lives in the optional ``rle-python-gee`` distribution
+(import ``rle.gee``).
+"""
+
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("rle-python")
+except PackageNotFoundError:
+    __version__ = "0.0.0.dev"
+
+from rle.core.ecosystems import (
+    Ecosystems,
+    EcosystemKind,
+    EcosystemsFile,
+    EcosystemsGeoParquet,
+    EcosystemsGeoDataFrame,
+    EcosystemsCOG,
+)
+from rle.core.eoo import (
+    EOO,
+    EOOVectorLocal,
+    EOONotComputedError,
+    make_eoo,
+)
+from rle.core.aoo import (
+    AOOGrid,
+    AOOGridVectorLocal,
+    AOOGridCOG,
+    AOOGridNotComputedError,
+    AOOGridPolygons,
+    AOOGridPolygonVectorLocal,
+    AOOGridPolygonsNotComputedError,
+    make_aoo_grid,
+    make_aoo_grid_cached,
+    make_aoo_polygons,
+    slugify_ecosystem_name,
+)
+from rle.core.registry import BackendInfo, iter_backends, list_backends
+
+__all__ = [
+    "__version__",
+    # data model
+    "Ecosystems",
+    "EcosystemKind",
+    "EcosystemsFile",
+    "EcosystemsGeoParquet",
+    "EcosystemsGeoDataFrame",
+    "EcosystemsCOG",
+    # EOO
+    "EOO",
+    "EOOVectorLocal",
+    "EOONotComputedError",
+    "make_eoo",
+    # AOO
+    "AOOGrid",
+    "AOOGridVectorLocal",
+    "AOOGridCOG",
+    "AOOGridNotComputedError",
+    "AOOGridPolygons",
+    "AOOGridPolygonVectorLocal",
+    "AOOGridPolygonsNotComputedError",
+    "make_aoo_grid",
+    "make_aoo_grid_cached",
+    "make_aoo_polygons",
+    "slugify_ecosystem_name",
+    # discovery
+    "BackendInfo",
+    "iter_backends",
+    "list_backends",
+]

rle/core/_entrypoints.py

@@ -0,0 +1,51 @@
+"""Entry-point registration for the core (local/cloud-file) backends."""
+
+from __future__ import annotations
+
+from rle.core.registry import BackendInfo
+
+
+def _is_geojson(data) -> bool:
+    return isinstance(data, str) and data.endswith((".geojson", ".json"))
+
+
+def _is_geoparquet(data) -> bool:
+    return isinstance(data, str) and data.endswith(".parquet")
+
+
+def _is_cog(data) -> bool:
+    return isinstance(data, str) and data.endswith((".tif", ".tiff"))
+
+
+def register() -> list[BackendInfo]:
+    """Advertise the local/cloud-file ecosystem backends provided by rle-python."""
+    from rle.core.ecosystems import (
+        EcosystemsFile,
+        EcosystemsGeoParquet,
+        EcosystemsCOG,
+    )
+
+    dist = "rle-python"
+    return [
+        BackendInfo(
+            name="file",
+            cls=EcosystemsFile,
+            capability="ecosystems",
+            distribution=dist,
+            can_handle=_is_geojson,
+        ),
+        BackendInfo(
+            name="geoparquet",
+            cls=EcosystemsGeoParquet,
+            capability="ecosystems",
+            distribution=dist,
+            can_handle=_is_geoparquet,
+        ),
+        BackendInfo(
+            name="cog",
+            cls=EcosystemsCOG,
+            capability="ecosystems",
+            distribution=dist,
+            can_handle=_is_cog,
+        ),
+    ]