metta-websocket 0.9.2__tar.gz

metta_websocket-0.9.2/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: metta-websocket
+Version: 0.9.2
+Summary: websocket-client's own timeouts, so an absent MeTTa backend reads as absent
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pymetta==0.9.2
+Requires-Dist: websocket-client
+
+# metta-websocket
+
+websocket-client's own timeouts, so an absent MeTTa backend reads as absent.
+
+`pymetta` names no third-party library. This package is one row against the `transport-error` point, and the seat
+finds it exactly as it finds a package written by somebody else: through the
+`metta.extensions` entry point, loaded at the first dispatch that has no answer
+without it, or through `import metta_websocket`, whose module body registers the same
+rows.
+
+```sh
+pip install metta-websocket          # or: pip install 'pymetta[das]'
+```
+
+Its tests are in `tests/`, and they run in the workspace suite:
+
+```sh
+sh extensions/python/test.sh ext/metta-websocket
+```

metta_websocket-0.9.2/README.md

@@ -0,0 +1,19 @@
+# metta-websocket
+
+websocket-client's own timeouts, so an absent MeTTa backend reads as absent.
+
+`pymetta` names no third-party library. This package is one row against the `transport-error` point, and the seat
+finds it exactly as it finds a package written by somebody else: through the
+`metta.extensions` entry point, loaded at the first dispatch that has no answer
+without it, or through `import metta_websocket`, whose module body registers the same
+rows.
+
+```sh
+pip install metta-websocket          # or: pip install 'pymetta[das]'
+```
+
+Its tests are in `tests/`, and they run in the workspace suite:
+
+```sh
+sh extensions/python/test.sh ext/metta-websocket
+```

metta_websocket-0.9.2/metta_websocket.egg-info/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: metta-websocket
+Version: 0.9.2
+Summary: websocket-client's own timeouts, so an absent MeTTa backend reads as absent
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pymetta==0.9.2
+Requires-Dist: websocket-client
+
+# metta-websocket
+
+websocket-client's own timeouts, so an absent MeTTa backend reads as absent.
+
+`pymetta` names no third-party library. This package is one row against the `transport-error` point, and the seat
+finds it exactly as it finds a package written by somebody else: through the
+`metta.extensions` entry point, loaded at the first dispatch that has no answer
+without it, or through `import metta_websocket`, whose module body registers the same
+rows.
+
+```sh
+pip install metta-websocket          # or: pip install 'pymetta[das]'
+```
+
+Its tests are in `tests/`, and they run in the workspace suite:
+
+```sh
+sh extensions/python/test.sh ext/metta-websocket
+```

metta_websocket-0.9.2/metta_websocket.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+metta_websocket.py
+pyproject.toml
+metta_websocket.egg-info/PKG-INFO
+metta_websocket.egg-info/SOURCES.txt
+metta_websocket.egg-info/dependency_links.txt
+metta_websocket.egg-info/entry_points.txt
+metta_websocket.egg-info/requires.txt
+metta_websocket.egg-info/top_level.txt
+tests/test_websocket.py

metta_websocket-0.9.2/metta_websocket.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

metta_websocket-0.9.2/metta_websocket.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[metta.extensions]
+metta-websocket = metta_websocket

metta_websocket-0.9.2/metta_websocket.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pymetta==0.9.2
+websocket-client

metta_websocket-0.9.2/metta_websocket.egg-info/top_level.txt

@@ -0,0 +1 @@
+metta_websocket

metta_websocket-0.9.2/metta_websocket.py

