Eodag

-------------------

|:loudspeaker:| Major changes since last stable (`v3.0.1 <changelog.rstv3-0-1-2024-11-06>`_)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Core features and fixes
"""""""""""""""""""""""

* [v3.1.0b2] Assets keys uniformization using drivers (:pull:`1488`)
* [v3.1.0b1] Updated `queryables <https://eodag.readthedocs.io/en/latest/notebooks/api_user_guide/5_queryables.html>`_
mechanism and ecmwf-like plugins (:pull:`1397`)(:pull:`1427`)(:pull:`1462`)
* **[v3.1.0]** Customizable providers configuration file through ``EODAG_PRODUCT_TYPES_CFG_FILE`` environment
variable (:pull:`1559`)
* [v3.1.0b1] Order and download polling times update (:pull:`1440`)

Providers and product types updates
"""""""""""""""""""""""""""""""""""

* **[v3.1.0]** Removed ``onda`` provider (:pull:`1564`)
* [v3.1.0b2] default search timeout to 20s (:pull:`1505`)

Plugins new features and fixes
""""""""""""""""""""""""""""""

* **[v3.1.0]** :class:`~eodag.plugins.search.build_search_result.ECMWFSearch`: simplified configuration (:pull:`1433`),
fixed queryables issues (:pull:`1509`), mapped geometry metadata (:pull:`1555`)
* [v3.1.0b1] Removed default :class:`~eodag.plugins.download.http.HTTPDownload` zip extension (:pull:`1400`)
* [v3.1.0b1] Order and poll without downloading (:pull:`1437`)

Remaining changes since `v3.1.0b2 <changelog.rstv3-1-0b2-2025-02-03>`_
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Core features and fixes
"""""""""""""""""""""""

* Keep queryables `required` attribute even with default values (:pull:`1521`)

Providers and product types updates
"""""""""""""""""""""""""""""""""""

* ``geodes``: recognize auth errors during download (:pull:`1562`), typo in ``geodes_s3`` user conf template
(:pull:`1536`)
* ``wekeo_main`` metadata mapping update (:pull:`1549`) and COP-DEM product types update (:pull:`1516`)
* ``eumetsat_ds``: new MTG product types (:pull:`1513`), metadata mapping fix (:pull:`1502`), remove duplicate product
types (:pull:`1514`)
* Add product types to ``dedl`` provider (:pull:`1515`)

Plugins new features and fixes
""""""""""""""""""""""""""""""

* :class:`~eodag.plugins.download.aws.AwsDownload`: zip partial download (:pull:`1561`), `InvalidRequest` handle
(:pull:`1532`)
* Already authenticated user fix on openid authentication plugins (:pull:`1524`)
* Fixes missing file error on ``usgs`` authentication during attempts (:pull:`1550`)

Miscellaneous
"""""""""""""

* **[build]** remove dependencies max versions (:pull:`1519`)
* **[docs]** ``eodag-cube`` `Python API documentation
<https://eodag.readthedocs.io/en/latest/notebooks/api_user_guide/9_post_process.html#Data-access-with-eodag-cube>`_
(:pull:`1511`), ``usgs`` registration update (:pull:`1551`)
* Various minor fixes and improvements (:pull:`1502`)(:pull:`1540`)(:pull:`1541`)(:pull:`1547`)(:pull:`1552`)
(:pull:`1566`)(:pull:`1568`)
* External product types reference updates (:pull:`1510`)(:pull:`1525`)(:pull:`1539`)(:pull:`1548`)(:pull:`1553`)
(:pull:`1557`)(:pull:`1565`)

---------------------

Core features and fixes
^^^^^^^^^^^^^^^^^^^^^^^

* Assets keys uniformization using drivers (:pull:`1488`)
* ``ssl_verify`` setting for ``get_quicklook`` (:pull:`1490`, thanks `tromain <https://github.com/tromain>`_)
* Queryables merged by provider priority (:pull:`1431`)

