faster-hexbytes 1.3.9__cp315-cp315t-win32.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,61 @@
+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 val.to_bytes(max(1, (val.bit_length() + 7) // 8), "big")
+    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") or hexstr.startswith("0X"):
+        non_prefixed_hex = hexstr[2:]
+    else:
+        non_prefixed_hex = hexstr
+
+    if not non_prefixed_hex:
+        return b""
+
+    # if the hex string is odd-length, then left-pad it to an even length
+    if len(non_prefixed_hex) & 1:
+        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,110 @@
+from typing import (
+    TYPE_CHECKING,
+    Callable,
+    Final,
+    Union,
+    cast,
+    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, acyclic=True, 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:
+        if type(val) is cls:
+            # These are immutable, just return it
+            return val
+        elif isinstance(val, bytes):
+            # These don't require `to_bytes`
+            return _bytes_new(cls, val)
+        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
+            if isinstance(key, slice):
+                # fast-path case to skip __init__
+                return cast(Self, _bytes_new(HexBytes, result))
+            else:
+                return cast(Self, HexBytes(result))
+        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.9.dist-info/METADATA

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: faster_hexbytes
+Version: 1.3.9
+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/BobTheBuidler/faster-hexbytes
+Author: The Ethereum Foundation
+Author-email: snakecharmers@ethereum.org
+License: MIT
+Project-URL: Documentation, https://hexbytes.readthedocs.io/en/stable/
+Project-URL: Release Notes, https://github.com/BobTheBuidler/faster-hexbytes/releases
+Project-URL: Issues, https://github.com/BobTheBuidler/faster-hexbytes/issues
+Project-URL: Source - Precompiled (.py), https://github.com/BobTheBuidler/faster-hexbytes/tree/master/faster_eth_utils
+Project-URL: Source - Compiled (.c), https://github.com/BobTheBuidler/faster-hexbytes/tree/master/build
+Project-URL: Benchmarks, https://github.com/BobTheBuidler/faster-hexbytes/tree/master/benchmarks
+Project-URL: Benchmarks - Results, https://github.com/BobTheBuidler/faster-hexbytes/tree/master/benchmarks/results
+Project-URL: Original, https://github.com/ethereum/hexbytes
+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.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 :: 3.15
+Requires-Python: >=3.10, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: hexbytes==1.3.1
+Requires-Dist: mypy_extensions<2,>=0.4.2
+Requires-Dist: typing-extensions<5,>=4.0.0
+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==2.4.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<26,>=25; 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<26,>=25; 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"
+Provides-Extra: benchmark
+Requires-Dist: pytest-benchmark; extra == "benchmark"
+Requires-Dist: pytest-codspeed<5.1,>=5; extra == "benchmark"
+Requires-Dist: eth-typing; extra == "benchmark"
+Provides-Extra: codspeed
+Requires-Dist: pytest-codspeed<5.1,>=5; extra == "codspeed"
+Requires-Dist: eth-typing; extra == "codspeed"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+### I forked hexbytes and compiled it to C. It does the same stuff, now faster
+
+[![PyPI](https://img.shields.io/pypi/v/faster-hexbytes.svg?logo=Python&logoColor=white)](https://pypi.org/project/faster-hexbytes/)
+[![Monthly Downloads](https://img.shields.io/pypi/dm/faster-hexbytes)](https://pypistats.org/packages/faster-hexbytes)
+[![Codspeed.io Status](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/BobTheBuidler/faster-hexbytes)
+
+##### This fork will be kept up-to-date with [hexbytes](https://github.com/ethereum/hexbytes). I will pull updates as they are released and push new [faster-hexbytes](https://github.com/BobTheBuidler/faster-hexbytes) releases to [PyPI](https://pypi.org/project/faster-hexbytes/).
+
+##### `faster_hexbytes.HexBytes` inherits from `hexbytes.HexBytes`, so porting to `faster-hexbytes` does not require you to update any `isinstance` or `issubclass` checks. All such checks in your codebase, and in any dependencies, will continue to work as they did when originaly implemented.
+
+##### We benchmark `faster-hexbytes` against the original `hexbytes` for your convenience. [See results](https://github.com/BobTheBuidler/faster-hexbytes/tree/master/benchmarks/results).
+
+##### You can find the compiled C code and header files in the [build](https://github.com/BobTheBuidler/hexbytes/tree/master/build) directory.
+
+###### You may also be interested in: [faster-web3.py](https://github.com/BobTheBuidler/faster-hexbytes/), [faster-eth-abi](https://github.com/BobTheBuidler/faster-eth-abi/), and [faster-eth-utils](https://github.com/BobTheBuidler/faster-eth-utils/)
+
+##### The original hexbytes readme is below:
+
+# 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.9.dist-info/RECORD

@@ -0,0 +1,13 @@
+faster_hexbytes__mypyc.cp315t-win32.pyd,sha256=ZZYdm91EYprikSCSNGpcsDDNf2Xp744gg2OHbTewYIw,65536
+faster_hexbytes/__init__.cp315t-win32.pyd,sha256=WBA7_6XxQ1lWYv262T4pifisL4rg3gkekvjykbEkhIw,9216
+faster_hexbytes/__init__.py,sha256=ydnGcx4ny2H1UjCnkxW0qn0u0G0Yo8pERQuZOKxbfP0,185
+faster_hexbytes/_utils.cp315t-win32.pyd,sha256=oLSu4lOYiBwbd5nmvQD18xh5sot9Hd4U2BB2vlVq16A,9216
+faster_hexbytes/_utils.py,sha256=oA4KjZm3tuQFLJa77bHxgeC4kBOmCxBAXoWEL-Iy_Xk,1920
+faster_hexbytes/main.cp315t-win32.pyd,sha256=SCJHc_y_QNqXyE4k_aLNOYjWgT9RdFtqC9aMlKPKmSM,9216
+faster_hexbytes/main.py,sha256=AIxRjEktbwuTBTW095kG8wedLpuEMCbeQhqsZ4i8JIM,3268
+faster_hexbytes/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+faster_hexbytes-1.3.9.dist-info/licenses/LICENSE,sha256=0yDgluyUXL4Wtez0QidbRbAJ8gPmBCH_PVss1vyL_Q4,1116
+faster_hexbytes-1.3.9.dist-info/METADATA,sha256=6hnVgAj8f8uXytS4kwhAPNJS57j_7sLzZ3pWhQzKCb8,6400
+faster_hexbytes-1.3.9.dist-info/WHEEL,sha256=HqmQhCfAfmCuuvIb9V-PliyMZZwXDVLHiA5aIbnMmQM,98
+faster_hexbytes-1.3.9.dist-info/top_level.txt,sha256=JLqPzpL8j6tDI0rkOzaXmast5SdH4RkTfvLXdTHaZCs,39
+faster_hexbytes-1.3.9.dist-info/RECORD,,

faster_hexbytes-1.3.9.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: false
+Tag: cp315-cp315t-win32
+

faster_hexbytes-1.3.9.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.9.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+faster_hexbytes
+faster_hexbytes__mypyc