eccodes 2.40.0__tar.gz → 2.41.0__tar.gz

{eccodes-2.40.0 → eccodes-2.41.0}/CHANGELOG.rst

@@ -2,6 +2,19 @@
 Changelog for eccodes-python
 ============================
 
+2.41.0 (2025-04-10)
+--------------------
+
+- ECC-2034: GRIB encoding: Data quality checks via the API
+- GitHub pull request #124: Add basic BUFR support (high-level interface)
+
+
+2.40.1 (2025-03-17)
+--------------------
+
+- Update version to be the same as the ecCodes library
+
+
 2.40.0 (2025-02-12)
 --------------------
 

{eccodes-2.40.0 → eccodes-2.41.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: eccodes
-Version: 2.40.0
+Version: 2.41.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)
@@ -31,6 +31,7 @@ Dynamic: description
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: summary
 
@@ -210,6 +211,19 @@ does it submit to any jurisdiction.
 Changelog for eccodes-python
 ============================
 
+2.41.0 (2025-04-10)
+--------------------
+
+- ECC-2034: GRIB encoding: Data quality checks via the API
+- GitHub pull request #124: Add basic BUFR support (high-level interface)
+
+
+2.40.1 (2025-03-17)
+--------------------
+
+- Update version to be the same as the ecCodes library
+
+
 2.40.0 (2025-02-12)
 --------------------
 

{eccodes-2.40.0 → eccodes-2.41.0}/ci/requirements-docs.txt

@@ -18,7 +18,7 @@ idna==3.7
     # via requests
 imagesize==1.1.0
     # via sphinx
-jinja2==3.1.5
+jinja2==3.1.6
     # via sphinx
 markupsafe==2.1.5
     # via jinja2

{eccodes-2.40.0 → eccodes-2.41.0}/eccodes/eccodes.py

@@ -132,6 +132,7 @@ from gribapi import grib_no_fail_on_wrong_length as codes_no_fail_on_wrong_lengt
 from gribapi import grib_release as codes_release
 from gribapi import grib_set as codes_set
 from gribapi import grib_set_array as codes_set_array
+from gribapi import grib_set_data_quality_checks as codes_set_data_quality_checks
 from gribapi import grib_set_debug as codes_set_debug
 from gribapi import grib_set_definitions_path as codes_set_definitions_path
 from gribapi import grib_set_double as codes_set_double
@@ -348,6 +349,7 @@ __all__ = [
     "codes_samples_path",
     "codes_dump",
     "codes_set_array",
+    "codes_set_data_quality_checks",
     "codes_set_debug",
     "codes_set_definitions_path",
     "codes_set_double_array",

{eccodes-2.40.0 → eccodes-2.41.0}/eccodes/highlevel/__init__.py

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

{eccodes-2.40.0 → eccodes-2.41.0}/eccodes/highlevel/message.py

@@ -33,7 +33,7 @@ class Message:
 
     def copy(self):
         """Create a copy of the current message"""
-        return Message(eccodes.codes_clone(self._handle))
+        return self.__class__(eccodes.codes_clone(self._handle))
 
     def __copy__(self):
         return self.copy()
@@ -242,6 +242,24 @@ class Message:
         return eccodes.codes_get_message(self._handle)
 
 
+class BUFRMessage(Message):
+    def __init__(self, handle):
+        super().__init__(handle)
+
+    def pack(self):
+        """Pack the underlying data"""
+        self.set("pack", 1, check_values=False)
+
+    def unpack(self):
+        """Unpack the underlying data"""
+        self.set("unpack", 1, check_values=False)
+
+    @classmethod
+    def from_samples(cls, name):
+        """Create a message from a sample"""
+        return cls(eccodes.codes_bufr_new_from_samples(name))
+
+
 class GRIBMessage(Message):
     def __init__(self, handle):
         super().__init__(handle)

{eccodes-2.40.0 → eccodes-2.41.0}/eccodes/highlevel/reader.py

@@ -2,12 +2,22 @@ import eccodes
 import gribapi
 from gribapi import ffi
 
-from .message import GRIBMessage
+from .message import BUFRMessage, GRIBMessage
+
+_MSG_CLASSES = {
+    eccodes.CODES_PRODUCT_GRIB: GRIBMessage,
+    eccodes.CODES_PRODUCT_BUFR: BUFRMessage,
+}
 
 
 class ReaderBase:
-    def __init__(self):
+    def __init__(self, kind=eccodes.CODES_PRODUCT_GRIB):
         self._peeked = None
+        self._kind = kind
+        cls = _MSG_CLASSES.get(kind)
+        if cls is None:
+            raise ValueError(f"Unsupported product type {kind}")
+        self._msg_class = cls
 
     def __iter__(self):
         return self
@@ -20,7 +30,7 @@ class ReaderBase:
         handle = self._next_handle()
         if handle is None:
             raise StopIteration
-        return GRIBMessage(handle)
+        return self._msg_class(handle)
 
     def _next_handle(self):
         raise NotImplementedError
@@ -36,19 +46,19 @@ class ReaderBase:
         if self._peeked is None:
             handle = self._next_handle()
             if handle is not None:
-                self._peeked = GRIBMessage(handle)
+                self._peeked = self._msg_class(handle)
         return self._peeked
 
 
 class FileReader(ReaderBase):
     """Read messages from a file"""
 
-    def __init__(self, path):
-        super().__init__()
+    def __init__(self, path, kind=eccodes.CODES_PRODUCT_GRIB):
+        super().__init__(kind=kind)
         self.file = open(path, "rb")
 
     def _next_handle(self):
-        return eccodes.codes_new_from_file(self.file, eccodes.CODES_PRODUCT_GRIB)
+        return eccodes.codes_new_from_file(self.file, self._kind)
 
     def __enter__(self):
         self.file.__enter__()
@@ -61,8 +71,8 @@ class FileReader(ReaderBase):
 class MemoryReader(ReaderBase):
     """Read messages from memory"""
 
-    def __init__(self, buf):
-        super().__init__()
+    def __init__(self, buf, kind=eccodes.CODES_PRODUCT_GRIB):
+        super().__init__(kind=kind)
         self.buf = buf
 
     def _next_handle(self):
@@ -128,14 +138,14 @@ def codes_new_from_stream(stream):
 class StreamReader(ReaderBase):
     """Read messages from a stream (an object with a ``read`` method)"""
 
-    def __init__(self, stream):
+    def __init__(self, stream, kind=eccodes.CODES_PRODUCT_GRIB):
         if cstd is None:
             raise OSError("This feature is not supported on Windows")
         if pyread_callback is None:
             raise OSError(
                 "This feature cannot be used because the OS prevents allocating write+execute memory"
             )
-        super().__init__()
+        super().__init__(kind=kind)
         self.stream = stream
 
     def _next_handle(self):

{eccodes-2.40.0 → eccodes-2.41.0}/eccodes.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: eccodes
-Version: 2.40.0
+Version: 2.41.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)
@@ -31,6 +31,7 @@ Dynamic: description
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: summary
 
