@steerable/runtime-darwin-arm64 0.0.0-stage → 0.9.1

package/python-runtime/python/lib/python3.12/site-packages/referencing/retrieval.py

@@ -0,0 +1,94 @@
+"""
+Helpers related to (dynamic) resource retrieval.
+"""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from typing import TYPE_CHECKING
+import json
+
+try:
+    from typing_extensions import TypeVar
+except ImportError:  # pragma: no cover
+    from typing import TypeVar
+
+from referencing import Resource
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from referencing.typing import URI, D, Retrieve
+
+#: A serialized document (e.g. a JSON string)
+_T = TypeVar("_T", default=str)
+
+
+def to_cached_resource(
+    cache: Callable[[Retrieve[D]], Retrieve[D]] | None = None,
+    loads: Callable[[_T], D] = json.loads,
+    from_contents: Callable[[D], Resource[D]] = Resource.from_contents,
+) -> Callable[[Callable[[URI], _T]], Retrieve[D]]:
+    """
+    Create a retriever which caches its return values from a simpler callable.
+
+    Takes a function which returns things like serialized JSON (strings) and
+    returns something suitable for passing to `Registry` as a retrieve
+    function.
+
+    This decorator both reduces a small bit of boilerplate for a common case
+    (deserializing JSON from strings and creating `Resource` objects from the
+    result) as well as makes the probable need for caching a bit easier.
+    Retrievers which otherwise do expensive operations (like hitting the
+    network) might otherwise be called repeatedly.
+
+    Examples
+    --------
+
+    .. testcode::
+
+        from referencing import Registry
+        from referencing.typing import URI
+        import referencing.retrieval
+
+
+        @referencing.retrieval.to_cached_resource()
+        def retrieve(uri: URI):
+            print(f"Retrieved {uri}")
+
+            # Normally, go get some expensive JSON from the network, a file ...
+            return '''
+                {
+                    "$schema": "https://json-schema.org/draft/2020-12/schema",
+                    "foo": "bar"
+                }
+            '''
+
+        one = Registry(retrieve=retrieve).get_or_retrieve("urn:example:foo")
+        print(one.value.contents["foo"])
+
+        # Retrieving the same URI again reuses the same value (and thus doesn't
+        # print another retrieval message here)
+        two = Registry(retrieve=retrieve).get_or_retrieve("urn:example:foo")
+        print(two.value.contents["foo"])
+
+    .. testoutput::
+
+        Retrieved urn:example:foo
+        bar
+        bar
+
+    """
+    if cache is None:
+        cache = lru_cache(maxsize=None)
+
+    def decorator(retrieve: Callable[[URI], _T]):
+        @cache
+        def cached_retrieve(uri: URI):
+            response = retrieve(uri)
+            contents = loads(response)
+            return from_contents(contents)
+
+        return cached_retrieve
+
+    return decorator

package/python-runtime/python/lib/python3.12/site-packages/referencing/typing.py

