v1.4.0 (2023-04-21)
With this era5cli
release comes a new documentation and some quality-of-life improvements!
For details see the lists below:
Added:
- Add validator for user's CDS keys. This should provide better feedback to users and reduce user error (#138).
- Added
--splitmonths
argument forera5cli hourly
. This allows users to avoid a Request Too Large error (#139). - When a request would encounter a Request Too Large error in the CDS API, they are warned, and given a suggestion to use the new
--splitmonths
argument (#139). - Added -
-dashed-varname
argument, to produce file names where the variable name is separated using dashes. For example:soil-type
vs.soil_type
. For the ongoing discussion, see #53.
Changed:
- Change CDS keys from cdsapi default
.cdsapirc
file to.config/era5cli/cds_key.txt
file (#138).- This will avoid conflict with e.g. ADS keys
- The user can configure the keys using
era5cli config
, no need to create a file in the right location.
- When a request would encounter a Request Too Large error in the CDS API, they are warned, and given a suggestion to use
--splitmonths
(#139). - If a user makes a request without
--splitmonths
they are warned that the behavior will change in the future, and that they have to choose between--splitmonths False
and--splitmonths True
- When a file already exists and would be overwritten, the user is prompted for confirmation. This should prevent accidental overwriting of files. This check can be skipped with the
--overwrite
flag (#143). - The earliest valid start year of ERA5 requests has been updated to 1940 (for ERA5-land it is still 1950) (#146).
- Usage of
--prelimbe
now raises a deprecation warning. It will be deprecated in a future release, as all the back extension years are now included in the main products (#147). - The documentation has been fully overhauled, and now uses Markdown files & MkDocs (#142, #144).
Dev changes:
cli.py
has been refactored to make the structure more clear. Seperate argument builders are now in their own modules (#139).