Providers and product types updates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* ``geodes_s3`` as new provider (:pull:`1506`)
* default search timeout to 20s (:pull:`1505`)
* ``geodes`` ``relativeOrbitNumber`` property (:pull:`1499`) and numerical queryables fix (:pull:`1507`)

Miscellaneous
^^^^^^^^^^^^^

* **[docs]** Updated tutorials using ``eodag-cube`` (:pull:`1436`) and minor fixes (:pull:`1498`)(:pull:`1500`)
* **[style]** Typing update for generics (:pull:`1486`)
* Various minor fixes and improvements (:pull:`1471`)(:pull:`1472`)(:pull:`1473`)(:pull:`1475`)(:pull:`1477`)
(:pull:`1479`)(:pull:`1480`)(:pull:`1483`)(:pull:`1492`)(:pull:`1503`)(:pull:`1504`)
* External product types reference updates (:pull:`1460`)(:pull:`1478`)(:pull:`1484`)(:pull:`1487`)(:pull:`1493`)
(:pull:`1494`)

---------------------

Core features and fixes
^^^^^^^^^^^^^^^^^^^^^^^

* Updated `queryables <https://eodag.readthedocs.io/en/latest/notebooks/api_user_guide/5_queryables.html>`_ mechanism
and ecmwf-like plugins (:pull:`1397`)(:pull:`1427`)(:pull:`1462`)
* Order and download polling times update (:pull:`1440`)
* Do not retry downloading skipped products during download_all (:pull:`1465`)
* Renamed record files that were using previous mechanism (:pull:`1396`, thanks `gasparakos\
<https://github.com/gasparakos>`_)
* New ``to_lower()`` and ``to_upper()`` `parameters mapping\
<https://eodag.readthedocs.io/en/latest/params_mapping.html#formatters>`_ methods (:pull:`1410`, thanks
`jgaucher-cs <https://github.com/jgaucher-cs>`_)

Providers and product types updates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* ``geodes`` updated ``id`` (:pull:`1441`) and ``tileIdentifier`` parameters (:pull:`1457`), and metadata mapping fix
(:pull:`1468`)
* New MTG product types for ``eumetsat_ds`` (:pull:`1455`)
* ``FIRE_HISTORICAL`` on ``wekeo_ecmwf`` (:pull:`1392`)
* Various product types metadata-mapping and default values updates: for ``cop_ads`` and ``wekeo_ecmwf`` (:pull:`1389`),
GLOFAS and EFAS product types (:pull:`1467`), ``EEA_DAILY_VI`` on ``wekeo_main`` (:pull:`1464`)

Plugins new features and fixes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* Removed default :class:`~eodag.plugins.download.http.HTTPDownload` zip extension (:pull:`1400`)
* Order and poll without downloading (:pull:`1437`)
* :class:`~eodag.plugins.authentication.token.TokenAuth` distinct headers for token retrieve and authentication
(:pull:`1451`, thanks `jgaucher-cs <https://github.com/jgaucher-cs>`_)
* Compare only offset-aware datetimes on openid authentication plugins (:pull:`1418`)
* Fixed ``creodias_s3`` search and download when no asset is available (:pull:`1425`)

Server mode
^^^^^^^^^^^

* Dedicated liveness endpoint added (:pull:`1353`)
* Processing level parsing fix in external STAC collections (:pull:`1429`)

Miscellaneous
^^^^^^^^^^^^^
* **[docs]** `Queryables <https://eodag.readthedocs.io/en/latest/notebooks/api_user_guide/5_queryables.html>`_
documentation in a dedicated section (:pull:`1447`)
* Various minor fixes and improvements (:pull:`1390`)(:pull:`1403`)(:pull:`1411`)(:pull:`1415`)(:pull:`1419`)
(:pull:`1428`)(:pull:`1430`)(:pull:`1434`)(:pull:`1445`)(:pull:`1448`)(:pull:`1458`)(:pull:`1466`)
* External product types reference updates (:pull:`1387`)(:pull:`1391`)(:pull:`1401`)(:pull:`1404`)(:pull:`1406`)
(:pull:`1408`)(:pull:`1416`)(:pull:`1424`)(:pull:`1453`)(:pull:`1459`)