@@ -0,0 +1,61 @@
+"""
+Type-annotation related support for the referencing library.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping as Mapping
+from typing import TYPE_CHECKING, Any, Protocol
+
+try:
+    from typing_extensions import TypeVar
+except ImportError:  # pragma: no cover
+    from typing import TypeVar
+
+if TYPE_CHECKING:
+    from referencing._core import Resolved, Resolver, Resource
+
+#: A URI which identifies a `Resource`.
+URI = str
+
+#: The type of documents within a registry.
+D = TypeVar("D", default=Any)
+
+
+class Retrieve(Protocol[D]):
+    """
+    A retrieval callable, usable within a `Registry` for resource retrieval.
+
+    Does not make assumptions about where the resource might be coming from.
+    """
+
+    def __call__(self, uri: URI) -> Resource[D]:
+        """
+        Retrieve the resource with the given URI.
+
+        Raise `referencing.exceptions.NoSuchResource` if you wish to indicate
+        the retriever cannot lookup the given URI.
+        """
+        ...
+
+
+class Anchor(Protocol[D]):
+    """
+    An anchor within a `Resource`.
+
+    Beyond "simple" anchors, some specifications like JSON Schema's 2020
+    version have dynamic anchors.
+    """
+
+    @property
+    def name(self) -> str:
+        """
+        Return the name of this anchor.
+        """
+        ...
+
+    def resolve(self, resolver: Resolver[D]) -> Resolved[D]:
+        """
+        Return the resource for this anchor.
+        """
+        ...

package/python-runtime/python/lib/python3.12/site-packages/referencing-0.37.0.dist-info/INSTALLER

@@ -0,0 +1 @@
+pip

package/python-runtime/python/lib/python3.12/site-packages/referencing-0.37.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: referencing
+Version: 0.37.0
+Summary: JSON Referencing + Python
+Project-URL: Documentation, https://referencing.readthedocs.io/
+Project-URL: Homepage, https://github.com/python-jsonschema/referencing
+Project-URL: Issues, https://github.com/python-jsonschema/referencing/issues/
+Project-URL: Funding, https://github.com/sponsors/Julian
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-referencing?utm_source=pypi-referencing&utm_medium=referral&utm_campaign=pypi-link
+Project-URL: Changelog, https://referencing.readthedocs.io/en/stable/changes/
+Project-URL: Source, https://github.com/python-jsonschema/referencing
+Author-email: Julian Berman <Julian+referencing@GrayVines.com>
+License-Expression: MIT
+License-File: COPYING
+Keywords: asyncapi,json,jsonschema,openapi,referencing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: File Formats :: JSON
+Classifier: Topic :: File Formats :: JSON :: JSON Schema
+Requires-Python: >=3.10
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: rpds-py>=0.7.0
+Requires-Dist: typing-extensions>=4.4.0; python_version < '3.13'
+Description-Content-Type: text/x-rst
+
+===============
+``referencing``
+===============
+
+|PyPI| |Pythons| |CI| |ReadTheDocs| |pre-commit|
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/referencing.svg
+  :alt: PyPI version
+  :target: https://pypi.org/project/referencing/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/referencing.svg
+  :alt: Supported Python versions
+  :target: https://pypi.org/project/referencing/
+
+.. |CI| image:: https://github.com/python-jsonschema/referencing/workflows/CI/badge.svg
+  :alt: Build status
+  :target: https://github.com/python-jsonschema/referencing/actions?query=workflow%3ACI
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
+   :alt: ReadTheDocs status
+   :target: https://referencing.readthedocs.io/en/stable/
+
+.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/python-jsonschema/referencing/main.svg
+  :alt: pre-commit.ci status
+  :target: https://results.pre-commit.ci/latest/github/python-jsonschema/referencing/main
+
+
+An implementation-agnostic implementation of JSON reference resolution.
+
+See `the documentation <https://referencing.readthedocs.io/>`_ for more details.

package/python-runtime/python/lib/python3.12/site-packages/referencing-0.37.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+referencing-0.37.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+referencing-0.37.0.dist-info/METADATA,sha256=yTsA5qsVJP1ghIN2YEwYmhFDdHdkdcJaMdV75Hsp3mo,2845
+referencing-0.37.0.dist-info/RECORD,,
+referencing-0.37.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+referencing-0.37.0.dist-info/licenses/COPYING,sha256=QtzWNJX4e063x3V6-jebtVpT-Ur9el9lfZrfVyNuUVw,1057
+referencing/__init__.py,sha256=5IZKXaAH_FWyCJRkaTn1XcptLfg9cveLb9u5nYUxJKs,207
+referencing/__pycache__/__init__.cpython-312.pyc,,
+referencing/__pycache__/_attrs.cpython-312.pyc,,
+referencing/__pycache__/_core.cpython-312.pyc,,
+referencing/__pycache__/exceptions.cpython-312.pyc,,
+referencing/__pycache__/jsonschema.cpython-312.pyc,,
+referencing/__pycache__/retrieval.cpython-312.pyc,,
+referencing/__pycache__/typing.cpython-312.pyc,,
+referencing/_attrs.py,sha256=bgT-KMhDVLeGtWxM_SGKYeLaZBFzT2kUVFdAkOcXi8g,791
+referencing/_attrs.pyi,sha256=g2wX-aLEqQAvWU-s0qIN2OMGAqjOA0R72R_uSffO8_M,573
+referencing/_core.py,sha256=2SPGfaTvzA3sRqbj_4R2wC--fiXolCUVpLFLJJ6zdZ8,24732
+referencing/exceptions.py,sha256=zFgaEg6WiKeT58MQuKNsgGDnHszp26c4oReC6sF9gHM,4176
+referencing/jsonschema.py,sha256=jXZ6t6x9oTvTHMIC0tRyaFjW5r2qeHObYuu7UhSfK3Q,18615
+referencing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+referencing/retrieval.py,sha256=cn9EeAdaaTbnMDdC4JRIhiEpXDjflRdHCOLFrw1ZhLA,2729
+referencing/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+referencing/tests/__pycache__/__init__.cpython-312.pyc,,
+referencing/tests/__pycache__/test_core.cpython-312.pyc,,
+referencing/tests/__pycache__/test_exceptions.cpython-312.pyc,,
+referencing/tests/__pycache__/test_jsonschema.cpython-312.pyc,,
+referencing/tests/__pycache__/test_referencing_suite.cpython-312.pyc,,
+referencing/tests/__pycache__/test_retrieval.cpython-312.pyc,,
+referencing/tests/test_core.py,sha256=eap0CAaI23vjMIbVyEj92qLddp3iHH3AxC55CKUN4LU,37854
+referencing/tests/test_exceptions.py,sha256=7eOdHyobXMt7-h5AnnH7u8iw2uHPaH7U4Bs9JhLgjWo,934
+referencing/tests/test_jsonschema.py,sha256=4QnjUWOAMAn5yeA8ZtldJkhI54vwKWJWB0LDzNdx5xc,11687
+referencing/tests/test_referencing_suite.py,sha256=wD6veMfLsUu0s4MLjm7pS8cg4cIfL7FMBENngk73zCI,2335
+referencing/tests/test_retrieval.py,sha256=vcbnfA4TqVeqUzW073wO-nLeqVIv0rQZWNWv0z9km48,3719
+referencing/typing.py,sha256=WjUbnZ6jPAd31cnCFAaeWIVENzyHtHdJyOlelv1GY70,1445

package/python-runtime/python/lib/python3.12/site-packages/referencing-0.37.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

package/python-runtime/python/lib/python3.12/site-packages/rpds/__init__.py

@@ -0,0 +1,5 @@
+from .rpds import *
+
+__doc__ = rpds.__doc__
+if hasattr(rpds, "__all__"):
+    __all__ = rpds.__all__

package/python-runtime/python/lib/python3.12/site-packages/rpds/__init__.pyi

@@ -0,0 +1,79 @@
+from collections.abc import (
+    ItemsView,
+    Iterable,
+    Iterator,
+    KeysView,
+    Mapping,
+    ValuesView,
+)
+from typing import (
+    TypeVar,
+)
+
+_T = TypeVar("_T")
+_KT_co = TypeVar("_KT_co", covariant=True)
+_VT_co = TypeVar("_VT_co", covariant=True)
+_KU_co = TypeVar("_KU_co", covariant=True)
+_VU_co = TypeVar("_VU_co", covariant=True)
+
+class HashTrieMap(Mapping[_KT_co, _VT_co]):
+    def __init__(
+        self,
+        value: Mapping[_KT_co, _VT_co] | Iterable[tuple[_KT_co, _VT_co]] = {},
+        **kwds: Mapping[_KT_co, _VT_co],
+    ): ...
+    def __getitem__(self, key: _KT_co) -> _VT_co: ...
+    def __iter__(self) -> Iterator[_KT_co]: ...
+    def __len__(self) -> int: ...
+    def discard(self, key: _KT_co) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def items(self) -> ItemsView[_KT_co, _VT_co]: ...
+    def keys(self) -> KeysView[_KT_co]: ...
+    def values(self) -> ValuesView[_VT_co]: ...
+    def remove(self, key: _KT_co) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def insert(
+        self,
+        key: _KT_co,
+        val: _VT_co,
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+    def update(
+        self,
+        *args: Mapping[_KU_co, _VU_co] | Iterable[tuple[_KU_co, _VU_co]],
+    ) -> HashTrieMap[_KT_co | _KU_co, _VT_co | _VU_co]: ...
+    @classmethod
+    def convert(
+        cls,
+        value: Mapping[_KT_co, _VT_co] | Iterable[tuple[_KT_co, _VT_co]],
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+    @classmethod
+    def fromkeys(
+        cls,
+        keys: Iterable[_KT_co],
+        value: _VT_co = None,
+    ) -> HashTrieMap[_KT_co, _VT_co]: ...
+
+class HashTrieSet(frozenset[_T]):
+    def __init__(self, value: Iterable[_T] = ()): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def discard(self, value: _T) -> HashTrieSet[_T]: ...
+    def remove(self, value: _T) -> HashTrieSet[_T]: ...
+    def insert(self, value: _T) -> HashTrieSet[_T]: ...
+    def update(self, *args: Iterable[_T]) -> HashTrieSet[_T]: ...
+
+class List(Iterable[_T]):
+    def __init__(self, value: Iterable[_T] = (), *more: _T): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def push_front(self, value: _T) -> List[_T]: ...
+    def drop_first(self) -> List[_T]: ...
+
+class Queue(Iterable[_T]):
+    def __init__(self, value: Iterable[_T] = (), *more: _T): ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __len__(self) -> int: ...
+    def enqueue(self, value: _T) -> Queue[_T]: ...
+    def dequeue(self, value: _T) -> Queue[_T]: ...
+    @property
+    def is_empty(self) -> _T: ...
+    @property
+    def peek(self) -> _T: ...

package/python-runtime/python/lib/python3.12/site-packages/rpds_py-2026.9.1.dist-info/INSTALLER

@@ -0,0 +1 @@
+pip

package/python-runtime/python/lib/python3.12/site-packages/rpds_py-2026.9.1.dist-info/METADATA

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: rpds-py
+Version: 2026.9.1
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+License-File: LICENSE
+Summary: Python bindings to Rust's persistent data structures (rpds)
+Keywords: data structures,rust,persistent
+Author-email: Julian Berman <Julian+rpds@GrayVines.com>
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst; charset=UTF-8
+Project-URL: Documentation, https://rpds.readthedocs.io/
+Project-URL: Funding, https://github.com/sponsors/Julian
+Project-URL: Homepage, https://github.com/crate-py/rpds
+Project-URL: Issues, https://github.com/crate-py/rpds/issues/
+Project-URL: Source, https://github.com/crate-py/rpds
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-rpds-py?utm_source=pypi-rpds-py&utm_medium=referral&utm_campaign=pypi-link
+Project-URL: Upstream, https://github.com/orium/rpds
+
+===========
+``rpds.py``
+===========
+
+|PyPI| |Pythons| |CI|
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/rpds-py.svg
+  :alt: PyPI version
+  :target: https://pypi.org/project/rpds-py/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/rpds-py.svg
+  :alt: Supported Python versions
+  :target: https://pypi.org/project/rpds-py/
+
+.. |CI| image:: https://github.com/crate-py/rpds/workflows/CI/badge.svg
+  :alt: Build status
+  :target: https://github.com/crate-py/rpds/actions?query=workflow%3ACI
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
+   :alt: ReadTheDocs status
+   :target: https://referencing.readthedocs.io/en/stable/
+
+
+Python bindings to the `Rust rpds crate <https://docs.rs/rpds/>`_ for persistent data structures.
+
+What's here is quite minimal (in transparency, it was written initially to support replacing ``pyrsistent`` in the `referencing library <https://github.com/python-jsonschema/referencing>`_).
+If you see something missing (which is very likely), a PR is definitely welcome to add it.
+
+Installation
+------------
+
+The distribution on PyPI is named ``rpds.py`` (equivalently ``rpds-py``), and thus can be installed via e.g.:
+
+.. code:: sh
+
+    $ pip install rpds-py
+
+Note that if you install ``rpds-py`` from source, you will need a Rust toolchain installed, as it is a build-time dependency.
+An example of how to do so in a ``Dockerfile`` can be found `here <https://github.com/bowtie-json-schema/bowtie/blob/e77fd93598cb6e7dc1b8b1f53c00e5aa410c201a/implementations/python-jsonschema/Dockerfile#L1-L8>`_.
+
+If you believe you are on a common platform which should have wheels built (i.e. and not need to compile from source), feel free to file an issue or pull request modifying the GitHub action used here to build wheels via ``maturin``.
+
+Usage
+-----
+
+Methods in general are named similarly to their ``rpds`` counterparts (rather than ``pyrsistent``\ 's conventions, though probably a full drop-in ``pyrsistent``\ -compatible wrapper module is a good addition at some point).
+
+.. code:: python
+
+    >>> from rpds import HashTrieMap, HashTrieSet, List
+
+    >>> m = HashTrieMap({"foo": "bar", "baz": "quux"})
+    >>> m.insert("spam", 37) == HashTrieMap({"foo": "bar", "baz": "quux", "spam": 37})
+    True
+    >>> m.remove("foo") == HashTrieMap({"baz": "quux"})
+    True
+
+    >>> s = HashTrieSet({"foo", "bar", "baz", "quux"})
+    >>> s.insert("spam") == HashTrieSet({"foo", "bar", "baz", "quux", "spam"})
+    True
+    >>> s.remove("foo") == HashTrieSet({"bar", "baz", "quux"})
+    True
+
+    >>> L = List([1, 3, 5])
+    >>> L.push_front(-1) == List([-1, 1, 3, 5])
+    True
+    >>> L.rest == List([3, 5])
+    True
+

package/python-runtime/python/lib/python3.12/site-packages/rpds_py-2026.9.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+rpds/__init__.py,sha256=w3MgXW7lpTCICw0KXbw20QX573_kbsEnWIeMsCAugvM,99
+rpds/__init__.pyi,sha256=am7x6oMa_pu_kv1NlolqJbPr6_UvCvoyxGKrDGSMKEk,2602
+rpds/__pycache__/__init__.cpython-312.pyc,,
+rpds/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rpds/rpds.cpython-312-darwin.so,sha256=eS3a_yHAiR9ydZCNVOadEx7m-626a0C7qtVWwu29-Ec,960400
+rpds_py-2026.9.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+rpds_py-2026.9.1.dist-info/METADATA,sha256=XXLcouOHyNK0GAto7ofBW2R1HgWRAKbbWIkeyZlURcM,4147
+rpds_py-2026.9.1.dist-info/RECORD,,
+rpds_py-2026.9.1.dist-info/WHEEL,sha256=AEMq9lq64hpQaS74UK5h-nEB6yKwT7LR48YWeHENflM,105
+rpds_py-2026.9.1.dist-info/licenses/LICENSE,sha256=MU5Okb47qpPA-0vMyeTpfNZD64ObBlr5IXgsIXX-mQk,1057
+rpds_py-2026.9.1.dist-info/sboms/rpds-py.cyclonedx.json,sha256=aKeKW6VzYwU30tANpkcl1EklVfVXDtx2JRHf4nRPQ2o,20597

package/python-runtime/python/lib/python3.12/site-packages/rpds_py-2026.9.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.15.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-macosx_11_0_arm64

package/python-runtime/python/lib/python3.12/site-packages/socksio/__init__.py

@@ -0,0 +1,46 @@
+"""Sans-I/O implementation of SOCKS4, SOCKS4A, and SOCKS5."""
+
+from .exceptions import ProtocolError, SOCKSError
+from .socks4 import (
+    SOCKS4ARequest,
+    SOCKS4Command,
+    SOCKS4Connection,
+    SOCKS4Reply,
+    SOCKS4ReplyCode,
+    SOCKS4Request,
+)
+from .socks5 import (
+    SOCKS5AType,
+    SOCKS5AuthMethod,
+    SOCKS5AuthMethodsRequest,
+    SOCKS5AuthReply,
+    SOCKS5Command,
+    SOCKS5CommandRequest,
+    SOCKS5Connection,
+    SOCKS5Reply,
+    SOCKS5ReplyCode,
+    SOCKS5UsernamePasswordRequest,
+)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "SOCKS4Request",
+    "SOCKS4ARequest",
+    "SOCKS4Reply",
+    "SOCKS4Connection",
+    "SOCKS4Command",
+    "SOCKS4ReplyCode",
+    "SOCKS5AType",
+    "SOCKS5AuthMethodsRequest",
+    "SOCKS5AuthReply",
+    "SOCKS5AuthMethod",
+    "SOCKS5Connection",
+    "SOCKS5Command",
+    "SOCKS5CommandRequest",
+    "SOCKS5ReplyCode",
+    "SOCKS5Reply",
+    "SOCKS5UsernamePasswordRequest",
+    "SOCKSError",
+    "ProtocolError",
+]

package/python-runtime/python/lib/python3.12/site-packages/socksio/_types.py

@@ -0,0 +1,3 @@
+import typing
+
+StrOrBytes = typing.Union[str, bytes]

package/python-runtime/python/lib/python3.12/site-packages/socksio/compat.py

@@ -0,0 +1,86 @@
+"""Backport of @functools.singledispatchmethod to Python <3.7.
+
+Adapted from https://github.com/ikalnytskyi/singledispatchmethod
+removing 2.7 specific code.
+"""
+
+import functools
+import typing
+
+if hasattr(functools, "singledispatchmethod"):  # pragma: nocover
+    singledispatchmethod = functools.singledispatchmethod  # type: ignore
+else:
+    update_wrapper = functools.update_wrapper
+    singledispatch = functools.singledispatch
+
+    # The type: ignore below is to avoid mypy erroring due to a
+    # "already defined" singledispatchmethod, oddly this does not
+    # happen when using `if sys.version_info >= (3, 8)`
+
+    class singledispatchmethod(object):  # type: ignore
+        """Single-dispatch generic method descriptor.
+
+        TODO: Figure out how to type this:
+
+        `mypy --strict` returns errors like the following for all decorated methods:
+        "Untyped decorator makes function "send" untyped."
+
+        But this is not a normal function-base decorator, it's a class and it
+        doesn't have a __call__ method. When decorating the "base" method
+        __init__ is called, but of course its return type is None.
+        """
+
+        def __init__(self, func: typing.Callable[..., typing.Any]) -> None:
+            if not callable(func) and not hasattr(func, "__get__"):
+                raise TypeError("{!r} is not callable or a descriptor".format(func))
+
+            self.dispatcher = singledispatch(func)
+            self.func = func
+
+        def register(
+            self,
+            cls: typing.Callable[..., typing.Any],
+            method: typing.Optional[typing.Callable[..., typing.Any]] = None,
+        ) -> typing.Callable[..., typing.Any]:
+            """Register a method on a class for a particular type.
+
+            Note in Python <= 3.6 this methods cannot infer the type from the
+            argument's type annotation, users *must* supply it manually on
+            decoration, i.e.
+
+            @my_method.register(TypeToDispatch)
+            def _(self, arg: TypeToDispatch) -> None:
+                ...
+
+            Versus in Python 3.7+:
+
+            @my_method.register
+            def _(self, arg: TypeToDispatch) -> None:
+                ...
+
+            """
+            # mypy wants method to be non-optional, but it is required to be
+            # for decoration to work correctly in our case.
+            # https://github.com/python/cpython/blob/3.8/Lib/functools.py#L887-L920
+            # is not type annotated either.
+            return self.dispatcher.register(cls, func=method)  # type: ignore
+
+        def __get__(
+            self, obj: typing.Any, cls: typing.Callable[[typing.Any], typing.Any]
+        ) -> typing.Callable[..., typing.Any]:
+            def _method(*args: typing.Any, **kwargs: typing.Any) -> typing.Any:
+                method = self.dispatcher.dispatch(args[0].__class__)  # type: typing.Any
+                return method.__get__(obj, cls)(*args, **kwargs)
+
+            # The type: ignore below is due to `_method` being given a strict
+            # "Callable[[VarArg(Any), KwArg(Any)], Any]" which causes a
+            # 'has no attribute "__isabstractmethod__" error'
+            # felt safe enough to ignore
+            _method.__isabstractmethod__ = self.__isabstractmethod__  # type: ignore
+            _method.register = self.register  # type: ignore
+            update_wrapper(_method, self.func)
+            return _method
+
+        @property
+        def __isabstractmethod__(self) -> typing.Any:
+            return getattr(self.func, "__isabstractmethod__", False)

package/python-runtime/python/lib/python3.12/site-packages/socksio/exceptions.py

@@ -0,0 +1,6 @@
+class SOCKSError(Exception):
+    """Generic exception for when something goes wrong"""
+
+
+class ProtocolError(SOCKSError):
+    pass