faster-hexbytes 1.3.2__cp310-cp310-win_amd64.whl

faster_hexbytes/__init__.py

@@ -0,0 +1,11 @@
+from importlib.metadata import (
+    version as __version,
+)
+
+from faster_hexbytes.main import (
+    HexBytes,
+)
+
+__all__ = ["HexBytes"]
+
+__version__ = __version("hexbytes")

faster_hexbytes/_utils.py

@@ -0,0 +1,58 @@
+import binascii
+from typing import (
+    Final,
+    Union,
+)
+
+
+unhexlify: Final = binascii.unhexlify
+
+
+def to_bytes(val: Union[bytes, str, bytearray, bool, int, memoryview]) -> bytes:
+    """
+    Equivalent to: `faster_eth_utils.hexstr_if_str(faster_eth_utils.to_bytes, val)` .
+
+    Convert a hex string, integer, or bool, to a bytes representation.
+    Alternatively, pass through bytes or bytearray as a bytes value.
+    """
+    if isinstance(val, bytes):
+        return val
+    elif isinstance(val, str):
+        return hexstr_to_bytes(val)
+    elif isinstance(val, bytearray):
+        return bytes(val)
+    elif isinstance(val, bool):
+        return b"\x01" if val else b"\x00"
+    elif isinstance(val, int):
+        # Note that this int check must come after the bool check, because
+        #   isinstance(True, int) is True
+        if val < 0:
+            raise ValueError(f"Cannot convert negative integer {val} to bytes")
+        else:
+            return to_bytes(hex(val))
+    elif isinstance(val, memoryview):
+        return bytes(val)
+    else:
+        raise TypeError(f"Cannot convert {val!r} of type {type(val)} to bytes")
+
+
+def hexstr_to_bytes(hexstr: str) -> bytes:
+    if hexstr.startswith(("0x", "0X")):
+        non_prefixed_hex = hexstr[2:]
+    else:
+        non_prefixed_hex = hexstr
+
+    # if the hex string is odd-length, then left-pad it to an even length
+    if len(hexstr) % 2:
+        padded_hex = "0" + non_prefixed_hex
+    else:
+        padded_hex = non_prefixed_hex
+
+    try:
+        ascii_hex = padded_hex.encode("ascii")
+    except UnicodeDecodeError:
+        raise ValueError(
+            f"hex string {padded_hex} may only contain [0-9a-fA-F] characters"
+        )
+    else:
+        return unhexlify(ascii_hex)

faster_hexbytes/main.py

@@ -0,0 +1,101 @@
+from typing import (
+    TYPE_CHECKING,
+    Callable,
+    Final,
+    Tuple,
+    Type,
+    Union,
+    overload,
+)
+
+# accessing hexbytes.HexBytes after `import hexbytes`
+# fails because mypyc tries to lookup HexBytes from
+# CPyModule_hexbytes___main which was never imported
+import hexbytes.main as hexbytes
+from mypy_extensions import (
+    mypyc_attr,
+)
+from typing_extensions import (
+    Self,
+)
+
+from faster_hexbytes._utils import (
+    to_bytes,
+)
+
+if TYPE_CHECKING:
+    from typing import (
+        SupportsIndex,
+    )
+
+
+BytesLike = Union[bytes, str, bool, bytearray, int, memoryview]
+
+_bytes_new: Final = bytes.__new__
+
+
+@mypyc_attr(native_class=False, allow_interpreted_subclasses=True)
+class HexBytes(hexbytes.HexBytes):
+    """
+    Thin wrapper around the python built-in :class:`bytes` class.
+
+    It has these changes:
+        1. Accepts more initializing values: bool, bytearray, bytes, (non-negative) int,
+           str, and memoryview
+        2. The representation at console (__repr__) is 0x-prefixed
+        3. ``to_0x_hex`` returns a 0x-prefixed hex string
+    """
+
+    def __new__(cls, val: BytesLike) -> Self:
+        bytesval = to_bytes(val)
+        return _bytes_new(cls, bytesval)
+
+    @overload
+    def __getitem__(self, key: "SupportsIndex") -> int:  # noqa: F811
+        ...
+
+    @overload  # noqa: F811
+    def __getitem__(self, key: slice) -> Self:  # noqa: F811
+        ...
+
+    def __getitem__(  # noqa: F811
+        self, key: Union["SupportsIndex", slice]
+    ) -> Union[int, Self]:
+        result = bytes.__getitem__(self, key)
+        if isinstance(result, int):
+            return result
+        cls = type(self)
+        if cls is HexBytes:
+            # fast-path case with faster C code for non-subclass
+            return HexBytes(result)  # type: ignore [return-value]
+        return cls(result)
+
+    def __repr__(self) -> str:
+        return f"HexBytes('0x{self.hex()}')"
+
+    def to_0x_hex(self) -> str:
+        """
+        Convert the bytes to a 0x-prefixed hex string
+        """
+        return f"0x{self.hex()}"
+
+    def __reduce__(
+        self,
+    ) -> Tuple[Callable[..., bytes], Tuple[Type["HexBytes"], bytes]]:
+        """
+        An optimized ``__reduce__`` that bypasses the input validation in
+        ``HexBytes.__new__`` since an existing HexBytes instance has already been
+        validated when created.
+        """
+        return _bytes_new, (type(self), bytes(self))
+
+
+# these 3 helpers serve as a workaround for a mypyc bug until
+# https://github.com/python/mypy/pull/19957 is merged and released
+
+@mypyc_attr(native_class=False)
+class _HexBytesSubclass1(HexBytes): ...
+@mypyc_attr(native_class=False)
+class _HexBytesSubclass2(HexBytes): ...
+@mypyc_attr(native_class=False)
+class _HexBytesSubclass3(HexBytes): ...

