Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
1.4.2 - 2023-12-12
Fixed:
- Fixed a typo in the error message when an invalid area was given (#160).
- Fixed pressing Enter not working for the default input in the "Valid CDS keys found in the .cdsapirc file. Do you want to use these for era5cli? [Y/n]" prompt (#160).
Added:
- era5cli is now available for Python 3.11 (#160).
Removed:
- Support for Python 3.7 has been removed. It's end-of-life was 2023-06-27 (#160).
1.4.1 - 2023-06-30
Fixed:
- Fix a bug that prevented the creation of the configuration file, if the "~/.config" folder did not exist yet (#154).
Added:
- The developer documentation now contains instructions on how to maintain the conda-forge feedstock for era5cli (#150).
Changed:
- Before asking for a user input, a check is made if the code is running in an interactive terminal or not. If not (e.g. if era5cli is called through a different script and stdin is not available), the input request is skipped (#152).
Dev changes:
- A pre-commit hook has been added, to facilitate pre-commit users. Documentation on the setup is added to the developer documentation (#153).
1.4.0 - 2023-04-21
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).
1.3.2 - 2022-12-13
Changed:
Fixed:
- Fix a bug that allowed the incompatible combination of --land and --ensemble #131
1.3.1 - 2021-12-01
Fixed:
- Automatic Zenodo/RSD release failed; updated contribution guidelines #106
1.3.0 - 2021-11-30
Added:
- Add integration testing #102
Fixed:
- Fix compatibility with changed CDS variables geopotential/orography #98
1.2.1 - 2021-04-21
Fixed:
- Automatic PyPI release for 1.2.0 failed; updated github action workflow #91
1.2.0 - 2021-04-21
Added:
Changed:
- Update variables available for ERA5 datasets #84
1.1.1 - 2020-12-15
Fixed:
- Patch to fix the github actions publish automation #64
1.1.0 - 2020-12-14
The stable 1.1.0 era5cli minor release.
Added:
- Add support for ERA5 preliminary back extension #58
- Add automated PyPI package building and publishing with github Actions #62
Changed:
- Update tests #57
1.0.0 - 2019-07-25
The stable 1.0.0 era5cli release.
Added:
- Adding more useful information to netCDF history #48
1.0.0rc3 - 2019-07-16
Third Release Candidate for the stable 1.0.0 era5cli release.
Added:
- Append era5cli version to history of downloaded netCDF file #17
Changed:
1.0.0rc2 - 2019-07-01
Second Release Candidate for the stable 1.0.0 era5cli release.
Fixed:
- Fix downloading all variables when requesting multiple variables and using --split #23
- Fix link to PyPI package in documentation #22
1.0.0rc1 - 2019-06-22
First Release Candidate for the stable 1.0.0 era5cli release: A commandline utility to download ERA-5 data using cdsapi.