v4.0.4

4.0.4 (2024-07-05)

• Use the latest data release which switched to a single parquet file for all data.

Version 4.0.3

4.0.3 (2024-07-04)

• Re-release 4.0.2 due to technical reasons.

4.0.2 (2024-07-04)

• Use data released until 2024-07-04 when using the ZenodoReader.

Version 4.0.1

unfccc_di_api is a Python wrapper around the Flexible Query API of the UNFCCC.

Changes in this version:

• Use data released until 2024-01-08 when using the ZenodoReader.
• Support python 3.12.

Version 4.0.0

unfccc_di_api is a Python wrapper around the Flexible Query API of the UNFCCC.

Changes in this version:

• Breaking: the UNFCCC restricted API access, likely you have to change your code to
  use the new ZenodoReader instead.
• Add ZenodoReader which doesn't rely on API access.
• Use data released until 2023-07-18 when using the ZenodoReader.
• Build the documentation on ReadTheDocs using newer Python and Sphinx versions.

unfccc_di_api version 3.0.2

Python wrapper around the Flexible Query API of the UNFCCC, version 3.0.2.

Changes in version 3.0.2:

• Support python 3.11.
• Drop support for python 3.6.

Version 3.0.1

Fix handling of unspecified measure IDs. The DI API started returning measure IDs without a name or description. We now call them unknown measure nr. {measureId} instead of erroring out.

Version 3.0.0

unfccc_di_api is a Python wrapper around the Flexible Query API of the UNFCCC, which can be used to fetch country-submitted green-house gas emissions data.

For release 3.0.0, we have fixed a bug related to duplicate variable IDs in the Flexible Query API which led to incomplete results. To fix this bug, the public API had to be changed slightly, in particular the UNFCCCSingleCategoryApiReader.variables DataFrame now has a generic index instead of using the variableId as index. If you are using the variables DataFrame, you will have to accomodate the changes in your code. If you are only using the query API, no changes are necessary, you will simply get more accurate results.

The detailed changelog:

• Support python 3.10.
• Fix handling of duplicate variable IDs. Note: This entails changes to the public
  API! In particular, UNFCCCSingleCategoryApiReader.variables now has a generic index
  instead of using the variableId as index. Also, the query function now
  correctly restricts queries if category_ids are provided and correctly fills
  all categories with data for a multi-category variable.
• Fix pre-commit config for newer mypy type checking versions.
• Raise a more informative NoDataError (subclass of KeyError) instead of a generic
  KeyError when a query result is empty.

Version 2.0.1

• Change build system.

Version 2.0.0

Accept ASCII format for gases when querying data
and return gases & units normalized to ASCII (optional), thanks to Daniel Huppmann.

Note that gases and units are normalized to ASCII by default, which might break compatibility. If you need the old
behaviour for compatibility reasons, pass normalize_gas_names=False to your
query() calls.

Version 1.1.1

Include ipython notebooks and CHANGELOG in release tarballs.