-------------------

Providers and product types updates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* ``geodes`` as new provider (:pull:`1357`)(:pull:`1363`)
* ``cop_ewds`` as new provider (:pull:`1331`)
* Removed ``astraea_eod`` provider (:pull:`1383`)
* Fixed ``S2_MSI_L1C`` search-by-id for ``earth_search`` (:pull:`1053`)
* MSG product types added (:pull:`1348`)
* Fixed order for some ``dedl`` product-types (:pull:`1358`)

Plugins new features and fixes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* Authenticate only when needed in :class:`~eodag.plugins.download.http.HTTPDownload` (:pull:`1370`)
* Various fixes for ``cop_marine`` (:pull:`1336`)(:pull:`1364`)
* OpenID token expiration fix and ``oidc_config_url`` usage (:pull:`1346`)
* Concurrent requests for ``wekeo_cmems`` product-types fetch (:pull:`1374`)
* Error is raised when :class:`~eodag.plugins.download.http.HTTPDownload` order fails (:pull:`1338`)

Miscellaneous
^^^^^^^^^^^^^
* **[build]** Add ``python3.13`` and drop ``python3.8`` support (:pull:`1344`)
* **[docs]** `Plugins <https://eodag.readthedocs.io/en/latest/plugins.html>`_ and `utils\
<https://eodag.readthedocs.io/en/latest/api_reference/utils.html>`_ documention update (:pull:`1297`)
* **[docs]** `conda optional dependencies\
<https://eodag.readthedocs.io/en/latest/getting_started_guide/install.html#conda>`_ handling (:pull:`1343`)
* **[docs]** Fixed ``auxdata`` reference in tutorials (:pull:`1372`, thanks `emmanuel-ferdman\
<https://github.com/emmanuel-ferdman>`_)
* **[ci]** Tests speedup using ``uv`` and ``tox-uv`` (:pull:`1347`)
* **[ci]** ``wekeo`` product types included in external product types reference (:pull:`1377`)
* Various minor fixes and improvements (:pull:`1298`)(:pull:`1335`)(:pull:`1340`)(:pull:`1341`)(:pull:`1351`)
(:pull:`1367`)(:pull:`1365`)(:pull:`1368`)(:pull:`1379`)
* External product types reference updates (:pull:`1342`)(:pull:`1356`)(:pull:`1359`)(:pull:`1360`)(:pull:`1362`)
(:pull:`1366`)(:pull:`1369`)(:pull:`1373`)(:pull:`1375`)(:pull:`1378`)(:pull:`1381`)(:pull:`1384`)

-------------------

|:warning:| Breaking changes since last stable (`v2.12.1 <changelog.rstv2-12-1-2024-03-05>`_)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* [v3.0.0b1] `search() <https://eodag.readthedocs.io/en/latest/notebooks/api_user_guide/4_search.html#search()>`_ method
now returns only a :class:`~eodag.api.search_result.SearchResult` instead of a 2 values tuple (:pull:`1200`). It can
optionally store the estimated total number of products in ``SearchResult.number_matched`` if the method is called
with ``count=True`` (``False`` by default).
* [v3.0.0b1] Packaging refactoring and new `optional dependencies
<https://eodag.readthedocs.io/en/latest/getting_started_guide/install.html#optional-dependencies>`_ (:pull:`1108`)
(:pull:`1219`). EODAG default installs with a minimal set of dependencies.
New sets of extra requirements are: ``eodag[all]``, ``eodag[all-providers]``, ``eodag[ecmwf]``, ``eodag[usgs]``,
``eodag[csw]``, ``eodag[server]``. Previous existing sets of extra requirements are also kept:
``eodag[notebook]``, ``eodag[tutorials]``, ``eodag[dev]``, ``eodag[docs]``.
* [v3.0.0b3] :meth:`~eodag.api.core.EODataAccessGateway.download` / :class:`~eodag.types.download_args.DownloadConf`
parameters ``outputs_prefix`` and ``outputs_extension`` renamed to ``output_dir`` and ``output_extension``
(:pull:`1279`)

