faster-eth-utils 5.3.10__cp38-cp38-musllinux_1_2_x86_64.whl → 5.3.11__cp38-cp38-musllinux_1_2_x86_64.whl

faster_eth_utils/abi.py

@@ -7,6 +7,7 @@ import re
 from typing import (
     Any,
     Dict,
+    Final,
     Iterable,
     List,
     Literal,
@@ -40,6 +41,9 @@ from .crypto import (
 )
 
 
+ABIType = Literal["function", "constructor", "fallback", "receive", "event", "error"]
+
+
 def _align_abi_input(
     arg_abi: ABIComponent, normalized_arg: Any
 ) -> Union[Any, Tuple[Any, ...]]:
@@ -278,6 +282,16 @@ def filter_abi_by_name(abi_name: str, contract_abi: ABI) -> Sequence[ABIElement]
     ]
 
 
+__ABI_TYPE_LITERALS: Final  = {
+    Literal["function"]: "function",
+    Literal["constructor"]: "constructor",
+    Literal["fallback"]: "fallback",
+    Literal["receive"]: "receive",
+    Literal["event"]: "event",
+    Literal["error"]: "error",
+}
+
+
 @overload
 def filter_abi_by_type(
     abi_type: Literal["function"],
@@ -327,9 +341,7 @@ def filter_abi_by_type(
 
 
 def filter_abi_by_type(
-    abi_type: Literal[
-        "function", "constructor", "fallback", "receive", "event", "error"
-    ],
+    abi_type: ABIType,
     contract_abi: ABI,
 ) -> Union[
     List[ABIFunction], List[ABIConstructor], List[ABIFallback], List[ABIReceive], List[ABIEvent], List[ABIError]
@@ -361,20 +373,12 @@ ABIEvent, ABIError]]`
         [{'type': 'function', 'name': 'myFunction', 'inputs': [], 'outputs': []}, \
 {'type': 'function', 'name': 'myFunction2', 'inputs': [], 'outputs': []}]
     """
-    if abi_type == Literal["function"] or abi_type == "function":
-        return [abi for abi in contract_abi if abi["type"] == "function"]
-    elif abi_type == Literal["constructor"] or abi_type == "constructor":
-        return [abi for abi in contract_abi if abi["type"] == "constructor"]
-    elif abi_type == Literal["fallback"] or abi_type == "fallback":
-        return [abi for abi in contract_abi if abi["type"] == "fallback"]
-    elif abi_type == Literal["receive"] or abi_type == "receive":
-        return [abi for abi in contract_abi if abi["type"] == "receive"]
-    elif abi_type == Literal["event"] or abi_type == "event":
-        return [abi for abi in contract_abi if abi["type"] == "event"]
-    elif abi_type == Literal["error"] or abi_type == "error":
-        return [abi for abi in contract_abi if abi["type"] == "error"]
-    else:
+    if abi_type in ("function", "constructor", "fallback", "receive", "event", "error"):
+        return [abi for abi in contract_abi if abi["type"] == abi_type]  # type: ignore [return-value]
+    abi_type_string: Optional[ABIType] = __ABI_TYPE_LITERALS.get(abi_type)  # type: ignore [call-overload]
+    if abi_type_string is None:
         raise ValueError(f"Unsupported ABI type: {abi_type}")
+    return [abi for abi in contract_abi if abi["type"] == abi_type_string]  # type: ignore [return-value]    
 
 
 def get_all_function_abis(contract_abi: ABI) -> Sequence[ABIFunction]:

faster_eth_utils/applicators.py

@@ -50,9 +50,9 @@ def apply_formatter_at_index(
             f"Need: {at_index + 1}"
         ) from None
 
-    yield from value[:at_index]
+    yield from cast(Sequence[TOther], value[:at_index])
     yield formatter(cast(TArg, item))
-    yield from value[at_index + 1 :]
+    yield from cast(Sequence[TOther], value[at_index + 1 :])
 
 
 def combine_argument_formatters(*formatters: Callable[..., Any]) -> Formatters:
@@ -80,18 +80,20 @@ def combine_argument_formatters(*formatters: Callable[..., Any]) -> Formatters:
 def apply_formatters_to_sequence(
     formatters: List[Callable[[Any], TReturn]], sequence: Sequence[Any]
 ) -> Generator[TReturn, None, None]:
-    if len(formatters) == len(sequence):
+    num_formatters = len(formatters)
+    num_items = len(sequence)
+    if num_formatters == num_items:
         for formatter, item in zip(formatters, sequence):
             yield formatter(item)
-    elif len(formatters) > len(sequence):
+    elif num_formatters > num_items:
         raise IndexError(
-            f"Too many formatters for sequence: {len(formatters)} formatters for "
-            f"{repr(sequence)}"
+            f"Too many formatters for sequence: {num_formatters} formatters for "
+            f"{sequence!r}"
         )
     else:
         raise IndexError(
-            f"Too few formatters for sequence: {len(formatters)} formatters for "
-            f"{repr(sequence)}"
+            f"Too few formatters for sequence: {num_formatters} formatters for "
+            f"{sequence!r}"
         )
 
 
@@ -105,8 +107,8 @@ def apply_formatter_if(
     condition: Callable[[TArg], bool], formatter: Callable[[TArg], TReturn], value: TArg
 ) -> Union[TArg, TReturn]: ...
 
-def apply_formatter_if(
-    condition: Union[Callable[[TArg], TypeGuard[TOther]], Callable[[Any], TypeGuard[TOther]], Callable[[TArg], bool]],
+def apply_formatter_if(  # type: ignore [misc]
+    condition: Union[Callable[[TArg], TypeGuard[TOther]], Callable[[TArg], bool]],
     formatter: Union[Callable[[TOther], TReturn], Callable[[TArg], TReturn]],
     value: TArg,
 ) -> Union[TArg, TReturn]:
@@ -116,12 +118,11 @@ def apply_formatter_if(
         return value
 
 
-@to_dict
 def apply_formatters_to_dict(
     formatters: Dict[Any, Any],
     value: Union[Dict[Any, Any], CamelModel],
     unaliased: bool = False,
-) -> Generator[Tuple[Any, Any], None, None]:
+) -> Dict[Any, Any]:
     """
     Apply formatters to a dictionary of values. If the value is a pydantic model,
     it will be serialized to a dictionary first, taking into account the
@@ -136,22 +137,24 @@ def apply_formatters_to_dict(
     if isinstance(value, CamelModel):
         value = value.model_dump(by_alias=not unaliased)
 
-    for key, item in value.items():
-        if key in formatters:
-            try:
-                yield key, formatters[key](item)
-            except ValueError as exc:
-                new_error_message = (
-                    f"Could not format invalid value {repr(item)} as field {repr(key)}"
-                )
-                raise ValueError(new_error_message) from exc
-            except TypeError as exc:
-                new_error_message = (
-                    f"Could not format invalid type {repr(item)} as field {repr(key)}"
-                )
-                raise TypeError(new_error_message) from exc
-        else:
-            yield key, item
+    def get_value(key: Any, item: Any) -> Any:
+        if key not in formatters:
+            return item
+        try:
+            return formatters[key](item)
+        except ValueError as exc:
+            raise ValueError(
+                f"Could not format invalid value {repr(item)} as field {repr(key)}"
+            ) from exc
+        except TypeError as exc:
+            raise TypeError(
+                f"Could not format invalid type {repr(item)} as field {repr(key)}"
+            ) from exc
+
+    return {
+        key: get_value(key, item) if key in formatters else key
+        for key, item in value.items()
+    }
 
 
 @return_arg_type(1)
@@ -175,10 +178,9 @@ def apply_one_of_formatters(
         )
 
 
-@to_dict
 def apply_key_map(
     key_mappings: Dict[Any, Any], value: Dict[Any, Any]
-) -> Generator[Tuple[Any, Any], None, None]:
+) -> Dict[Any, Any]:
     key_conflicts = (
         set(value.keys())
         .difference(key_mappings.keys())
@@ -189,8 +191,7 @@ def apply_key_map(
             f"Could not apply key map due to conflicting key(s): {key_conflicts}"
         )
 
-    for key, item in value.items():
-        if key in key_mappings:
-            yield key_mappings[key], item
-        else:
-            yield key, item
+    def get_key(key: Any) -> Any:
+        return key_mappings[key] if key in key_mappings else key
+
+    return {get_key(key): item for key, item in value.items()}

faster_eth_utils/exceptions.py

@@ -1,4 +1,11 @@
-class ValidationError(Exception):
+"""
+faster-eth-utils exceptions always inherit from eth-utils exceptions, so porting to faster-eth-utils
+does not require any change to your existing exception handlers. They will continue to work.
+"""
+
+import eth_utils.exceptions
+
+class ValidationError(eth_utils.exceptions.ValidationError):
     """
     Raised when something does not pass a validation check.
     """

{faster_eth_utils-5.3.10.dist-info → faster_eth_utils-5.3.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: faster-eth-utils
-Version: 5.3.10
+Version: 5.3.11
 Summary: A fork of eth-utils: Common utility functions for python code that interacts with Ethereum, implemented in C
 Home-page: https://github.com/BobTheBuidler/eth-utils
 Author: The Ethereum Foundation
@@ -24,6 +24,7 @@ License-File: LICENSE
 Requires-Dist: cchecksum>=0.0.3
 Requires-Dist: eth-hash>=0.3.1
 Requires-Dist: eth-typing>=5.0.0
+Requires-Dist: eth-utils<6,>=5.2.0
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: cytoolz>=0.10.1; implementation_name == "cpython"
 Requires-Dist: toolz>0.8.2; implementation_name == "pypy"
@@ -40,7 +41,7 @@ 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: towncrier<26,>=24; extra == "dev"
 Requires-Dist: hypothesis>=4.43.0; extra == "dev"
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-codspeed>=2.0.0; extra == "dev"
@@ -49,7 +50,7 @@ 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"
+Requires-Dist: towncrier<26,>=24; extra == "docs"
 Provides-Extra: test
 Requires-Dist: hypothesis>=4.43.0; extra == "test"
 Requires-Dist: mypy==1.14.1; extra == "test"
@@ -65,10 +66,14 @@ Requires-Dist: pytest-xdist>=2.4.0; extra == "test"
 
 ##### This fork will be kept up-to-date with [eth-utils](https://github.com/ethereum/eth-utils). I will pull updates as they are released and push new [faster-eth-utils](https://github.com/BobTheBuidler/faster-eth-utils) releases to [PyPI](https://pypi.org/project/faster-eth-utils/).
 
-##### You can find the compiled C code on faster-eth-utils [master](https://github.com/BobTheBuidler/eth-utils/tree/master) branch.
+##### Starting in [v5.3.11](https://github.com/BobTheBuidler/faster-eth-utils/releases/tag/v5.3.11), all `faster-eth-utils` Exception classes inherit from the matching Exception class in `eth-utils`, so porting to `faster-eth-utils` does not require any change to your existing exception handlers. All existing exception handling in your codebase will continue to work as it did when originaly implemented.
 
 ##### We benchmark `faster-eth-utils` against the original `eth-utils` for your convenience. [See results](https://github.com/BobTheBuidler/faster-eth-utils/tree/master/benchmarks/results).
 
+##### You can find the compiled C code on faster-eth-utils [master](https://github.com/BobTheBuidler/eth-utils/tree/master) branch.
+
+###### You may also be interested in: [faster-web3.py](https://github.com/BobTheBuidler/faster-web3.py/), [faster-eth-abi](https://github.com/BobTheBuidler/faster-eth-abi/), and [faster-hexbytes](https://github.com/BobTheBuidler/faster-hexbytes/)
+
 ##### The original eth-utils readme is below:
 
 # Ethereum Utilities

{faster_eth_utils-5.3.10.dist-info → faster_eth_utils-5.3.11.dist-info}/RECORD

@@ -1,12 +1,12 @@
-99c07adba6ff961eaf3e__mypyc.cpython-38-x86_64-linux-gnu.so,sha256=bmUb4VXfobh2ud915mO89Q01aJ4jXtObPnQtdKD3ZSA,1393344
+99c07adba6ff961eaf3e__mypyc.cpython-38-x86_64-linux-gnu.so,sha256=lMkFXhh7vPD6DWS4W945h0OYaTDRgW4CH0Fcyszy7HU,1375144
 faster_eth_utils/__init__.py,sha256=hW-A_fjyQ76crTKwuxxSbvNzvPfW27dSlzhtOkseymg,2762
 faster_eth_utils/__main__.py,sha256=mH37e49q7_A0-q1ymqkq1QyYABbQHVmXeuSKIBSahO8,86
 faster_eth_utils/abi.cpython-38-x86_64-linux-gnu.so,sha256=E4KZxRse-11Jwzsip35CD5dYBuQ2QBXN3qrOQiTSolk,17416
-faster_eth_utils/abi.py,sha256=2Lk78YiWLIG_srH2nTYny8tYrxM7JS-zWNpBe8ACMEs,26544
+faster_eth_utils/abi.py,sha256=3pAqpKXMOcOLCD4uUUVfxBcM9H1K311dpd1Zj0Qi21g,26404
 faster_eth_utils/address.cpython-38-x86_64-linux-gnu.so,sha256=iqAxHwMXFnib36FVEf1gcKeOs4HG1IcHMiZZ8DNaZSA,17432
 faster_eth_utils/address.py,sha256=IIHlYuIz-F6-mAnRWdsD4uH5l56yVRFMokFQINao9lE,3680
 faster_eth_utils/applicators.cpython-38-x86_64-linux-gnu.so,sha256=Vj0RmWtWkCRgrxwfkGoPCrRVXkKMZPLpi-K653d_fX4,17448
-faster_eth_utils/applicators.py,sha256=dcmcvx2PvK7I6xilt02mlr8OmEOTOeajh3uAbZoOONg,5842
+faster_eth_utils/applicators.py,sha256=LEffyul-ZdsAhNB7H7E6e-J4fXw7bUt0NxrkjZWMHkA,5833
 faster_eth_utils/conversions.cpython-38-x86_64-linux-gnu.so,sha256=F3aHZFbWNzdcRlrhW89qR6301xIr0TxuYANcfqytuQc,17448
 faster_eth_utils/conversions.py,sha256=t2TEe0WsffqOFDbyQcERTSbHJYpDBWHKd8XPArhLoEE,5665
 faster_eth_utils/crypto.cpython-38-x86_64-linux-gnu.so,sha256=aH1uwiLRs1vIr4GlbUVDqU7e4P8ftxc6aELnwXvregY,17424
@@ -20,7 +20,7 @@ faster_eth_utils/decorators.py,sha256=BdAz-imQIf0TlBm7Di7T05o3IC6ei-xJc7FgIOqqAy
 faster_eth_utils/encoding.cpython-38-x86_64-linux-gnu.so,sha256=iDjtteDybS1bDIZeY5WOJilGgoOxHGkp_dk3X3vgfYs,17440
 faster_eth_utils/encoding.py,sha256=1qfDeuinLZ01XjYgknpm_p9LuWwaYvicYkYI8mS1iMc,199
 faster_eth_utils/exceptions.cpython-38-x86_64-linux-gnu.so,sha256=lzx1SMU2_oa7VsR9O5oos2MM0nalTi_bwJtUA2ZQBm0,17440
-faster_eth_utils/exceptions.py,sha256=3ndM6zl4QoSc6GupV9T1Klz9TByM8w2zr4ez8UJvzew,110
+faster_eth_utils/exceptions.py,sha256=7Cjxewj4g95RxNvjNqaB2w3HGk6068V82ppCHS_S-Y0,369
 faster_eth_utils/functional.cpython-38-x86_64-linux-gnu.so,sha256=LSf71b8DVzpqG19wjLxYwpiRA_Jg3biVYYuTsf7VUao,17440
 faster_eth_utils/functional.py,sha256=nJTxE4_HDci0chos5mQdy05pJ8o7n0wx_o7_WCro2gI,2449
 faster_eth_utils/hexadecimal.cpython-38-x86_64-linux-gnu.so,sha256=gEEls8vy7pDvzDvbbW5dNXk70XuH3urjMRJjCWAU2ss,17448
@@ -46,8 +46,8 @@ faster_eth_utils/__json/eth_networks.json,sha256=0S8HoWD6RTR6Hc0uQdQl2VHtopytIYl
 faster_eth_utils/curried/__init__.py,sha256=x_nPjvTwmXeEl5jV86RRUvudu6ks1kMUxZfbjNuGx8Y,7407
 faster_eth_utils/typing/__init__.py,sha256=84PxIxCvEHtBb-Ik6qnGvXH4alaWbamr_zDbtlbJh3A,325
 faster_eth_utils/typing/misc.py,sha256=4N5raYXFAeRGpmch6qgHrtYNCDxCJM5XtAAsJ1FSzzU,190
-faster_eth_utils-5.3.10.dist-info/LICENSE,sha256=STqznQ6A8OeJylPrTA7dlsMtH0isQQybRlnDZOKGVrM,1095
-faster_eth_utils-5.3.10.dist-info/METADATA,sha256=c1GOzh-ndbPQ5AjXVxQzdTU23_0rseQx5y7vsn6Zbw4,6775
-faster_eth_utils-5.3.10.dist-info/WHEEL,sha256=AtKzrIIwO6LyEQPNa-CKogjoLSeXFnST8-hqmpwwZQA,110
-faster_eth_utils-5.3.10.dist-info/top_level.txt,sha256=8eOy3WlvVLCcmwPnl2UMylYQNmrXz76p9L_TH-NYSSM,55
-faster_eth_utils-5.3.10.dist-info/RECORD,,
+faster_eth_utils-5.3.11.dist-info/LICENSE,sha256=STqznQ6A8OeJylPrTA7dlsMtH0isQQybRlnDZOKGVrM,1095
+faster_eth_utils-5.3.11.dist-info/METADATA,sha256=SP0G6owcAkOXrTZ1fiil-xt0P4wBG9uh42rObUwzZ10,7466
+faster_eth_utils-5.3.11.dist-info/WHEEL,sha256=AtKzrIIwO6LyEQPNa-CKogjoLSeXFnST8-hqmpwwZQA,110
+faster_eth_utils-5.3.11.dist-info/top_level.txt,sha256=8eOy3WlvVLCcmwPnl2UMylYQNmrXz76p9L_TH-NYSSM,55
+faster_eth_utils-5.3.11.dist-info/RECORD,,