refactor(dataset): extract common code into methods

src/GOES_DL/dataset/base/locator_gg.py

@@ -246,3 +246,42 @@ def timestamp_to_datetime(self, timestamp: str) -> datetime:
         )
 
         return file_date.astimezone(timezone.utc)
+
+    @staticmethod
+    def _validate_entity(
+        name: str, entity: str, available_entities: dict[str, str] | set[str]
+    ) -> None:
+        if entity not in available_entities:
+            supported_entities: list[str] = sorted(available_entities)
+            raise ValueError(
+                f"Invalid {name} ID: '{entity}'. "
+                f"Available {name} IDs: {supported_entities}"
+            )
+
+    @classmethod
+    def _validate_instrument(
+        cls, instrument: str, available_instruments: dict[str, str]
+    ) -> None:
+        cls._validate_entity("instrument", instrument, available_instruments)
+
+    @classmethod
+    def _validate_level(cls, level: str, available_levels: set[str]) -> None:
+        cls._validate_entity("level", level, available_levels)
+
+    @classmethod
+    def _validate_origin(
+        cls, origin: str, available_origins: dict[str, str]
+    ) -> None:
+        cls._validate_entity("origin", origin, available_origins)
+
+    @classmethod
+    def _validate_product(
+        cls, name: str, available_products: dict[str, str]
+    ) -> None:
+        cls._validate_entity("product", name, available_products)
+
+    @classmethod
+    def _validate_scene(
+        cls, scene: str, available_scenes: dict[str, str]
+    ) -> None:
+        cls._validate_entity("scene", scene, available_scenes)

src/GOES_DL/dataset/goes/locator.py

@@ -214,28 +214,9 @@ def __init__(
         # TODO: Too many positional arguments. Solve it by using
         #       the Builder or Factory methods, or patterns like
         #       Essence or Fluent.
-        if origin not in self.AVAILABLE_ORIGINS:
-            available_origins: list[str] = sorted(self.AVAILABLE_ORIGINS)
-            raise ValueError(
-                f"Invalid origin ID: '{origin}'. "
-                f"Available origin IDs: {available_origins}"
-            )
-
-        if instrument not in self.AVAILABLE_INSTRUMENTS:
-            available_instruments: list[str] = sorted(
-                self.AVAILABLE_INSTRUMENTS
-            )
-            raise ValueError(
-                f"Invalid instrument ID: '{instrument}'. "
-                f"Available instrument IDs: {available_instruments}"
-            )
-
-        if level not in self.AVAILABLE_LEVELS:
-            available_levels: list[str] = sorted(self.AVAILABLE_LEVELS)
-            raise ValueError(
-                f"Invalid level ID: '{level}'. "
-                f"Available level IDs: {available_levels}"
-            )
+        self._validate_origin(origin, self.AVAILABLE_ORIGINS)
+        self._validate_instrument(instrument, self.AVAILABLE_INSTRUMENTS)
+        self._validate_level(level, self.AVAILABLE_LEVELS)
 
         self.name: str = name
         self.level: str = level

src/GOES_DL/dataset/goes/locator_abi.py

@@ -87,12 +87,8 @@ def __init__(
         # TODO: Too many positional arguments. Solve it by using
         #       the Builder or Factory methods, or patterns like
         #       Essence or Fluent.
-        if scene not in self.AVAILABLE_SCENES:
-            available_scenes: list[str] = sorted(self.AVAILABLE_SCENES)
-            raise ValueError(
-                f"Invalid scene ID: '{scene}'. "
-                f"Available scene IDs: {available_scenes}"
-            )
+        self._validate_scene(scene, self.AVAILABLE_SCENES)
+
         scan_modes: list[str] = (
             self.F_MODES if scene == self.FULL_DISK else self.CM_MODES
         )

src/GOES_DL/dataset/goes/locator_dc.py

@@ -64,12 +64,7 @@ def __init__(
         ValueError
             If the provided product name is invalid.
         """
-        if name not in self.AVAILABLE_PRODUCTS:
-            supported_products: list[str] = sorted(self.AVAILABLE_PRODUCTS)
-            raise ValueError(
-                f"Invalid product ID: '{name}'. "
-                f"Available product IDs: {supported_products}"
-            )
+        self._validate_product(name, self.AVAILABLE_PRODUCTS)
 
         if isinstance(channels, str):
             channels = [channels]

src/GOES_DL/dataset/goes/locator_dp.py

@@ -113,12 +113,7 @@ def __init__(self, name: str, scene: str, origin: str) -> None:
             dataset directories are organised, only a single origin may
             be provided.
         """
-        if name not in self.AVAILABLE_PRODUCTS:
-            supported_products: list[str] = sorted(self.AVAILABLE_PRODUCTS)
-            raise ValueError(
-                f"Invalid product ID: '{name}'. "
-                f"Available product IDs: {supported_products}"
-            )
+        self._validate_product(name, self.AVAILABLE_PRODUCTS)
 
         only_in_segment: list[set[str]] = [
             self.ONLY_CF_SCENE,

src/GOES_DL/dataset/goes/locator_glm.py

@@ -48,12 +48,7 @@ def __init__(self, name: str, origin: str) -> None:
         ValueError
             If the provided product name is invalid.
         """
-        if name not in self.AVAILABLE_PRODUCTS:
-            available_products: list[str] = sorted(self.AVAILABLE_PRODUCTS)
-            raise ValueError(
-                f"Invalid product ID: '{name}'. "
-                f"Available product IDs: {available_products}"
-            )
+        self._validate_product(name, self.AVAILABLE_PRODUCTS)
 
         super().__init__(
             name=name,

src/GOES_DL/dataset/goes/locator_pm.py

@@ -45,12 +45,7 @@ def __init__(self, name: str, scene: str, origin: str) -> None:
             dataset directories are organised, only a single origin may
             be provided.
         """
-        if name not in self.AVAILABLE_PRODUCTS:
-            supported_products: list[str] = sorted(self.AVAILABLE_PRODUCTS)
-            raise ValueError(
-                f"Invalid product ID: '{name}'. "
-                f"Available product IDs: {supported_products}"
-            )
+        self._validate_product(name, self.AVAILABLE_PRODUCTS)
 
         super().__init__(
             name=name,

src/GOES_DL/dataset/goes/locator_pp.py

@@ -76,12 +76,7 @@ def __init__(
                 f"Supported channels: {supported_channels}"
             )
 
-        if name not in self.AVAILABLE_PRODUCTS:
-            supported_products: list[str] = sorted(self.AVAILABLE_PRODUCTS)
-            raise ValueError(
-                f"Invalid product ID: '{name}'. "
-                f"Available product IDs: {supported_products}"
-            )
+        self._validate_product(name, self.AVAILABLE_PRODUCTS)
 
         level: str = (
             self.LEVEL_RAD if name == self.PRODUCT_RAD else self.LEVEL_NOT_RAD

src/GOES_DL/dataset/gridsat/locator_gc.py

@@ -183,12 +183,7 @@ def __init__(
         ValueError
             If the provided origin, scene, or version is invalid.
         """
-        if scene not in self.AVAILABLE_SCENES:
-            available_scenes: list[str] = sorted(self.AVAILABLE_SCENES)
-            raise ValueError(
-                f"Invalid scene ID: '{scene}'. "
-                f"Available scene IDs: {available_scenes}"
-            )
+        self._validate_scene(scene, self.AVAILABLE_SCENES)
 
         if isinstance(origins, str):
             origins = [origins]