|:loudspeaker:| Major changes since last stable (`v2.12.1 <changelog.rstv2-12-1-2024-03-05>`_)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Core features and fixes
"""""""""""""""""""""""

* **[v3.0.0]** Sharable and multiple authentication plugins per provider (:pull:`1292`)(:pull:`1329`)(:pull:`1332`)
* [v3.0.0b3] New :meth:`~eodag.api.core.EODataAccessGateway.add_provider` method (:pull:`1260`)
* [v3.0.0b2] New :class:`~eodag.api.search_result.SearchResult` HTML representation for notebooks (:pull:`1243`)
* [v3.0.0b1] Search results sort feature (:pull:`943`)
* [v3.0.0b1] Providers groups (:pull:`1071`)
* [v3.0.0b1] Configurable download timeout (:pull:`1124`)

Providers and product types updates
"""""""""""""""""""""""""""""""""""

* **[v3.0.0]** Updated ``cop_ads`` and ``cop_cds`` to new cds api (:pull:`1284`)
* **[v3.0.0]** ``wekeo`` split into ``wekeo_main`` and ``wekeo_ecmwf`` providers (:pull:`1214`)
* [v3.0.0b1] `dedl <https://hda.data.destination-earth.eu/ui>`_ as new provider (:pull:`750`)
* [v3.0.0b1] `dedt_lumi <https://polytope.lumi.apps.dte.destination-earth.eu/openapi>`_ as new provider (:pull:`1119`)
(:pull:`1126`), with authentication using destine credentials (:pull:`1127`)
* [v3.0.0b1] `cop_marine <https://marine.copernicus.eu/>`_ as new provider (:pull:`1131`)(:pull:`1224`)
* [v3.0.0b1] `eumetsat_ds <https://data.eumetsat.int/>`_ as new provider (:pull:`1060`), including `METOP` product types
(:pull:`1143`)(:pull:`1189`)
* [v3.0.0b1] `OData` API usage for ``creodias`` & ``cop_dataspace`` (:pull:`1149`)

Plugins new features and fixes
""""""""""""""""""""""""""""""

* [v3.0.0b1] Standardized download output tree (:pull:`746`)
* [v3.0.0b1] ``flatten_top_dirs`` download plugins option set to true by default (:pull:`1220`)
* [v3.0.0b1] ``base_uri`` download plugins setting is not systematically mandatory any more (:pull:`1230`)
* [v3.0.0b1] Allow no auth for :class:`~eodag.plugins.download.http.HTTPDownload` download requests (:pull:`1196`)

Server mode
"""""""""""

* [v3.0.0b1] Server-mode rework and cql2 support (:pull:`966`)
* [v3.0.0b1] Offline products order handling (:pull:`918`)
* **[v3.0.0]** Browsable catalogs removed (:pull:`1306`)

Miscellaneous
"""""""""""""

* **[v3.0.0b1 to v3.0.0][style]** type hints fixes and ``mypy`` in ``tox`` (:pull:`1052`)(:pull:`1253`)(:pull:`1269`)
(:pull:`1326`)
* **[v3.0.0][docs]** Developer documentation update (:pull:`1327`)

Remaining changes since `v3.0.0b3 <changelog.rstv3-0-0b3-2024-08-01>`_
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Core features and fixes
"""""""""""""""""""""""

* Improve search and authentication errors format (:pull:`1237`)

