v3.0.0
2024-09-11
The configuration file schema for earthdata-varinfo
is significantly updated
in this release. For more information, see the release notes for schema v1.0.0
in config/CHANGELOG.md
.
Added:
- Groups within a NetCDF-4 or DMR file are now assigned to the
VarInfo*.groups
dictionary, allowing for their metadata attributes to be accessed after parsing
an input file.
Changed:
CFConfig.get_cf_attributes
has been renamedCFConfig.get_metadata_overrides
,
as there are now only overrides to be returned from this method. Calls to
CFConfig.get_metadata_overrides
now must specify a variable path. All
overrides from a configuration file for a given collection are now retrievable
from the newly publicCFConfig.metadata_overrides
class attribute.- Metadata overrides retrieved for a matching file path are ordered such that
the most specific applicable override to the variable takes precedence. For
example, when requesting the value of the "units" metadata attribute for
variable "/nested/variable", an applicability rule that exactly matches this
variable path will take precedence over rules matching to either the group,
or all variables in the file. - Handling of nested
Applicability_Groups
has been removed from theCFConfig
class, as the configuration file no longer nests these items in overrides.
Removed:
CFConfig._cf_supplements
has been deprecated in favour of specifying all
in-file metadata changes via aMetadataOverrides
item (formerly
CFOverrides
) instead.