mapchete-eo 2025.10.1__py2.py3-none-any.whl → 2026.1.0__py2.py3-none-any.whl

mapchete_eo/io/items.py

@@ -1,15 +1,15 @@
 import logging
-from typing import Any, List, Optional
+from typing import Any, List, Optional, Tuple, Union
 
 import numpy.ma as ma
 import pystac
+from mapchete.geometry import repair_antimeridian_geometry
 from mapchete.protocols import GridProtocol
 from mapchete.types import Bounds, NodataVals
 from rasterio.enums import Resampling
 from shapely.geometry import mapping, shape
 
 from mapchete_eo.exceptions import EmptyProductException
-from mapchete_eo.geometry import repair_antimeridian_geometry
 from mapchete_eo.io.assets import asset_to_np_array
 from mapchete_eo.types import BandLocation
 
@@ -69,7 +69,8 @@ def expand_params(param: Any, length: int) -> List[Any]:
 
 def get_item_property(
     item: pystac.Item,
-    property: str,
+    property: Union[str, Tuple[str, ...]],
+    default: Any = None,
 ) -> Any:
     """
     Return item property.
@@ -104,28 +105,40 @@ def get_item_property(
     | ``collection``     | The collection ID of an Item's collection.             |
     +--------------------+--------------------------------------------------------+
     """
-    if property == "id":
-        return item.id
-    elif property in ["year", "month", "day", "date", "datetime"]:
-        if item.datetime is None:  # pragma: no cover
-            raise ValueError(
-                f"STAC item has no datetime attached, thus cannot get property {property}"
-            )
-        elif property == "date":
-            return item.datetime.date().isoformat()
-        elif property == "datetime":
-            return item.datetime
+
+    def _get_item_property(item: pystac.Item, property: str) -> Any:
+        if property == "id":
+            return item.id
+        elif property in ["year", "month", "day", "date", "datetime"]:
+            if item.datetime is None:  # pragma: no cover
+                raise ValueError(
+                    f"STAC item has no datetime attached, thus cannot get property {property}"
+                )
+            elif property == "date":
+                return item.datetime.date().isoformat()
+            elif property == "datetime":
+                return item.datetime
+            else:
+                return item.datetime.__getattribute__(property)
+        elif property == "collection":
+            return item.collection_id
+        elif property in item.properties:
+            return item.properties[property]
+        elif property in item.extra_fields:
+            return item.extra_fields[property]
+        elif property == "stac_extensions":
+            return item.stac_extensions
         else:
-            return item.datetime.__getattribute__(property)
-    elif property == "collection":
-        return item.collection_id
-    elif property in item.properties:
-        return item.properties[property]
-    elif property in item.extra_fields:
-        return item.extra_fields[property]
-    elif property == "stac_extensions":
-        return item.stac_extensions
+            raise KeyError
+
+    for prop in property if isinstance(property, tuple) else (property,):
+        try:
+            return _get_item_property(item, prop)
+        except KeyError:
+            pass
     else:
+        if default is not None:
+            return default
         raise KeyError(
             f"item {item.id} does not have property {property} in its datetime, properties "
             f"({', '.join(item.properties.keys())}) or extra_fields "

mapchete_eo/io/path.py

@@ -3,7 +3,7 @@ import logging
 from contextlib import contextmanager
 from enum import Enum
 from tempfile import TemporaryDirectory
-from typing import Generator
+from typing import Generator, Tuple, Union
 from xml.etree.ElementTree import Element, fromstring
 
 import fsspec
@@ -126,19 +126,30 @@ def cached_path(path: MPath, active: bool = True) -> Generator[MPath, None, None
 
 def asset_mpath(
     item: pystac.Item,
-    asset: str,
+    asset: Union[str, Tuple[str, ...]],
     fs: fsspec.AbstractFileSystem = None,
     absolute_path: bool = True,
 ) -> MPath:
     """Return MPath instance with asset href."""
 
-    try:
+    def _asset_mpath(
+        item: pystac.Item,
+        asset: str,
+        fs: fsspec.AbstractFileSystem = None,
+        absolute_path: bool = True,
+    ) -> MPath:
         asset_path = MPath(item.assets[asset].href, fs=fs)
-    except KeyError:
+        if absolute_path and not asset_path.is_absolute():
+            return MPath(item.get_self_href(), fs=fs).parent / asset_path
+        else:
+            return asset_path
+
+    for single_asset in asset if isinstance(asset, tuple) else (asset,):
+        try:
+            return _asset_mpath(item, single_asset, fs=fs, absolute_path=absolute_path)
+        except KeyError:
+            pass
+    else:
         raise AssetKeyError(
             f"{item.id} no asset named '{asset}' found in assets: {', '.join(item.assets.keys())}"
         )
-    if absolute_path and not asset_path.is_absolute():
-        return MPath(item.get_self_href(), fs=fs).parent / asset_path
-    else:
-        return asset_path

mapchete_eo/io/products.py

@@ -29,7 +29,6 @@ from mapchete_eo.exceptions import (
     EmptyStackException,
     NoSourceProducts,
 )
-from mapchete_eo.io.items import get_item_property
 from mapchete_eo.protocols import EOProductProtocol
 from mapchete_eo.sort import SortMethodConfig
 from mapchete_eo.types import MergeMethod
@@ -118,7 +117,8 @@ def products_to_xarray(
         coords = {
             slice_axis_name: list(
                 np.array(
-                    [product.item.datetime for product in products], dtype=np.datetime64
+                    [product.get_property("datetime") for product in products],
+                    dtype=np.datetime64,
                 )
             )
         }
@@ -132,7 +132,6 @@ class Slice:
     """Combine multiple products into one slice."""
 
     name: Any
-    properties: dict
     products: Sequence[EOProductProtocol]
     datetime: datetime
 
@@ -151,21 +150,13 @@ class Slice:
 
         # calculate mean datetime
         timestamps = [
-            product.item.datetime.timestamp()
+            product.get_property("datetime").timestamp()
             for product in self.products
-            if product.item.datetime
+            if product.get_property("datetime")
         ]
         mean_timestamp = sum(timestamps) / len(timestamps)
         self.datetime = datetime.fromtimestamp(mean_timestamp)
 
-        # generate combined properties
-        self.properties = {}
-        for key in self.products[0].item.properties.keys():
-            try:
-                self.properties[key] = self.get_property(key)
-            except ValueError:
-                self.properties[key] = None
-
     def __repr__(self) -> str:
         return f"<Slice {self.name} ({len(self.products)} products)>"
 
@@ -178,6 +169,17 @@ class Slice:
 
         raise EmptySliceException
 
+    @property
+    def properties(self) -> Dict[str, Any]:
+        # generate combined properties
+        properties: Dict[str, Any] = {}
+        for key in self.products[0].item.properties.keys():
+            try:
+                properties[key] = self.get_property(key)
+            except ValueError:
+                properties[key] = None
+        return properties
+
     @contextmanager
     def cached(self) -> Generator[Slice, None, None]:
         """Clear caches and run garbage collector when context manager is closed."""
@@ -200,12 +202,9 @@ class Slice:
         ValueError is raised.
         """
         # if set of value hashes has a length of 1, all values are the same
-        values = [
-            get_hash(get_item_property(product.item, property=property))
-            for product in self.products
-        ]
+        values = [get_hash(product.get_property(property)) for product in self.products]
         if len(set(values)) == 1:
-            return get_item_property(self.products[0].item, property=property)
+            return self.products[0].get_property(property)
 
         raise ValueError(
             f"cannot get unique property {property} from products {self.products}"
@@ -238,7 +237,7 @@ def products_to_slices(
             grouped[product.get_property(group_by_property)].append(product)
         slices = [Slice(key, products) for key, products in grouped.items()]
     else:
-        slices = [Slice(product.item.id, [product]) for product in products]
+        slices = [Slice(product.id, [product]) for product in products]
 
     # also check if slices is even a list, otherwise it will raise an error
     if sort and slices:
@@ -268,7 +267,7 @@ def merge_products(
                 try:
                     yield product.read_np_array(**product_read_kwargs)
                 except (AssetKeyError, CorruptedProduct) as exc:
-                    logger.debug("skip product %s because of %s", product.item.id, exc)
+                    logger.warning("skip product %s because of %s", product.id, exc)
         except StopIteration:
             return
 
@@ -286,7 +285,7 @@ def merge_products(
             out = product.read_np_array(**product_read_kwargs)
             break
         except (AssetKeyError, CorruptedProduct) as exc:
-            logger.debug("skip product %s because of %s", product.item.id, exc)
+            logger.warning("skip product %s because of %s", product.id, exc)
     else:
         # we cannot do anything here, as all products are broken
         raise CorruptedSlice("all products are broken here")
@@ -378,7 +377,6 @@ def generate_slice_dataarrays(
     slices = products_to_slices(
         products, group_by_property=merge_products_by, sort=sort
     )
-
     logger.debug(
         "reading %s products in %s groups...",
         len(products),
@@ -418,8 +416,8 @@ def generate_slice_dataarrays(
                 )
             # if at least one slice can be yielded, the stack is not empty
             stack_empty = False
-        except (EmptySliceException, CorruptedSlice):
-            pass
+        except (EmptySliceException, CorruptedSlice) as exception:
+            logger.warning(exception)
 
     if stack_empty:
         raise EmptyStackException("all slices are empty")

mapchete_eo/platforms/sentinel2/__init__.py

@@ -4,7 +4,7 @@ from mapchete_eo.platforms.sentinel2.driver import (
     Sentinel2Cube,
     Sentinel2CubeGroup,
 )
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.product import S2Product
 
 __all__ = [

mapchete_eo/platforms/sentinel2/_mapper_registry.py

@@ -0,0 +1,89 @@
+from typing import List, Callable, Dict, Any, Optional
+
+from pystac import Item
+
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
+from mapchete_eo.platforms.sentinel2.types import DataArchive, MetadataArchive
+
+
+# decorators for mapper functions using the registry pattern #
+##############################################################
+ID_MAPPER_REGISTRY: Dict[Any, Callable[[Item], Item]] = {}
+STAC_METADATA_MAPPER_REGISTRY: Dict[Any, Callable[[Item], Item]] = {}
+S2METADATA_MAPPER_REGISTRY: Dict[Any, Callable[[Item], S2Metadata]] = {}
+
+MAPPER_REGISTRIES: Dict[str, Any] = {
+    "ID": ID_MAPPER_REGISTRY,
+    "STAC metadata": STAC_METADATA_MAPPER_REGISTRY,
+    "S2Metadata": S2METADATA_MAPPER_REGISTRY,
+}
+
+
+def _register_func(registry: Dict[str, Callable], key: Any, func: Callable):
+    if key in registry:
+        raise ValueError(f"{key} already registered in {registry}")
+    registry[key] = func
+
+
+def maps_item_id(from_collections: List[str]):
+    """
+    Decorator registering mapper to common ID.
+    """
+
+    def decorator(func):
+        # Use a tuple of the metadata as the key
+        # key = (path_type, version)
+        for collection in from_collections:
+            _register_func(registry=ID_MAPPER_REGISTRY, key=collection, func=func)
+        return func
+
+    return decorator
+
+
+def maps_stac_metadata(
+    from_collections: List[str], to_data_archives: Optional[List[DataArchive]] = None
+):
+    """
+    Decorator registering STAC metadata mapper.
+    """
+
+    def decorator(func):
+        # Use a tuple of the metadata as the key
+        for collection in from_collections:
+            if to_data_archives:
+                for data_archive in to_data_archives:
+                    _register_func(
+                        registry=STAC_METADATA_MAPPER_REGISTRY,
+                        key=(collection, data_archive),
+                        func=func,
+                    )
+            else:
+                _register_func(
+                    registry=STAC_METADATA_MAPPER_REGISTRY,
+                    key=collection,
+                    func=func,
+                )
+        return func
+
+    return decorator
+
+
+def creates_s2metadata(
+    from_collections: List[str], to_metadata_archives: List[MetadataArchive]
+):
+    """
+    Decorator registering S2Metadata creator.
+    """
+
+    def decorator(func):
+        # Use a tuple of the metadata as the key
+        for collection in from_collections:
+            for metadata_archive in to_metadata_archives:
+                _register_func(
+                    registry=S2METADATA_MAPPER_REGISTRY,
+                    key=(collection, metadata_archive),
+                    func=func,
+                )
+        return func
+
+    return decorator

mapchete_eo/platforms/sentinel2/brdf/correction.py

@@ -13,7 +13,7 @@ from rasterio.fill import fillnodata
 
 from mapchete_eo.exceptions import BRDFError
 from mapchete_eo.platforms.sentinel2.brdf.models import BRDFModels, get_model
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.types import (
     L2ABand,
     Resolution,

mapchete_eo/platforms/sentinel2/brdf/hls.py

@@ -16,7 +16,7 @@ from mapchete_eo.platforms.sentinel2.brdf.protocols import (
 )
 from mapchete_eo.platforms.sentinel2.brdf.config import L2ABandFParams, ModelParameters
 from mapchete_eo.platforms.sentinel2.brdf.sun_angle_arrays import get_sun_zenith_angles
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.types import L2ABand
 
 

mapchete_eo/platforms/sentinel2/brdf/models.py

@@ -12,7 +12,7 @@ from mapchete_eo.platforms.sentinel2.brdf.hls import HLS
 from mapchete_eo.platforms.sentinel2.brdf.ross_thick import RossThick
 
 # from mapchete_eo.platforms.sentinel2.brdf.hls2 import HLS2
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.types import L2ABand
 
 logger = logging.getLogger(__name__)

mapchete_eo/platforms/sentinel2/brdf/protocols.py

@@ -6,7 +6,7 @@ from mapchete.io.raster import ReferencedRaster
 import numpy as np
 from numpy.typing import DTypeLike
 
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.types import L2ABand
 
 

mapchete_eo/platforms/sentinel2/brdf/ross_thick.py

@@ -14,7 +14,7 @@ from mapchete_eo.platforms.sentinel2.brdf.protocols import (
 )
 from mapchete_eo.platforms.sentinel2.brdf.config import L2ABandFParams, ModelParameters
 from mapchete_eo.platforms.sentinel2.brdf.hls import _get_viewing_angles
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 from mapchete_eo.platforms.sentinel2.types import L2ABand
 
 

mapchete_eo/platforms/sentinel2/brdf/sun_angle_arrays.py

@@ -3,7 +3,7 @@ from typing import Tuple
 from fiona.transform import transform
 import numpy as np
 
-from mapchete_eo.platforms.sentinel2.metadata_parser import S2Metadata
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import S2Metadata
 
 
 def get_sun_zenith_angles(s2_metadata: S2Metadata) -> np.ndarray:

mapchete_eo/platforms/sentinel2/config.py

@@ -1,18 +1,19 @@
 from __future__ import annotations
 
-from typing import List, Optional, Union
+from typing import List, Optional, Union, Dict, Any
+import warnings
 
 from mapchete.path import MPathLike
-from pydantic import (
-    BaseModel,
-    ValidationError,
-    field_validator,
-)
+from pydantic import BaseModel, ValidationError, field_validator, model_validator
 
 from mapchete_eo.base import BaseDriverConfig
 from mapchete_eo.io.path import ProductPathGenerationMethod
-from mapchete_eo.platforms.sentinel2.archives import ArchiveClsFromString, AWSL2ACOGv1
 from mapchete_eo.platforms.sentinel2.brdf.config import BRDFModels
+from mapchete_eo.platforms.sentinel2.preconfigured_sources import (
+    KNOWN_SOURCES,
+    DEPRECATED_ARCHIVES,
+)
+from mapchete_eo.platforms.sentinel2.source import Sentinel2Source
 from mapchete_eo.platforms.sentinel2.types import (
     CloudType,
     ProductQIMaskResolution,
@@ -23,6 +24,9 @@ from mapchete_eo.search.config import StacSearchConfig
 from mapchete_eo.types import TimeRange
 
 
+default_source = Sentinel2Source.model_validate(KNOWN_SOURCES["EarthSearch"])
+
+
 class BRDFModelConfig(BaseModel):
     model: BRDFModels = BRDFModels.HLS
     bands: List[str] = ["blue", "green", "red", "nir"]
@@ -47,7 +51,7 @@ class BRDFSCLClassConfig(BRDFModelConfig):
                 out.append(value)
             elif isinstance(value, str):
                 out.append(SceneClassification[value])
-            else:
+            else:  # pragma: no cover
                 raise ValidationError("value must be mappable to SceneClassification")
         return out
 
@@ -107,10 +111,18 @@ class CacheConfig(BaseModel):
 class Sentinel2DriverConfig(BaseDriverConfig):
     format: str = "Sentinel-2"
     time: Union[TimeRange, List[TimeRange]]
-    archive: ArchiveClsFromString = AWSL2ACOGv1
-    cat_baseurl: Optional[MPathLike] = None
+
+    # new
+    source: List[Sentinel2Source] = [default_source]
+
+    # deprecated
+    # for backwards compatibility, archive should be converted to
+    # catalog & data_archive
+    # archive: ArchiveClsFromString = AWSL2ACOGv1
+    # cat_baseurl: Optional[MPathLike] = None
     search_index: Optional[MPathLike] = None
-    max_cloud_cover: float = 100.0
+
+    # custom params
     stac_config: StacSearchConfig = StacSearchConfig()
     first_granule_only: bool = False
     utm_zone: Optional[int] = None
@@ -118,6 +130,54 @@ class Sentinel2DriverConfig(BaseDriverConfig):
     brdf: Optional[BRDFConfig] = None
     cache: Optional[CacheConfig] = None
 
+    @model_validator(mode="before")
+    def deprecated_values(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        archive = values.pop("archive", None)
+        if archive:
+            warnings.warn(
+                "'archive' will be deprecated soon. Please use 'source'.",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+            if values.get("source") is None:
+                values["source"] = DEPRECATED_ARCHIVES[archive]
+
+        cat_baseurl = values.pop("cat_baseurl", None)
+        if cat_baseurl:  # pragma: no cover
+            warnings.warn(
+                "'cat_baseurl' will be deprecated soon. Please use 'catalog_type=static' in the source.",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+            if values.get("source", []):
+                raise ValueError(
+                    "deprecated cat_baseurl field found alongside sources."
+                )
+            values["source"] = [dict(collection=cat_baseurl, catalog_type="static")]
+
+        # add default source if necessary
+        sources = values.get("source", [])
+        if not sources:
+            values["source"] = [default_source.model_dump(exclude_none=True)]
+
+        max_cloud_cover = values.pop("max_cloud_cover", None)
+        if max_cloud_cover:  # pragma: no cover
+            warnings.warn(
+                "'max_cloud_cover' will be deprecated soon. Please use 'eo:cloud_cover<=...' in the source 'query' field.",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+            updated_sources = []
+            for source in values.get("source", []):
+                if source.get("query") is not None:
+                    raise ValueError(
+                        f"deprecated max_cloud_cover is set but also a query field is given in {source}"
+                    )
+                source["query"] = f"eo:cloud_cover<={max_cloud_cover}"
+                updated_sources.append(source)
+            values["source"] = updated_sources
+        return values
+
 
 class MaskConfig(BaseModel):
     # mask by footprint geometry
@@ -160,7 +220,7 @@ class MaskConfig(BaseModel):
                 out.append(value)
             elif isinstance(value, str):
                 out.append(SceneClassification[value])
-            else:
+            else:  # pragma: no cover
                 raise ValidationError("value must be mappable to SceneClassification")
         return out
 
@@ -175,7 +235,7 @@ class MaskConfig(BaseModel):
         elif isinstance(config, dict):
             return MaskConfig(**config)
 
-        else:
+        else:  # pragma: no cover
             raise TypeError(
                 f"mask configuration should either be a dictionary or a MaskConfig object, not {config}"
             )

mapchete_eo/platforms/sentinel2/driver.py

@@ -1,16 +1,11 @@
 from typing import Optional, List, Tuple
 
-from mapchete.geometry import reproject_geometry
-from mapchete.path import MPath
 from mapchete.types import NodataVal
 from rasterio.enums import Resampling
 
 from mapchete_eo import base
-from mapchete_eo.archives.base import Archive
 from mapchete_eo.platforms.sentinel2.config import Sentinel2DriverConfig
 from mapchete_eo.platforms.sentinel2.preprocessing_tasks import parse_s2_product
-from mapchete_eo.search.stac_static import STACStaticCatalog
-from mapchete_eo.settings import mapchete_eo_settings
 from mapchete_eo.types import MergeMethod
 
 METADATA: dict = {
@@ -42,37 +37,3 @@ class InputData(base.InputData):
     driver_config_model = Sentinel2DriverConfig
     params: Sentinel2DriverConfig
     input_tile_cls = Sentinel2Cube
-
-    def set_archive(self, base_dir: MPath):
-        if self.params.cat_baseurl:
-            self.archive = Archive(
-                catalog=STACStaticCatalog(
-                    baseurl=MPath(self.params.cat_baseurl).absolute_path(
-                        base_dir=base_dir
-                    ),
-                ),
-                area=self.bbox(mapchete_eo_settings.default_catalog_crs),
-                time=self.time,
-                search_kwargs=dict(max_cloud_cover=self.params.max_cloud_cover),
-            )
-        elif self.params.archive:
-            catalog_area = reproject_geometry(
-                self.area,
-                src_crs=self.crs,
-                dst_crs=mapchete_eo_settings.default_catalog_crs,
-            )
-            self.archive = self.params.archive(
-                time=self.time,
-                bounds=catalog_area.bounds,
-                area=catalog_area,
-                search_kwargs=dict(
-                    search_index=(
-                        MPath(self.params.search_index).absolute_path(base_dir=base_dir)
-                        if self.params.search_index
-                        else None
-                    ),
-                    max_cloud_cover=self.params.max_cloud_cover,
-                ),
-            )
-        else:
-            raise ValueError("either 'archive' or 'cat_baseurl' or both is required.")

mapchete_eo/platforms/sentinel2/metadata_parser/__init__.py

@@ -0,0 +1,6 @@
+from mapchete_eo.platforms.sentinel2.metadata_parser.s2metadata import (
+    S2Metadata,
+    S2MetadataPathMapper,
+)
+
+__all__ = ["S2Metadata", "S2MetadataPathMapper"]

mapchete_eo/platforms/sentinel2/{path_mappers → metadata_parser}/base.py

@@ -11,7 +11,7 @@ from mapchete_eo.platforms.sentinel2.types import (
 )
 
 
-class S2PathMapper(ABC):
+class S2MetadataPathMapper(ABC):
     """
     Abstract class to help mapping asset paths from metadata.xml to their
     locations of various data archives.

mapchete_eo/platforms/sentinel2/{path_mappers/metadata_xml.py → metadata_parser/default_path_mapper.py}

@@ -11,7 +11,7 @@ from typing import Optional
 from mapchete.path import MPath
 
 from mapchete_eo.io import open_xml
-from mapchete_eo.platforms.sentinel2.path_mappers.base import S2PathMapper
+from mapchete_eo.platforms.sentinel2.metadata_parser.base import S2MetadataPathMapper
 from mapchete_eo.platforms.sentinel2.processing_baseline import ProcessingBaseline
 from mapchete_eo.platforms.sentinel2.types import (
     BandQI,
@@ -23,7 +23,7 @@ from mapchete_eo.platforms.sentinel2.types import (
 logger = logging.getLogger(__name__)
 
 
-class XMLMapper(S2PathMapper):
+class XMLMapper(S2MetadataPathMapper):
     def __init__(
         self, metadata_xml: MPath, xml_root: Optional[Element] = None, **kwargs
     ):