Providers and product types updates
"""""""""""""""""""""""""""""""""""

* Handle ``cop_marine`` in-situ historical data (:pull:`1301`)
* Fixes for ``wekeo``: ``GRIDDED_GLACIERS_MASS_CHANGE`` order link (:pull:`1258`), yaml issue in provider config
(:pull:`1315`)
* Fixes for ``wekeo_ecmwf``: ``hydrological_year`` usage (:pull:`1313`), fixed default dates (:pull:`1288`)

Plugins new features and fixes
""""""""""""""""""""""""""""""

* Raise an error if no data available on :class:`~eodag.plugins.download.aws.AwsDownload` (:pull:`1257`)

Server mode
"""""""""""

* Fixed *queryables* issues and parameters prefixes (:pull:`1318`)
* Send ``search_stac_items()`` in its own threadpool (:pull:`1323`)
* Fixed STAC collections metadata (:pull:`1278`)
* Updated logs format (:pull:`1238`)

Miscellaneous
"""""""""""""

* **[ci]** ``mypy`` in linting github action (:pull:`1326`), actions updates (:pull:`1310`)(:pull:`1314`)
* Various minor fixes and improvements (:pull:`1256`)(:pull:`1263`)(:pull:`1276`)(:pull:`1289`)(:pull:`1294`)
(:pull:`1295`)(:pull:`1296`)(:pull:`1300`)(:pull:`1303`)(:pull:`1304`)(:pull:`1308`)(:pull:`1333`)
* External product types reference updates (:pull:`1290`)(:pull:`1316`)(:pull:`1322`)(:pull:`1334`)

---------------------

|:warning:| Breaking changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* :meth:`~eodag.api.core.EODataAccessGateway.download` / :class:`~eodag.types.download_args.DownloadConf` parameters
``outputs_prefix`` and ``outputs_extension`` renamed to ``output_dir`` and ``output_extension`` (:pull:`1279`)

Core features and fixes
^^^^^^^^^^^^^^^^^^^^^^^

* New :meth:`~eodag.api.core.EODataAccessGateway.add_provider` method (:pull:`1260`)
* Handle integers as ``locations`` shapefile attributes (:pull:`1280`)
* Renames some parameters and methods to snake_case (:pull:`1271`)
* Sorted discovered product types (:pull:`1250`)

Providers and product types updates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* Fixes ``usgs`` search by id (:pull:`1262`)
* Adds ``S1_SAR_GRD_COG`` and new odata query parameters for ``cop_dataspace`` (:pull:`1277`, thanks
`ninsbl <https://github.com/ninsbl>`_)
* Adds ``GRIDDED_GLACIERS_MASS_CHANGE`` on provider ``cop_cds`` (:pull:`1255`)
* Removes ``cacheable`` parameter for ``wekeo`` order requests (:pull:`1239`)

Plugins new features and fixes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* ``aws_session_token`` support in :class:`~eodag.plugins.authentication.aws_auth.AwsAuth` (:pull:`1267`)
* :class:`~eodag.plugins.download.http.HTTPDownload` asset ``HEAD`` check and ``ssl_verify`` (:pull:`1266`)
* Product types discovery disabled by default on :class:`~eodag.plugins.search.static_stac_search.StaticStacSearch`
(:pull:`1259`)

Miscellaneous
^^^^^^^^^^^^^

* **[style]** type hints fixes and ``mypy`` in ``tox`` (:pull:`1253`)(:pull:`1269`)
* **[docs]** v3 breaking changes (:pull:`1281`), :meth:`~eodag.api.core.EODataAccessGateway.download` kwargs
(:pull:`1282`), autosummary fixes (:pull:`1264`) and changelog update (:pull:`1254`)
* **[ci]** Github actions updates (:pull:`1249`)
* **[test]** Fixed end-to-end tests (:pull:`1236`)
* External product types reference updates (:pull:`1244`)(:pull:`1246`)(:pull:`1251`)