Skip to content

v1.4.0 (2023-04-21)

Compare
Choose a tag to compare
@BSchilperoort BSchilperoort released this 21 Apr 09:05
· 19 commits to main since this release
ec94a56

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 for era5cli 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).