update to copernicusmarine 1.2.1

[veenstrajelmer]

We are pleased to inform you that Copernicus Marine Toolbox version 1.2.1 is now available!
It includes notably the top requested feature by end-users with the forthcoming June 2024 Catalog Service Release: the improvement of the management of the dataset versions.
From the last officially supported version (1.1.0), the following changes were included:

Describe Feature

• Improved robustness of metadata requests by calling S3 endpoints instead of STAC CDN and adding more retries for new use cases
• Improved fine tuning of the number of parallel request(s) with COPERNICUSMARINE_MAX_CONCURRENT_REQUESTS environment variable
• Improved description of dataset versions by adding the released_date and retired_date

Subset Feature

• Improved the Climate and Forecast (CF) compliance of the generated output by:
  • removing the _FillValue attributes in all coordinates
  • correcting depth dimension attributes
  • modifying the valid_min and valid_max attributes of the time dimension, now expressed as a float (matching the units of the original data) instead of a string
• Improved the generated output compatibility with legacy NetCDF clients thanks to the option --netcdf3-compatible
• Improved the selection on the longitude for some datasets that was incorrect in some very specific cases

Get Feature

• Improved --file-list option to download faster the specified file(s)
• Improved robustness of downloads thanks to smarter retries covering more use cases

General

• A warning is displayed when fetching a dataset version that will be soon retired
• Improved error messages with hints about relevant solutions
• Improved fine tuning of the system host environment(s) with COPERNICUSMARINE_TRUST_ENV environment variable
• Improved pattern used for environment variable related to credentials
• Added a note about version management
• Internal tests have been added about new use cases
• The documentation has been updated to reflect these changes

To find out more about the new and previous version notes, please consult this article. 💡Copernicus Marine Pro Tip

• To automatically receive a notification when a new version is released, we invite you to connect to the Toolbox RSS flux
• To discover the set of options dedicated to operational purposes, read the best practices usage
• Starting from next days, if the installed version of the Toolbox is lower than 1.2.1, then this warning message will be displayed to invite you upgrading:
  ERROR - 2024-05-16T00:00:01Z - Client version X.Y.Z is not compatible with current backend service. Please update to the latest client version.