flopscope 0.4.2__tar.gz → 0.4.3__tar.gz

{flopscope-0.4.2 → flopscope-0.4.3}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.4.3 (2026-06-02)
+
+### Fix
+
+- **server**: raise UnsupportedReturnType for unpackable results
+
 ## v0.4.2 (2026-06-01)
 
 ### Feat

{flopscope-0.4.2 → flopscope-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flopscope
-Version: 0.4.2
+Version: 0.4.3
 Summary: NumPy-compatible math primitives with FLOP counting for the Mechanistic Estimation Challenge
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -20,7 +20,7 @@ Requires-Dist: scipy>=1.10; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: numpydoc>=1.10; extra == 'docs'
 Provides-Extra: server
-Requires-Dist: flopscope-server==0.4.2; extra == 'server'
+Requires-Dist: flopscope-server==0.4.3; extra == 'server'
 Provides-Extra: sympy
 Requires-Dist: sympy>=1.11; extra == 'sympy'
 Description-Content-Type: text/markdown

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-client/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flopscope-client"
-version = "0.4.2"
+version = "0.4.3"
 description = "Lightweight flopscope client — drop-in replacement with no numpy dependency"
 readme = "README.md"
 requires-python = ">=3.10"

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-client/src/flopscope/__init__.py

@@ -18,7 +18,7 @@ import builtins
 import struct
 from typing import Any
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"
 
 # ---------------------------------------------------------------------------
 # Errors

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-client/src/flopscope/errors.py

@@ -45,6 +45,13 @@ class UnsupportedFunctionError(FlopscopeError):
         super().__init__(message)
 
 
+class UnsupportedReturnType(FlopscopeError):
+    """Raised when an op's result cannot be serialized across the client/server boundary."""
+
+    def __init__(self, message: str = "") -> None:
+        super().__init__(message)
+
+
 class FlopscopeWarning(UserWarning):
     """Warning issued when flopscope detects potential numerical issues."""
 
@@ -72,6 +79,7 @@ _FLOPSCOPE_ERRORS: frozenset[str] = frozenset(
         "NoBudgetContextError",
         "SymmetryError",
         "UnsupportedFunctionError",
+        "UnsupportedReturnType",
     }
 )
 