@@ -0,0 +1,42 @@
+"""Purpose: websocket-client's own timeouts, so an absent backend reads as absent.
+
+`metta._errors.errors.is_transport_failure` asks whether a failure means the backend is
+ABSENT rather than wrong, which decides whether a client retries or reports.
+The obvious test does not separate them: a socket timeout raises OSError, but
+websocket-client's own timeout does NOT subclass it, so "is the cause an
+OSError" misses exactly the shape a broken event stream takes under load. One
+row against the seat's `transport-error` point says which classes those are.
+
+Installed beside pymetta, or through `pip install 'pymetta[das]'`. The row
+holds the module NAME and imports nothing; the classes are read only when a
+failure is actually classified, and only if websocket-client is imported.
+
+Assumes:
+  - the two exception classes keep their names, which is the only thing this
+    row knows about the library
+Guarantees:
+  - a websocket timeout and a closed stream both read as transport failures,
+    and an ordinary application error does not [tested: tests/test_websocket.py;
+    commit=94057a0f073c0fab0a35c42beff2c324d8a0addd]
+Open Obligations:
+  To Do: None
+  Hacks: None
+  Future Enhancements: None
+"""
+
+from __future__ import annotations
+
+from metta import seam
+
+
+def _classes(module) -> tuple[type[BaseException], ...]:
+    """websocket-client's own timeout and closed-stream exceptions."""
+    return (module.WebSocketTimeoutException, module.WebSocketConnectionClosedException)
+
+
+def register() -> None:
+    """This package's one row, against the seat's `transport-error` point."""
+    seam.transport_error.register("websocket", module="websocket", classes=_classes)
+
+
+register()

metta_websocket-0.9.2/pyproject.toml

@@ -0,0 +1,40 @@
+# Purpose: package metta-websocket, one distribution for one library.
+# Assumes: pymetta of the same version is installed; this is a workspace member
+#   released with it and pinned to it exactly.
+# Guarantees: importing metta_websocket registers this package's rows, and so does the
+#   `metta.extensions` entry point below when a dispatch discovers it.
+# Decides: the dependency set is this library and nothing else, which is what
+#   makes "the core names no library" hold without an allowlist.
+[build-system]
+requires = ["setuptools>=83"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "metta-websocket"
+version = "0.9.2"
+description = "websocket-client's own timeouts, so an absent MeTTa backend reads as absent"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+dependencies = [
+    #: pymetta of exactly this version. A member is released with the core and
+    #: reads its seam, so a floating pin would let a row meet a seam that no
+    #: longer declares its point.
+    "pymetta==0.9.2",
+    "websocket-client",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Intended Audience :: Science/Research",
+]
+
+#: How a seat that never heard of this package finds it: one entry in the
+#: group `metta.seam` reads, loaded at the first dispatch that has no answer
+#: without it. The target is the MODULE, whose body registers on import, which
+#: is the same door `import metta_websocket` opens.
+[project.entry-points."metta.extensions"]
+metta-websocket = "metta_websocket"
+
+[tool.setuptools]
+py-modules = ["metta_websocket"]

metta_websocket-0.9.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

metta_websocket-0.9.2/tests/test_websocket.py

@@ -0,0 +1,42 @@
+"""Purpose: prove the websocket row classes an absent backend as absent.
+
+`is_transport_failure` decides whether a client retries or reports. The library
+this package names raises a timeout that does NOT subclass OSError, which is
+the shape the obvious test misses and the whole reason for the row.
+Open Obligations:
+  To Do: None
+  Hacks: None
+  Future Enhancements: None
+"""
+
+from __future__ import annotations
+
+import metta_websocket  # noqa: F401  -- imported for the transport-error row
+import pytest
+
+from metta import is_transport_failure, seam
+
+websocket = pytest.importorskip("websocket")
+
+
+def test_the_row_is_registered_against_the_transport_error_point():
+    """One row, holding the module NAME rather than the module."""
+    row = seam.transport_error.find("websocket")
+    assert row is not None
+    assert row.module == "websocket"
+
+
+def test_a_websocket_timeout_reads_as_an_absent_backend():
+    """The class this library raises under load, which is not an OSError."""
+    assert not isinstance(websocket.WebSocketTimeoutException(), OSError)
+    assert is_transport_failure(websocket.WebSocketTimeoutException("gone"))
+
+
+def test_a_closed_stream_reads_as_an_absent_backend():
+    """The other half: a stream the peer closed is absence, not an error."""
+    assert is_transport_failure(websocket.WebSocketConnectionClosedException("closed"))
+
+
+def test_an_application_error_does_not():
+    """Wrong is not absent, which is the distinction the door exists for."""
+    assert not is_transport_failure(ValueError("wrong, not absent"))