faster_hexbytes/py.typed

@@ -0,0 +1 @@
+

faster_hexbytes-1.3.2.dist-info/METADATA

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: faster_hexbytes
+Version: 1.3.2
+Summary: A faster fork of hexbytes: Python `bytes` subclass that decodes hex, with a readable console output. Implemented in C.
+Home-page: https://github.com/ethereum/hexbytes
+Author: The Ethereum Foundation
+Author-email: snakecharmers@ethereum.org
+License: MIT
+Keywords: ethereum
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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
+Requires-Python: >=3.9, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: hexbytes==1.3.1
+Requires-Dist: mypy_extensions
+Provides-Extra: dev
+Requires-Dist: build>=0.9.0; extra == "dev"
+Requires-Dist: bump_my_version>=0.19.0; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: mypy==1.10.0; extra == "dev"
+Requires-Dist: pre-commit>=3.4.0; extra == "dev"
+Requires-Dist: tox>=4.0.0; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: sphinx>=6.0.0; extra == "dev"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "dev"
+Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "dev"
+Requires-Dist: towncrier<25,>=24; extra == "dev"
+Requires-Dist: eth_utils>=2.0.0; extra == "dev"
+Requires-Dist: hypothesis>=3.44.24; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=6.0.0; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "docs"
+Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "docs"
+Requires-Dist: towncrier<25,>=24; extra == "docs"
+Provides-Extra: test
+Requires-Dist: eth_utils>=2.0.0; extra == "test"
+Requires-Dist: hypothesis>=3.44.24; extra == "test"
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "test"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# HexBytes
+
+[![Join the conversation on Discord](https://img.shields.io/discord/809793915578089484?color=blue&label=chat&logo=discord&logoColor=white)](https://discord.gg/GHryRvPB84)
+[![Build Status](https://circleci.com/gh/ethereum/hexbytes.svg?style=shield)](https://circleci.com/gh/ethereum/hexbytes)
+[![PyPI version](https://badge.fury.io/py/hexbytes.svg)](https://badge.fury.io/py/hexbytes)
+[![Python versions](https://img.shields.io/pypi/pyversions/hexbytes.svg)](https://pypi.python.org/pypi/hexbytes)
+[![Docs build](https://readthedocs.org/projects/hexbytes/badge/?version=latest)](https://hexbytes.readthedocs.io/en/latest/?badge=latest)
+
+Python `bytes` subclass that decodes hex, with a readable console output
+
+Read the [documentation](https://hexbytes.readthedocs.io/).
+
+View the [change log](https://hexbytes.readthedocs.io/en/latest/release_notes.html).
+
+## Installation
+
+```sh
+python -m pip install hexbytes
+```

faster_hexbytes-1.3.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+6a32f4913d613d6a7ddf__mypyc.cp310-win_amd64.pyd,sha256=aXRNo6yVRJ95N1tTDVOSQCOA3KWS9NH5tRIQrYoxXVg,57344
+faster_hexbytes/__init__.cp310-win_amd64.pyd,sha256=t0oz5UeanbaR32W5uN3-hP86dW41r_IJLIPCSALjXsQ,10752
+faster_hexbytes/__init__.py,sha256=ydnGcx4ny2H1UjCnkxW0qn0u0G0Yo8pERQuZOKxbfP0,185
+faster_hexbytes/_utils.cp310-win_amd64.pyd,sha256=uaa8lj3b2mBpxhK_U2ZVqLY_dDd0UnT7QZpzRXZovH8,10752
+faster_hexbytes/_utils.py,sha256=3Zp_hNNM_uyVVwJGfKs3dzeKryGEs_pjjOWi6KzqrcM,1801
+faster_hexbytes/main.cp310-win_amd64.pyd,sha256=ctB2u2OnMvNH7kJSWAFa__UaL73CSPbc_lVCHfAC70I,10752
+faster_hexbytes/main.py,sha256=kxGxXjm8gDpX3F3xs_F-qixqhkxdo3TENGHoYfALHTw,2876
+faster_hexbytes/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+faster_hexbytes-1.3.2.dist-info/licenses/LICENSE,sha256=0yDgluyUXL4Wtez0QidbRbAJ8gPmBCH_PVss1vyL_Q4,1116
+faster_hexbytes-1.3.2.dist-info/METADATA,sha256=7JImJ0mkenTtVVLlYXZz8qTBV-rqdlyXbgOcE3jaSJ8,3600
+faster_hexbytes-1.3.2.dist-info/WHEEL,sha256=KUuBC6lxAbHCKilKua8R9W_TM71_-9Sg5uEP3uDWcoU,101
+faster_hexbytes-1.3.2.dist-info/top_level.txt,sha256=xJbUGq2PZqSSdlvVDwPydJ9IkMtDVoLg-DVy83iOh58,44
+faster_hexbytes-1.3.2.dist-info/RECORD,,

faster_hexbytes-1.3.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-win_amd64
+

faster_hexbytes-1.3.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019-2025 The Ethereum Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

faster_hexbytes-1.3.2.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+6a32f4913d613d6a7ddf__mypyc
+faster_hexbytes