eccodes 2.42.0__tar.gz → 2.44.0__tar.gz

{eccodes-2.42.0 → eccodes-2.44.0}/CHANGELOG.rst

@@ -2,6 +2,20 @@
 Changelog for eccodes-python
 ============================
 
+2.44.0 (2025-10-03)
+--------------------
+
+- ECC-2102: Improved high-level interface for BUFR
+- ECC-2108: Implement a way of switching off error output to stderr
+- GitHub pull request #129: Update MemoryReader to read more than one field
+
+
+2.43.0 (2025-07-24)
+--------------------
+
+- ECC-2106: Use eccodeslib instead of own-built binaries
+
+
 2.42.0 (2025-06-25)
 --------------------
 

{eccodes-2.42.0 → eccodes-2.44.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eccodes
-Version: 2.42.0
+Version: 2.44.0
 Summary: Python interface to the ecCodes GRIB and BUFR decoder/encoder
 Home-page: https://github.com/ecmwf/eccodes-python
 Author: European Centre for Medium-Range Weather Forecasts (ECMWF)
@@ -23,6 +23,7 @@ Requires-Dist: numpy
 Requires-Dist: attrs
 Requires-Dist: cffi
 Requires-Dist: findlibs
+Requires-Dist: eccodeslib; platform_system != "Windows"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -60,8 +61,11 @@ Limitations:
 Installation
 ============
 
-**From version 2.37.0, the ecCodes Python bindings on PyPi additionally provide the ecCodes binary library, and will
-follow the version numbering of the ecCodes binary library. See below for details.**
+**From version 2.43.0, the ecCodes Python bindings on PyPi will depend
+on the PyPi package 'eccodeslib' on Linux and MacOS. This package provides
+the binary ecCodes library. On Windows, the ecCodes Python bindings will
+continue to directly provide the ecCodes binary library without a dependency
+on eccodeslib. See below for details.**
 
 Installation from PyPI
 ----------------------
@@ -70,17 +74,38 @@ The package can be installed from PyPI with::
 
     $ pip install eccodes
 
-This installation will, by default, include the ecCodes binary library (as of version 2.37.0), meaning that no
-external ecCodes binary library is required. If you have an external ecCodes binary library that you wish to use,
-set the following environment variable before you import eccodes::
+This installation will, by default, include the ecCodes binary library (either
+supplied by the 'eccodes' package on Windows, or via the 'eccodeslib' package
+on Linux and MacOS), meaning that no external ecCodes binary library is
+required.
+
+
+Bypassing the provided binary library
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Linux and MacOS
++++++++++++++++
+
+If you have an external ecCodes binary library that you wish to use, consult the documentation
+of the `findlibs <https://github.com/ecmwf/findlibs>`_ package, which is used by the ecCodes Python bindings to
+locate the binary library. This allows the use of environment variables
+to refine the search algorithm.
+
+
+Windows
++++++++
+
+If you have an external ecCodes binary library that you wish to use, set the
+following environment variable before you import eccodes::
 
     $ export ECCODES_PYTHON_USE_FINDLIBS=1
 
 If this is set, the ecCodes' Python bindings will use the `findlibs <https://github.com/ecmwf/findlibs>`_ package
-to locate the binary library (findlibs was the only mechanism used before version 2.37.0).
- 
-You may also install a version of ecCodes' Python interface that does not include a binary library at all,
-in which case the findlibs mechanism will be used as before::
+to locate the binary library.
+
+You may also install a version of ecCodes' Python interface that does not
+include a binary library at all, in which case the findlibs mechanism will
+be used as before::
 
     $ pip install eccodes --no-binary eccodes
 
@@ -94,15 +119,18 @@ ecCodes' Python bindings can be installed from the `conda-forge <https://conda-f
 
     $ conda install -c conda-forge python-eccodes
 
-This will install the Python bindings (`python-eccodes`) and also the ecCodes binary library (`eccodes`) on which they depend.
+This will install the Python bindings (`python-eccodes`) and also the ecCodes
+binary library (`eccodes`) on which they depend.
 
 
 System dependencies
 -------------------
 
-The Python module depends on the ECMWF *ecCodes* binary library. From version 2.37.0, this library is supplied with
-the Python module on both PyPi and conda, as described above. If you wish to install and use a separate binary library
-(see above), it must be installed on the system and accessible as a shared library.
+The Python module depends on the ECMWF *ecCodes* binary library.
+From version 2.37.0, this library is supplied with the Python
+module on both PyPi and conda, as described above. If you wish
+to install and use a separate binary library (see above), it must
+be installed on the system and accessible as a shared library.
 
 On a MacOS with HomeBrew use::
 
@@ -116,18 +144,19 @@ As an alternative you may install the official source distribution
 by following the instructions at
 https://confluence.ecmwf.int/display/ECC/ecCodes+installation
 
-You may run a simple selfcheck command to ensure that your system is set up correctly::
+You may run a simple selfcheck command to ensure that your system is set
+up correctly::
 
     $ python -m eccodes selfcheck
-    Found: ecCodes v2.39.0.
+    Found: ecCodes v2.42.0.
     Your system is ready.
 
 
 Debugging the library search
 ----------------------------
 
-In order to gain insights into the search for the binary library, set the following environment variable before
-importing eccodes::
+In order to gain insights into the search for the binary library, set
+the following environment variable before importing eccodes::
 
     $ export ECCODES_PYTHON_TRACE_LIB_SEARCH=1
 
@@ -135,6 +164,9 @@ importing eccodes::
 Usage
 -----
 
+See examples of how to use the high-level BUFR interface: `BUFR_Tour.md <eccodes/highlevel/_bufr/BUFR_Tour.md>`_
+and `BUFR_Snippets.md <eccodes/highlevel/_bufr/BUFR_Snippets.md>`_.
+
 Refer to the *ecCodes* `documentation pages <https://confluence.ecmwf.int/display/ECC/Documentation>`_
 for usage.
 
@@ -210,6 +242,20 @@ does it submit to any jurisdiction.
 Changelog for eccodes-python
 ============================
 
+2.44.0 (2025-10-03)
+--------------------
+
+- ECC-2102: Improved high-level interface for BUFR
+- ECC-2108: Implement a way of switching off error output to stderr
+- GitHub pull request #129: Update MemoryReader to read more than one field
+
+
+2.43.0 (2025-07-24)
+--------------------
+
+- ECC-2106: Use eccodeslib instead of own-built binaries
+
+
 2.42.0 (2025-06-25)
 --------------------
 

{eccodes-2.42.0 → eccodes-2.44.0}/README.rst

@@ -24,8 +24,11 @@ Limitations:
 Installation
 ============
 
-**From version 2.37.0, the ecCodes Python bindings on PyPi additionally provide the ecCodes binary library, and will
-follow the version numbering of the ecCodes binary library. See below for details.**
+**From version 2.43.0, the ecCodes Python bindings on PyPi will depend
+on the PyPi package 'eccodeslib' on Linux and MacOS. This package provides
+the binary ecCodes library. On Windows, the ecCodes Python bindings will
+continue to directly provide the ecCodes binary library without a dependency
+on eccodeslib. See below for details.**
 
 Installation from PyPI
 ----------------------
@@ -34,17 +37,38 @@ The package can be installed from PyPI with::
 
     $ pip install eccodes
 
-This installation will, by default, include the ecCodes binary library (as of version 2.37.0), meaning that no
-external ecCodes binary library is required. If you have an external ecCodes binary library that you wish to use,
-set the following environment variable before you import eccodes::
+This installation will, by default, include the ecCodes binary library (either
+supplied by the 'eccodes' package on Windows, or via the 'eccodeslib' package
+on Linux and MacOS), meaning that no external ecCodes binary library is
+required.
+
+
+Bypassing the provided binary library
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Linux and MacOS
++++++++++++++++
+
+If you have an external ecCodes binary library that you wish to use, consult the documentation
+of the `findlibs <https://github.com/ecmwf/findlibs>`_ package, which is used by the ecCodes Python bindings to
+locate the binary library. This allows the use of environment variables
+to refine the search algorithm.
+
+
+Windows
++++++++
+
+If you have an external ecCodes binary library that you wish to use, set the
+following environment variable before you import eccodes::
 
     $ export ECCODES_PYTHON_USE_FINDLIBS=1
 
 If this is set, the ecCodes' Python bindings will use the `findlibs <https://github.com/ecmwf/findlibs>`_ package
-to locate the binary library (findlibs was the only mechanism used before version 2.37.0).
- 
-You may also install a version of ecCodes' Python interface that does not include a binary library at all,
-in which case the findlibs mechanism will be used as before::
+to locate the binary library.
+
+You may also install a version of ecCodes' Python interface that does not
+include a binary library at all, in which case the findlibs mechanism will
+be used as before::
 
     $ pip install eccodes --no-binary eccodes
 
@@ -58,15 +82,18 @@ ecCodes' Python bindings can be installed from the `conda-forge <https://conda-f
 
     $ conda install -c conda-forge python-eccodes
 
-This will install the Python bindings (`python-eccodes`) and also the ecCodes binary library (`eccodes`) on which they depend.
+This will install the Python bindings (`python-eccodes`) and also the ecCodes
+binary library (`eccodes`) on which they depend.
 
 
 System dependencies
 -------------------
 
-The Python module depends on the ECMWF *ecCodes* binary library. From version 2.37.0, this library is supplied with
-the Python module on both PyPi and conda, as described above. If you wish to install and use a separate binary library
-(see above), it must be installed on the system and accessible as a shared library.
+The Python module depends on the ECMWF *ecCodes* binary library.
+From version 2.37.0, this library is supplied with the Python
+module on both PyPi and conda, as described above. If you wish
+to install and use a separate binary library (see above), it must
+be installed on the system and accessible as a shared library.
 
 On a MacOS with HomeBrew use::
 
@@ -80,18 +107,19 @@ As an alternative you may install the official source distribution
 by following the instructions at
 https://confluence.ecmwf.int/display/ECC/ecCodes+installation
 
-You may run a simple selfcheck command to ensure that your system is set up correctly::
+You may run a simple selfcheck command to ensure that your system is set
+up correctly::
 
     $ python -m eccodes selfcheck
-    Found: ecCodes v2.39.0.
+    Found: ecCodes v2.42.0.
     Your system is ready.
 
 
 Debugging the library search
 ----------------------------
 
-In order to gain insights into the search for the binary library, set the following environment variable before
-importing eccodes::
+In order to gain insights into the search for the binary library, set
+the following environment variable before importing eccodes::
 
     $ export ECCODES_PYTHON_TRACE_LIB_SEARCH=1
 
@@ -99,6 +127,9 @@ importing eccodes::
 Usage
 -----
 
+See examples of how to use the high-level BUFR interface: `BUFR_Tour.md <eccodes/highlevel/_bufr/BUFR_Tour.md>`_
+and `BUFR_Snippets.md <eccodes/highlevel/_bufr/BUFR_Snippets.md>`_.
+
 Refer to the *ecCodes* `documentation pages <https://confluence.ecmwf.int/display/ECC/Documentation>`_
 for usage.
 

{eccodes-2.42.0 → eccodes-2.44.0}/eccodes/eccodes.py

@@ -61,6 +61,7 @@ from gribapi import (
 )
 from gribapi import grib_clone as codes_clone
 from gribapi import grib_context_delete as codes_context_delete
+from gribapi import grib_context_set_logging as codes_context_set_logging
 from gribapi import grib_copy_namespace as codes_copy_namespace
 from gribapi import grib_count_in_file as codes_count_in_file
 from gribapi import grib_find_nearest as codes_grib_find_nearest
@@ -211,6 +212,7 @@ from gribapi.errors import (
     OutOfRangeError,
     PrematureEndOfFileError,
     ReadOnlyError,
+    RuntimeError,
     StringTooSmallError,
     SwitchNoMatchError,
     TooManyAttributesError,
@@ -371,6 +373,7 @@ __all__ = [
     "codes_skip_read_only",
     "codes_write",
     "codes_context_delete",
+    "codes_context_set_logging",
     "CodesInternalError",
     "ConceptNoMatchError",
     "ConstantFieldError",
@@ -420,6 +423,7 @@ __all__ = [
     "OutOfRangeError",
     "PrematureEndOfFileError",
     "ReadOnlyError",
+    "RuntimeError",
     "StringTooSmallError",
     "SwitchNoMatchError",
     "TooManyAttributesError",

eccodes-2.44.0/eccodes/highlevel/__init__.py

@@ -0,0 +1,3 @@
+from ._bufr import BUFRMessage  # noqa
+from .message import GRIBMessage, Message  # noqa
+from .reader import FileReader, MemoryReader, StreamReader  # noqa

eccodes-2.44.0/eccodes/highlevel/_bufr/__init__.py

@@ -0,0 +1,15 @@
+"""
+A High-level interface for en/decoding of BUFR files.
+"""
+
+from .common import change_behaviour, get_behaviour, set_behaviour
+from .helpers import missing_of
+from .message import BUFRMessage
+
+__all__ = [
+    "change_behaviour",
+    "get_behaviour",
+    "set_behaviour",
+    "missing_of",
+    "BUFRMessage",
+]