@@ -210,6 +211,19 @@ does it submit to any jurisdiction.
 Changelog for eccodes-python
 ============================
 
+2.41.0 (2025-04-10)
+--------------------
+
+- ECC-2034: GRIB encoding: Data quality checks via the API
+- GitHub pull request #124: Add basic BUFR support (high-level interface)
+
+
+2.40.1 (2025-03-17)
+--------------------
+
+- Update version to be the same as the ecCodes library
+
+
 2.40.0 (2025-02-12)
 --------------------
 

{eccodes-2.40.0 → eccodes-2.41.0}/gribapi/__init__.py

@@ -14,8 +14,8 @@ from .gribapi import *  # noqa
 from .gribapi import __version__, lib
 
 # The minimum recommended version for the ecCodes package
-min_recommended_version_str = "2.38.0"
-min_recommended_version_int = 23800
+min_recommended_version_str = "2.39.0"
+min_recommended_version_int = 23900
 
 if lib.grib_get_api_version() < min_recommended_version_int:
     import warnings

{eccodes-2.40.0 → eccodes-2.41.0}/gribapi/bindings.py

@@ -23,7 +23,7 @@ import sys
 
 import cffi
 
-__version__ = "2.40.0"
+__version__ = "2.41.0"
 
 LOG = logging.getLogger(__name__)
 

{eccodes-2.40.0 → eccodes-2.41.0}/gribapi/grib_api.h

@@ -133,6 +133,7 @@ void grib_gribex_mode_on(grib_context* c);
 void grib_gribex_mode_off(grib_context* c);
 void grib_context_set_definitions_path(grib_context* c, const char* path);
 void grib_context_set_debug(grib_context* c, int mode);
+void grib_context_set_data_quality_checks(grib_context* c, int val);
 void grib_context_set_samples_path(grib_context* c, const char* path);
 void grib_multi_support_on(grib_context* c);
 void grib_multi_support_off(grib_context* c);

{eccodes-2.40.0 → eccodes-2.41.0}/gribapi/gribapi.py

@@ -2438,6 +2438,21 @@ def grib_set_debug(dmode):
     lib.grib_context_set_debug(context, dmode)
 
 
+@require(val=int)
+def grib_set_data_quality_checks(val):
+    """
+    @brief Enable/Disable GRIB data quality checks
+
+    @param val  0, 1 or 2
+                0 -> disable data quality checks
+                1 -> failure results in an error
+                2 -> failure results in a warning
+    """
+    assert val == 0 or val == 1 or val == 2
+    context = lib.grib_context_get_default()
+    lib.grib_context_set_data_quality_checks(context, val)
+
+
 @require(defs_path=str)
 def grib_set_definitions_path(defs_path):
     """

{eccodes-2.40.0 → eccodes-2.41.0}/tests/test_eccodes.py

@@ -55,6 +55,14 @@ def test_codes_set_debug():
     eccodes.codes_set_debug(0)
 
 
+def test_codes_set_data_quality_checks():
+    if eccodes.codes_get_api_version(int) < 24100:
+        pytest.skip("ecCodes version too old")
+    eccodes.codes_set_data_quality_checks(2)
+    eccodes.codes_set_data_quality_checks(1)
+    eccodes.codes_set_data_quality_checks(0)
+
+
 def test_codes_set_definitions_path():
     eccodes.codes_set_definitions_path(eccodes.codes_definition_path())
 

{eccodes-2.40.0 → eccodes-2.41.0}/tests/test_highlevel.py

@@ -166,8 +166,13 @@ def test_write_message(tmp_path):
             assert np.all(message1.data == message2.data)
 
 
-def test_message_from_samples():
+def test_grib_message_from_samples():
     message = eccodes.GRIBMessage.from_samples("regular_ll_sfc_grib2")
     assert message["edition"] == 2
     assert message["gridType"] == "regular_ll"
     assert message["levtype"] == "sfc"
+
+
+def test_bufr_message_from_samples():
+    message = eccodes.BUFRMessage.from_samples("BUFR4")
+    assert message["edition"] == 4