eodag 4.0.0a5__py3-none-any.whl → 4.0.0b1__py3-none-any.whl

eodag/cli.py

@@ -123,14 +123,14 @@ def _deprecated_cli(message: str, version: Optional[str] = None) -> Callable[...
     help="Control the verbosity of the logs. For maximum verbosity, type -vvv",
 )
 @click.pass_context
-def eodag(ctx: Context, verbose: int) -> None:
+def eodag_cli(ctx: Context, verbose: int) -> None:
     """Earth Observation Data Access Gateway: work on EO products from any provider"""
     if ctx.obj is None:
         ctx.obj = {}
     ctx.obj["verbosity"] = verbose
 
 
-@eodag.command(name="version", help="Print eodag version and exit")
+@eodag_cli.command(name="version", help="Print eodag version and exit")
 def version() -> None:
     """Print eodag version and exit"""
     click.echo(
@@ -142,7 +142,7 @@ def version() -> None:
     )
 
 
-@eodag.command(
+@eodag_cli.command(
     name="search",
     help="Search satellite images by their collections, instruments, constellation, "
     "platform, processing level or sensor type. It is mandatory to provide "
@@ -407,7 +407,7 @@ def search_crunch(ctx: Context, **kwargs: Any) -> None:
     ctx.obj["search_results"] = results
 
 
-@eodag.command(name="list", help="List supported collections")
+@eodag_cli.command(name="list", help="List supported collections")
 @click.option("-p", "--provider", help="List collections supported by this provider")
 @click.option(
     "--instruments", help="List collections originating from these instruments"
@@ -489,7 +489,7 @@ def list_col(ctx: Context, **kwargs: Any) -> None:
         sys.exit(1)
 
 
-@eodag.command(name="discover", help="Fetch providers to discover collections")
+@eodag_cli.command(name="discover", help="Fetch providers to discover collections")
 @click.option("-p", "--provider", help="Fetch only the given provider")
 @click.option(
     "--storage",
@@ -520,7 +520,7 @@ def discover_col(ctx: Context, **kwargs: Any) -> None:
     click.echo("Results stored at '{}'".format(storage_filepath))
 
 
-@eodag.command(
+@eodag_cli.command(
     help="""Download a list of products from a serialized search result or STAC items URLs/paths
 
 Examples:
@@ -626,4 +626,4 @@ def download(ctx: Context, **kwargs: Any) -> None:
 
 
 if __name__ == "__main__":
-    eodag(obj={})
+    eodag_cli(obj={})

eodag/config.py

@@ -20,7 +20,7 @@ from __future__ import annotations
 import logging
 import os
 from importlib.resources import files as res_files
-from typing import TYPE_CHECKING, Annotated, Any, Literal, Optional, TypedDict, Union
+from typing import TYPE_CHECKING, Annotated, Any, Literal, Optional, Union
 
 import orjson
 import requests
@@ -28,6 +28,7 @@ import yaml
 import yaml.parser
 from annotated_types import Gt
 from jsonpath_ng import JSONPath
+from typing_extensions import TypedDict
 
 from eodag.utils import (
     HTTP_REQ_TIMEOUT,
@@ -635,12 +636,29 @@ class PluginConfig(yaml.YAMLObject):
         matching_conf = getattr(self, "matching_conf", {})
         matching_url = getattr(self, "matching_url", None)
 
-        if target_matching_conf and sort_dict(target_matching_conf) == sort_dict(
-            matching_conf
+        # both match
+        if (
+            target_matching_conf
+            and sort_dict(target_matching_conf) == sort_dict(matching_conf)
+            and target_matching_url
+            and target_matching_url == matching_url
         ):
             return True
 
-        if target_matching_url and target_matching_url == matching_url:
+        # conf matches and no matching_url expected
+        if (
+            target_matching_conf
+            and sort_dict(target_matching_conf) == sort_dict(matching_conf)
+            and not target_matching_url
+        ):
+            return True
+
+        # url matches and no matching_conf expected
+        if (
+            target_matching_url
+            and target_matching_url == matching_url
+            and not target_matching_conf
+        ):
             return True
 
         return False

eodag/plugins/download/aws.py

@@ -771,7 +771,9 @@ class AwsDownload(Download):
             ignore_assets,
             product,
         )
-        if auth and isinstance(auth, boto3.resource("s3").__class__):
+
+        # check if auth is a S3 resource by verifying it has the meta.client attribute.
+        if auth and hasattr(auth, "meta") and hasattr(auth.meta, "client"):
             s3_resource = auth
         else:
             s3_resource = boto3.resource(

eodag/plugins/download/http.py

@@ -27,16 +27,7 @@ from email.message import Message
 from itertools import chain
 from json import JSONDecodeError
 from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Iterator,
-    Literal,
-    Optional,
-    TypedDict,
-    Union,
-    cast,
-)
+from typing import TYPE_CHECKING, Any, Iterator, Literal, Optional, Union, cast
 from urllib.parse import parse_qs, urlparse
 
 import geojson
@@ -46,6 +37,7 @@ from lxml import etree
 from requests import RequestException
 from requests.auth import AuthBase
 from requests.structures import CaseInsensitiveDict
+from typing_extensions import TypedDict
 from zipstream import ZipStream
 
 from eodag.api.product.metadata_mapping import (
@@ -476,6 +468,8 @@ class HTTPDownload(Download):
         if (
             success_status and success_status != status_dict.get("eodag:order_status")
         ) or (success_code and success_code != response.status_code):
+            # Remove the download link if the order has not been completed or was not successful
+            product.properties.pop("eodag:download_link", None)
             return None
 
         product.properties["order:status"] = ONLINE_STATUS

eodag/plugins/search/base.py

@@ -35,6 +35,7 @@ from eodag.plugins.search import PreparedSearch
 from eodag.types import model_fields_to_annotated
 from eodag.types.queryables import Queryables, QueryablesDict
 from eodag.types.search_args import SortByList
+from eodag.types.stac_metadata import CommonStacMetadata, create_stac_metadata_model
 from eodag.utils import (
     GENERIC_COLLECTION,
     copy_deepcopy,
@@ -358,7 +359,7 @@ class Search(PluginTopic):
             queryables = self.discover_queryables(**{**default_values, **filters}) or {}
         except NotImplementedError as e:
             if str(e):
-                logger.debug(str(e))
+                logger.debug("%s, configured metadata-mapping used", str(e))
             queryables = self.queryables_from_metadata_mapping(collection, alias)
 
         return QueryablesDict(**queryables)
@@ -408,9 +409,10 @@ class Search(PluginTopic):
                 col_queryables = self._get_collection_queryables(col, None, filters)
                 all_queryables.update(col_queryables)
             # reset defaults because they may vary between collections
+            queryables_fields = Queryables.from_stac_models().model_fields
             for k, v in all_queryables.items():
                 v.__metadata__[0].default = getattr(
-                    Queryables.model_fields.get(k, Field(None)), "default", None
+                    queryables_fields.get(k, Field(None)), "default", None
                 )
             return QueryablesDict(
                 additional_properties=auto_discovery,
@@ -468,8 +470,11 @@ class Search(PluginTopic):
             ):
                 del metadata_mapping[param]
 
+        queryables_model = create_stac_metadata_model(
+            base_models=[Queryables, CommonStacMetadata]
+        )
         eodag_queryables = copy_deepcopy(
-            model_fields_to_annotated(Queryables.model_fields)
+            model_fields_to_annotated(queryables_model.model_fields)
         )
         queryables["collection"] = eodag_queryables.pop("collection")
         # add default value for collection

eodag/plugins/search/build_search_result.py

@@ -21,9 +21,9 @@ import hashlib
 import logging
 import re
 from collections import OrderedDict
-from datetime import date, datetime, timedelta, timezone
+from datetime import datetime, timedelta
 from types import MethodType
-from typing import TYPE_CHECKING, Annotated, Any, Optional, Union
+from typing import TYPE_CHECKING, Annotated, Any, Optional
 from urllib.parse import quote_plus, unquote_plus
 
 import geojson
@@ -31,6 +31,7 @@ import orjson
 from dateutil.parser import isoparse
 from dateutil.tz import tzutc
 from dateutil.utils import today
+from pydantic import AliasChoices
 from pydantic.fields import FieldInfo
 from requests.auth import AuthBase
 from typing_extensions import get_args  # noqa: F401
@@ -58,10 +59,18 @@ from eodag.utils import (
     format_string,
     get_geometry_from_ecmwf_area,
     get_geometry_from_ecmwf_feature,
+    get_geometry_from_ecmwf_location,
     get_geometry_from_various,
 )
 from eodag.utils.cache import instance_cached_method
-from eodag.utils.dates import is_range_in_range
+from eodag.utils.dates import (
+    COMPACT_DATE_RANGE_PATTERN,
+    DATE_RANGE_PATTERN,
+    format_date,
+    is_range_in_range,
+    parse_date,
+    parse_year_month_day,
+)
 from eodag.utils.exceptions import DownloadError, NotAvailableError, ValidationError
 from eodag.utils.requests import fetch_json
 
@@ -184,6 +193,7 @@ COP_DS_KEYWORDS = {
     "region",
     "release_version",
     "satellite",
+    "satellite_mission",
     "sensor",
     "sensor_and_algorithm",
     "soil_level",
@@ -285,6 +295,27 @@ def _update_properties_from_element(
     if element["type"] == "DateRangeWidget":
         prop["description"] = "date formatted like yyyy-mm-dd/yyyy-mm-dd"
 
+    # a single geographic location
+    if element["type"] == "GeographicLocationWidget":
+        prop.update(
+            {
+                "type": "object",
+                "description": "Longitude and latitude of a single location",
+                "properties": {
+                    "longitude": {
+                        "type": "number",
+                        "maximum": 180,
+                        "minimum": -180,
+                    },
+                    "latitude": {
+                        "type": "number",
+                        "maximum": 90,
+                        "minimum": -90,
+                    },
+                },
+            }
+        )
+
     if description := element.get("help"):
         prop["description"] = description
 
@@ -307,93 +338,6 @@ def ecmwf_format(v: str, alias: bool = True) -> str:
     return f"{ECMWF_PREFIX[:-1]}{separator}{v}" if v in ALLOWED_KEYWORDS else v
 
 
-def get_min_max(
-    value: Optional[Union[str, list[str]]] = None,
-) -> tuple[Optional[str], Optional[str]]:
-    """Returns the min and max from a list of strings or the same string if a single string is given."""
-    if isinstance(value, list):
-        sorted_values = sorted(value)
-        return sorted_values[0], sorted_values[-1]
-    return value, value
-
-
-def append_time(input_date: date, time: Optional[str]) -> datetime:
-    """
-    Parses a time string in format HHMM and appends it to a date.
-
-    if the time string is in format HH:MM or HH_MM we convert it to HHMM
-    """
-    if not time:
-        time = "0000"
-    time = re.sub(":|_", "", time)
-    if time == "2400":
-        time = "0000"
-    dt = datetime.combine(input_date, datetime.strptime(time, "%H%M").time())
-    dt.replace(tzinfo=timezone.utc)
-    return dt
-
-
-def parse_date(
-    date: str, time: Optional[Union[str, list[str]]]
-) -> tuple[datetime, datetime]:
-    """Parses a date string in formats YYYY-MM-DD, YYYMMDD, solo or in start/end or start/to/end intervals."""
-    if "to" in date:
-        start_date_str, end_date_str = date.split("/to/")
-    elif "/" in date:
-        dates = date.split("/")
-        start_date_str = dates[0]
-        end_date_str = dates[-1]
-    else:
-        start_date_str = end_date_str = date
-
-    # Update YYYYMMDD formatted dates
-    if re.match(r"^\d{8}$", start_date_str):
-        start_date_str = (
-            f"{start_date_str[:4]}-{start_date_str[4:6]}-{start_date_str[6:]}"
-        )
-    if re.match(r"^\d{8}$", end_date_str):
-        end_date_str = f"{end_date_str[:4]}-{end_date_str[4:6]}-{end_date_str[6:]}"
-
-    start_date = datetime.fromisoformat(start_date_str.rstrip("Z"))
-    end_date = datetime.fromisoformat(end_date_str.rstrip("Z"))
-
-    if time:
-        start_t, end_t = get_min_max(time)
-        start_date = append_time(start_date.date(), start_t)
-        end_date = append_time(end_date.date(), end_t)
-
-    return start_date, end_date
-
-
-def parse_year_month_day(
-    year: Union[str, list[str]],
-    month: Optional[Union[str, list[str]]] = None,
-    day: Optional[Union[str, list[str]]] = None,
-    time: Optional[Union[str, list[str]]] = None,
-) -> tuple[datetime, datetime]:
-    """Extracts and returns the year, month, day, and time from the parameters."""
-
-    def build_date(year, month=None, day=None, time=None) -> datetime:
-        """Datetime from default_date with updated year, month, day and time."""
-        updated_date = datetime(int(year), 1, 1).replace(
-            month=int(month) if month is not None else 1,
-            day=int(day) if day is not None else 1,
-        )
-        if time is not None:
-            updated_date = append_time(updated_date.date(), time)
-        return updated_date
-
-    start_y, end_y = get_min_max(year)
-    start_m, end_m = get_min_max(month)
-    start_d, end_d = get_min_max(day)
-    start_t, end_t = get_min_max(time)
-
-    start_date = build_date(start_y, start_m, start_d, start_t)
-    end_date = build_date(end_y, end_m, end_d, end_t)
-
-    return start_date, end_date
-
-
 def ecmwf_temporal_to_eodag(
     params: dict[str, Any]
 ) -> tuple[Optional[str], Optional[str]]:
@@ -627,6 +571,12 @@ class ECMWFSearch(PostJsonSearch):
         if getattr(self.config, "dates_required", False):
             self._check_date_params(params, collection)
 
+        # read 'start_datetime' and 'end_datetime' from 'date' range
+        if "date" in params:
+            start_date, end_date = parse_date(params["date"])
+            params[START] = format_date(start_date)
+            params[END] = format_date(end_date)
+
         # adapt end date if it is midnight
         if END in params:
             end_date_excluded = getattr(self.config, "end_date_excluded", True)
@@ -666,6 +616,10 @@ class ECMWFSearch(PostJsonSearch):
         if "area" in params:
             params["geometry"] = get_geometry_from_ecmwf_area(params["area"])
             params.pop("area")
+        # single location
+        if "location" in params:
+            params["geometry"] = get_geometry_from_ecmwf_location(params["location"])
+            params.pop("location")
 
         return params
 
@@ -870,9 +824,7 @@ class ECMWFSearch(PostJsonSearch):
                 )
                 not in set(list(available_values.keys()) + [f["name"] for f in form])
             ):
-                raise ValidationError(
-                    f"'{keyword}' is not a queryable parameter", {keyword}
-                )
+                raise ValidationError("'%s' is not a queryable parameter" % keyword)
 
         # generate queryables
         if form:
@@ -890,7 +842,7 @@ class ECMWFSearch(PostJsonSearch):
         # start and end filters are supported whenever combinations of "year", "month", "day" filters exist
         queryable_prefix = f"{ECMWF_PREFIX[:-1]}_"
         if (
-            queryables.pop(f"{queryable_prefix}date", None)
+            f"{queryable_prefix}date" in queryables
             or f"{queryable_prefix}year" in queryables
             or f"{queryable_prefix}hyear" in queryables
         ):
@@ -959,13 +911,21 @@ class ECMWFSearch(PostJsonSearch):
                 )
 
             # We convert every single value to a list of string
-            filter_v = values if isinstance(values, (list, tuple)) else [values]
+            filter_v = list(values) if isinstance(values, tuple) else values
+            filter_v = filter_v if isinstance(filter_v, list) else [filter_v]
 
             # We strip values of superfluous quotes (added by mapping converter to_geojson).
-            # ECMWF accept values with /to/. We need to split it to an array
-            # ECMWF accept values in format val1/val2. We need to split it to an array
-            sep = re.compile(r"/to/|/")
-            filter_v = [i for v in filter_v for i in sep.split(str(v))]
+            # ECMWF accept date ranges with /to/. We need to split it to an array
+            # ECMWF accept date ranges in format val1/val2. We need to split it to an array
+            date_regex = [
+                re.compile(p) for p in (DATE_RANGE_PATTERN, COMPACT_DATE_RANGE_PATTERN)
+            ]
+            is_date = any(
+                any(r.match(v) is not None for r in date_regex) for v in filter_v
+            )
+            if is_date:
+                sep = re.compile(r"/to/|/")
+                filter_v = [i for v in filter_v for i in sep.split(str(v))]
 
             # special handling for time 0000 converted to 0 by pre-formating with metadata_mapping
             if keyword.split(":")[-1] == "time":
@@ -976,23 +936,35 @@ class ECMWFSearch(PostJsonSearch):
 
             # Filter constraints and check for missing values
             filtered_constraints = []
+            # True if some constraint is defined for this keyword.
+            # In other words: if no constraint defines a list of values
+            # then any value is allowed for this keyword
+            keyword_constrained = False
             for entry in constraints:
                 # Filter based on the presence of any value in filter_v
                 entry_values = entry.get(keyword, [])
+                if entry_values:
+                    keyword_constrained = True
 
-                # date constraint may be intervals. We identify intervals with a "/" in the value
-                # we assume that if the first value is an interval, all values are intervals
+                # date constraint may be intervals. We identify intervals with a "/" in the value.
+                # date constraint can be a mixed list of single values (e.g "2023-06-27")
+                # and intervals (e.g. "2024-11-12/2025-11-20").
+                # collections with mixed values: CAMS_GAC_FORECAST, CAMS_EU_AIR_QUALITY_FORECAST
                 present_values = []
-                if keyword == "date" and "/" in entry[keyword][0]:
-                    input_range = values
-                    if isinstance(values, list):
-                        input_range = values[0]
-                    if any(is_range_in_range(x, input_range) for x in entry[keyword]):
-                        present_values = filter_v
-                else:
-                    present_values = [
-                        value for value in filter_v if value in entry_values
-                    ]
+                for entry_value in entry_values:
+                    if keyword == "date" and "/" in entry_value:
+                        input_range = values
+                        if isinstance(values, list):
+                            input_range = values[0]
+                        if "/" not in input_range:
+                            input_range = f"{input_range}/{input_range}"
+                        if is_range_in_range(entry_value, input_range):
+                            present_values.extend(filter_v)
+                    else:
+                        new_values = [
+                            value for value in filter_v if value == entry_value
+                        ]
+                        present_values.extend(new_values)
 
                 # Remove present values from the missing_values set
                 missing_values -= set(present_values)
@@ -1002,7 +974,7 @@ class ECMWFSearch(PostJsonSearch):
 
             # raise an error as no constraint entry matched the input keywords
             # raise an error if one value from input is not allowed
-            if not filtered_constraints or missing_values:
+            if keyword_constrained and (not filtered_constraints or missing_values):
                 allowed_values = list(
                     {value for c in constraints for value in c.get(keyword, [])}
                 )
@@ -1028,7 +1000,9 @@ class ECMWFSearch(PostJsonSearch):
                 )
 
             parsed_keywords.append(keyword)
-            constraints = filtered_constraints
+            # if the keyword is not constrained then any value is allowed
+            if keyword_constrained:
+                constraints = filtered_constraints
 
         available_values: dict[str, Any] = {k: set() for k in ordered_keywords}
 
@@ -1100,9 +1074,21 @@ class ECMWFSearch(PostJsonSearch):
             if default and prop.get("type") == "string" and isinstance(default, list):
                 default = ",".join(default)
 
-            is_required = bool(element.get("required")) and bool(
-                available_values.get(name)
-            )
+            is_required: bool
+            if available_values.get(name):
+                # required by the filtered constraints (available_values[name] is a not empty list)
+                is_required = True
+            elif bool(element.get("required")):
+                if name in available_values and not available_values[name]:
+                    # not required by the filtered constraints (available_values[name] is an empty list)
+                    is_required = False
+                else:
+                    # required only by form
+                    is_required = True
+            else:
+                # not required by form
+                is_required = False
+
             if is_required:
                 required_list.append(name)
 
@@ -1114,7 +1100,8 @@ class ECMWFSearch(PostJsonSearch):
                         prop,
                         default_value=default,
                         required=is_required,
-                        alias=formatted_alias,
+                        validation_alias=AliasChoices(formatted_alias, name),
+                        serialization_alias=formatted_alias,
                     )
                 )
             ]
@@ -1153,7 +1140,8 @@ class ECMWFSearch(PostJsonSearch):
                         {"type": "string", "title": name, "enum": values},
                         default_value=defaults.get(name),
                         required=bool(formatted_alias in required),
-                        alias=formatted_alias,
+                        validation_alias=AliasChoices(formatted_alias, name),
+                        serialization_alias=formatted_alias,
                     )
                 )
             ]
@@ -1279,7 +1267,7 @@ class ECMWFSearch(PostJsonSearch):
 
             # collection alias (required by opentelemetry-instrumentation-eodag)
             if alias := getattr(self.config, "collection_config", {}).get("alias"):
-                properties["eodag:alias"] = alias
+                kwargs["collection"] = alias
 
         qs = geojson.dumps(sorted_unpaginated_qp)
 
@@ -1521,7 +1509,7 @@ class MeteoblueSearch(ECMWFSearch):
         properties = {ecmwf_format(k): v for k, v in parsed_properties.items()}
         # collection alias (required by opentelemetry-instrumentation-eodag)
         if alias := getattr(self.config, "collection_config", {}).get("alias"):
-            properties["eodag:alias"] = alias
+            collection = alias
 
         def slugify(date_str: str) -> str:
             return date_str.split("T")[0].replace("-", "")

eodag/plugins/search/cop_marine.py

@@ -512,9 +512,11 @@ class CopMarineSearch(StaticStacSearch):
             else {}
         )
 
+        number_matched = num_total if prep.count else None
+
         formated_result = SearchResult(
             products,
-            num_total,
+            number_matched,
             search_params=search_params,
             next_page_token=str(start_index + 1),
         )

eodag/plugins/search/qssearch.py

@@ -28,7 +28,6 @@ from typing import (
     Callable,
     Optional,
     Sequence,
-    TypedDict,
     cast,
     get_args,
 )
@@ -58,6 +57,7 @@ from pydantic.fields import FieldInfo
 from requests import Response
 from requests.adapters import HTTPAdapter
 from requests.auth import AuthBase
+from typing_extensions import TypedDict
 from urllib3 import Retry
 
 from eodag.api.product import EOProduct
@@ -1283,7 +1283,7 @@ class QueryStringSearch(Search):
             )
             # collection alias (required by opentelemetry-instrumentation-eodag)
             if alias := getattr(self.config, "collection_config", {}).get("alias"):
-                properties["eodag:alias"] = alias
+                kwargs["collection"] = alias
             product = EOProduct(self.provider, properties, **kwargs)
 
             additional_assets = self.get_assets_from_mapping(result)
@@ -2166,17 +2166,18 @@ class StacSearch(PostJsonSearch):
             # convert json results to pydantic model fields
             field_definitions: dict[str, Any] = dict()
             eodag_queryables_and_defaults: list[tuple[str, Any]] = []
+            StacQueryables = Queryables.from_stac_models()
             for json_param, json_mtd in json_queryables.items():
                 param = get_queryable_from_provider(
                     json_param, self.get_metadata_mapping(collection)
-                ) or Queryables.get_queryable_from_alias(json_param)
+                ) or StacQueryables.get_queryable_from_alias(json_param)
                 # do not expose internal parameters, neither datetime
                 if param == "datetime" or param.startswith("_"):
                     continue
 
                 default = kwargs.get(param, json_mtd.get("default"))
 
-                if param in Queryables.model_fields:
+                if param in StacQueryables.model_fields:
                     # use eodag queryable as default
                     eodag_queryables_and_defaults += [(param, default)]
                     continue
@@ -2195,12 +2196,12 @@ class StacSearch(PostJsonSearch):
 
             # append eodag queryables
             for param, default in eodag_queryables_and_defaults:
-                queryables_dict[param] = Queryables.get_with_default(param, default)
+                queryables_dict[param] = StacQueryables.get_with_default(param, default)
 
             # append "datetime" as "start" & "end" if needed
             if "datetime" in json_queryables:
                 eodag_queryables = copy_deepcopy(
-                    model_fields_to_annotated(Queryables.model_fields)
+                    model_fields_to_annotated(StacQueryables.model_fields)
                 )
                 queryables_dict.setdefault("start", eodag_queryables["start"])
                 queryables_dict.setdefault("end", eodag_queryables["end"])