@@ -81,6 +89,7 @@ _ERROR_MAP: dict[str, type[Exception]] = {
     "NoBudgetContextError": NoBudgetContextError,
     "SymmetryError": SymmetryError,
     "UnsupportedFunctionError": UnsupportedFunctionError,
+    "UnsupportedReturnType": UnsupportedReturnType,
     "FlopscopeServerError": FlopscopeServerError,
     "ValueError": ValueError,
     "TypeError": TypeError,

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-server/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flopscope-server"
-version = "0.4.2"
+version = "0.4.3"
 description = "Backend server for flopscope client-server architecture"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 dependencies = [
-    "flopscope==0.4.2",
+    "flopscope==0.4.3",
     "numpy>=2.0.0,<2.5.0",
     "pyzmq>=26.0.0",
     "msgpack>=1.0.0",

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-server/src/flopscope_server/__init__.py

@@ -1,3 +1,3 @@
 """Flopscope backend server — executes numpy operations on behalf of remote clients."""
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"

{flopscope-0.4.2 → flopscope-0.4.3}/flopscope-server/src/flopscope_server/_request_handler.py

@@ -49,6 +49,28 @@ def _make_serializable(obj):
     return obj
 
 
+_MSGPACK_SCALARS = (type(None), bool, int, float, str, bytes)
+
+
+def _is_msgpack_native(obj) -> bool:
+    """True if *obj* is composed only of msgpack-encodable Python types.
+
+    ``_make_serializable`` flattens numpy types but passes unknown objects
+    through unchanged; this distinguishes a genuinely-encodable result from one
+    that would only fail later inside ``msgpack.packb``.
+    """
+    if isinstance(obj, _MSGPACK_SCALARS):
+        return True
+    if isinstance(obj, (list, tuple)):
+        return all(_is_msgpack_native(item) for item in obj)
+    if isinstance(obj, dict):
+        return all(
+            isinstance(k, (str, bytes, int)) and _is_msgpack_native(v)
+            for k, v in obj.items()
+        )
+    return False
+
+
 #: Maximum allowed array size in bytes (configurable via environment variable).
 MAX_ARRAY_BYTES = int(os.environ.get("FLOPSCOPE_MAX_ARRAY_BYTES", 100 * 1024 * 1024))
 
@@ -113,6 +135,12 @@ class RequestHandler:
                 "error_type": "UnsupportedFunctionError",
                 "message": str(e),
             }
+        except flops.UnsupportedReturnType as e:
+            return {
+                "status": "error",
+                "error_type": "UnsupportedReturnType",
+                "message": str(e),
+            }
         except (ValueError, TypeError) as e:
             return {
                 "status": "error",
@@ -420,16 +448,19 @@ class RequestHandler:
             handle = self._session.store_generator(result)
             return {"status": "ok", "result": {"gen_id": handle}, "budget": budget}
 
-        # Fallback: try to make it serializable
-        try:
-            serializable = _make_serializable(result)
+        # Fallback: flatten nested numpy structures to JSON-safe values. If the
+        # result still isn't msgpack-native, fail loudly + attributably rather
+        # than silently str()-degrading (which previously surfaced downstream as
+        # an opaque "failed to serialize response" error). The registry-driven
+        # conformance test (tests/test_registry_conformance.py) catches any op
+        # whose return type lands here.
+        serializable = _make_serializable(result)
+        if _is_msgpack_native(serializable):
             return {"status": "ok", "result": {"value": serializable}, "budget": budget}
-        except Exception:
-            return {
-                "status": "ok",
-                "result": {"value": str(result), "dtype": "str"},
-                "budget": budget,
-            }
+        raise flops.UnsupportedReturnType(
+            f"{type(result).__name__} is not serializable across the "
+            f"client/server boundary"
+        )
 
 
 # ---------------------------------------------------------------------------

{flopscope-0.4.2 → flopscope-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flopscope"
-version = "0.4.2"
+version = "0.4.3"
 description = "NumPy-compatible math primitives with FLOP counting for the Mechanistic Estimation Challenge"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -12,7 +12,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-server = ["flopscope-server==0.4.2"]
+server = ["flopscope-server==0.4.3"]
 dev = [
     "commitizen>=4.0",
     "gitlint>=0.19",

{flopscope-0.4.2 → flopscope-0.4.3}/scripts/sync_client.py

@@ -88,6 +88,7 @@ def _generate_errors() -> str:
         "SymmetryError",
         "TimeExhaustedError",
         "UnsupportedFunctionError",
+        "UnsupportedReturnType",
     }
 
     # (class_name, base_class, docstring) in declaration order
@@ -118,6 +119,14 @@ def _generate_errors() -> str:
             "FlopscopeError",
             "Raised when calling a function not available in the installed NumPy.",
         ),
+        (
+            "UnsupportedReturnType",
+            "FlopscopeError",
+            (
+                "Raised when an op's result cannot be serialized across the "
+                "client/server boundary."
+            ),
+        ),
         (
             "FlopscopeWarning",
             "UserWarning",

{flopscope-0.4.2 → flopscope-0.4.3}/src/flopscope/__init__.py

@@ -32,7 +32,7 @@ import numpy as _np
 
 from flopscope._registry import REGISTRY_META as _REGISTRY_META
 
-__version__ = f"0.4.2+np{_np.__version__}"
+__version__ = f"0.4.3+np{_np.__version__}"
 __numpy_version__ = _np.__version__
 __numpy_pinned__ = _REGISTRY_META["numpy_version"]
 __numpy_supported__ = _REGISTRY_META.get("numpy_supported", ">=2.0.0,<2.5.0")
@@ -89,6 +89,7 @@ from flopscope.errors import (  # noqa: F401,E402
     SymmetryLossWarning,
     TimeExhaustedError,
     UnsupportedFunctionError,
+    UnsupportedReturnType,
 )
 
 
@@ -229,6 +230,7 @@ __all__ = [
     "SymmetryLossWarning",
     "TimeExhaustedError",
     "UnsupportedFunctionError",
+    "UnsupportedReturnType",
     "__numpy_pinned__",
     "__numpy_supported__",
     "__numpy_version__",

{flopscope-0.4.2 → flopscope-0.4.3}/src/flopscope/errors.py

@@ -131,6 +131,16 @@ class UnsupportedFunctionError(FlopscopeError):
         super().__init__(msg)
 
 
+class UnsupportedReturnType(FlopscopeError):
+    """Raised when an op's result cannot be serialized across the client/server boundary.
+
+    The op executed successfully on the server, but its return type is not one
+    the response packer knows how to send back (and is not msgpack-native).
+    Surfaced loudly — rather than silently degrading to ``str()`` — so such gaps
+    are caught by the conformance tests, not by participants.
+    """
+
+
 class FlopscopeWarning(UserWarning):
     """Warning issued when flopscope detects potential numerical issues."""