faster-eth-utils 2.3.1__cp311-cp311-win32.whl → 5.3.23__cp311-cp311-win32.whl

faster_eth_utils/currency.py

@@ -1,9 +1,20 @@
 import decimal
-from decimal import localcontext
-from typing import Final, Union, final
-
-from .types import is_integer, is_string
-from .units import units
+from decimal import (
+    localcontext,
+)
+from typing import (
+    Final,
+    Union,
+    final,
+)
+
+from .types import (
+    is_integer,
+    is_string,
+)
+from .units import (
+    units,
+)
 
 
 @final
@@ -35,24 +46,17 @@ class denoms:
 
 MIN_WEI: Final = 0
 MAX_WEI: Final = 2**256 - 1
+DECIMAL_ZERO: Final = decimal.Decimal(0)
 
+_NumberType = Union[int, float, str, decimal.Decimal]
 
-def from_wei(number: int, unit: str) -> Union[int, decimal.Decimal]:
-    """
-    Takes a number of wei and converts it to any other ether unit.
-    """
-    if unit.lower() not in units:
-        raise ValueError(
-            "Unknown unit.  Must be one of {0}".format("/".join(units.keys()))
-        )
 
+def _from_wei(number: int, unit_value: decimal.Decimal) -> int | decimal.Decimal:
     if number == 0:
         return 0
 
     if number < MIN_WEI or number > MAX_WEI:
-        raise ValueError("value must be between 1 and 2**256 - 1")
-
-    unit_value = units[unit.lower()]
+        raise ValueError("value must be between 0 and 2**256 - 1")
 
     with localcontext() as ctx:
         ctx.prec = 999
@@ -62,35 +66,26 @@ def from_wei(number: int, unit: str) -> Union[int, decimal.Decimal]:
     return result_value
 
 
-def to_wei(number: Union[int, float, str, decimal.Decimal], unit: str) -> int:
-    """
-    Takes a number of a unit and converts it to wei.
-    """
-    if unit.lower() not in units:
-        raise ValueError(
-            "Unknown unit.  Must be one of {0}".format("/".join(units.keys()))
-        )
-
+def _to_wei(number: _NumberType, unit_value: decimal.Decimal) -> int:
     if is_integer(number) or is_string(number):
-        d_number = decimal.Decimal(value=number)
+        d_number = decimal.Decimal(value=number)  # type: ignore [arg-type]
     elif isinstance(number, float):
         d_number = decimal.Decimal(value=str(number))
     elif isinstance(number, decimal.Decimal):
         d_number = number
     else:
-        raise TypeError("Unsupported type.  Must be one of integer, float, or string")
+        raise TypeError("Unsupported type. Must be one of integer, float, or string")
 
-    s_number = str(number)
-    unit_value = units[unit.lower()]
-
-    if d_number == decimal.Decimal(0):
+    if d_number == DECIMAL_ZERO:
         return 0
 
+    s_number = str(number)
+
     if d_number < 1 and "." in s_number:
         with localcontext() as ctx:
             multiplier = len(s_number) - s_number.index(".") - 1
             ctx.prec = multiplier
-            d_number = decimal.Decimal(value=number, context=ctx) * 10**multiplier
+            d_number = decimal.Decimal(value=number, context=ctx) * 10**multiplier  # type: ignore [arg-type]
         unit_value /= 10**multiplier
 
     with localcontext() as ctx:
@@ -98,6 +93,52 @@ def to_wei(number: Union[int, float, str, decimal.Decimal], unit: str) -> int:
         result_value = decimal.Decimal(value=d_number, context=ctx) * unit_value
 
     if result_value < MIN_WEI or result_value > MAX_WEI:
-        raise ValueError("Resulting wei value must be between 1 and 2**256 - 1")
+        raise ValueError("Resulting wei value must be between 0 and 2**256 - 1")
 
     return int(result_value)
+
+
+def from_wei(number: int, unit: str) -> int | decimal.Decimal:
+    """
+    Takes a number of wei and converts it to any other ether unit.
+    """
+    unit_key = unit.lower()
+    if unit_key not in units:
+        raise ValueError(f"Unknown unit. Must be one of {'/'.join(units.keys())}")
+
+    unit_value = units[unit_key]
+
+    return _from_wei(number, unit_value)
+
+
+def to_wei(number: _NumberType, unit: str) -> int:
+    """
+    Takes a number of a unit and converts it to wei.
+    """
+    unit_key = unit.lower()
+    if unit_key not in units:
+        raise ValueError(f"Unknown unit. Must be one of {'/'.join(units.keys())}")
+
+    unit_value = units[unit_key]
+
+    return _to_wei(number, unit_value)
+
+
+def from_wei_decimals(number: int, decimals: int) -> int | decimal.Decimal:
+    """
+    Takes a number of wei and converts it to a decimal with the specified
+    number of decimals.
+    """
+    unit_value = decimal.Decimal(10) ** decimal.Decimal(value=decimals)
+
+    return _from_wei(number, unit_value)
+
+
+def to_wei_decimals(number: _NumberType, decimals: int) -> int:
+    """
+    Takes a number of a unit and converts it to wei with the specified
+    number of decimals.
+    """
+    unit_value = decimal.Decimal(10) ** decimal.Decimal(value=decimals)
+
+    return _to_wei(number, unit_value)

faster_eth_utils/curried/__init__.py

@@ -1,18 +1,17 @@
-# flake8: noqa
+import sys
+from collections.abc import Callable, Generator, Sequence
 from typing import (
+    TYPE_CHECKING,
     Any,
-    Callable,
-    Dict,
-    Generator,
     Optional,
-    Sequence,
-    Tuple,
+    TypeGuard,
     TypeVar,
     Union,
     overload,
 )
 
 from faster_eth_utils import (
+    CamelModel,
     ExtendedDebugLogger,
     HasExtendedDebugLogger,
     HasExtendedDebugLoggerMeta,
@@ -20,13 +19,19 @@ from faster_eth_utils import (
     HasLoggerMeta,
     Network,
     ValidationError,
+    abi_to_signature,
     add_0x_prefix,
     apply_formatter_at_index,
-)
-from faster_eth_utils import (
+    apply_formatter_if as non_curried_apply_formatter_if,
+    apply_formatter_to_array,
+    apply_formatters_to_dict as non_curried_apply_formatters_to_dict,
+    apply_formatters_to_sequence,
+    apply_key_map,
+    apply_one_of_formatters as non_curried_apply_one_of_formatters,
     apply_to_return_value,
     big_endian_to_int,
     clamp,
+    collapse_if_tuple,
     combine_argument_formatters,
     combomethod,
     decode_hex,
@@ -34,16 +39,27 @@ from faster_eth_utils import (
     encode_hex,
     event_abi_to_log_topic,
     event_signature_to_log_topic,
+    filter_abi_by_name,
+    filter_abi_by_type,
     flatten_return,
     from_wei,
+    from_wei_decimals,
     function_abi_to_4byte_selector,
     function_signature_to_4byte_selector,
+    get_abi_input_names,
+    get_abi_input_types,
+    get_abi_output_names,
+    get_abi_output_types,
+    get_aligned_abi_inputs,
+    get_all_event_abis,
+    get_all_function_abis,
     get_extended_debug_logger,
     get_logger,
-)
-from faster_eth_utils import (
+    get_normalized_abi_inputs,
+    hexstr_if_str as non_curried_hexstr_if_str,
     humanize_bytes,
     humanize_hash,
+    humanize_hexstr,
     humanize_integer_sequence,
     humanize_ipfs_uri,
     humanize_seconds,
@@ -81,8 +97,7 @@ from faster_eth_utils import (
     setup_DEBUG2_logging,
     short_name_from_chain_id,
     sort_return,
-)
-from faster_eth_utils import (
+    text_if_str as non_curried_text_if_str,
     to_bytes,
     to_canonical_address,
     to_checksum_address,
@@ -96,175 +111,181 @@ from faster_eth_utils import (
     to_text,
     to_tuple,
     to_wei,
+    to_wei_decimals,
 )
-from faster_eth_utils import apply_formatter_if as non_curried_apply_formatter_if
-from faster_eth_utils import apply_formatter_to_array
-from faster_eth_utils import apply_formatters_to_dict as non_curried_apply_formatters_to_dict
-from faster_eth_utils import apply_formatters_to_sequence, apply_key_map
-from faster_eth_utils import apply_one_of_formatters as non_curried_apply_one_of_formatters
-from faster_eth_utils import hexstr_if_str as non_curried_hexstr_if_str
-from faster_eth_utils import text_if_str as non_curried_text_if_str
-from faster_eth_utils.toolz import curry
+from faster_eth_utils.toolz import (
+    curry,
+)
+
+if TYPE_CHECKING:
+    from _typeshed import SupportsBool
+    # We have to sacrifice a little bit of specificity on dinosaur Python3.8
 
+
+TArg = TypeVar("TArg")
+TOther = TypeVar("TOther")
 TReturn = TypeVar("TReturn")
 TValue = TypeVar("TValue")
 
 
 @overload
 def apply_formatter_if(
-    condition: Callable[..., bool]
-) -> Callable[[Callable[..., TReturn]], Callable[[TValue], Union[TReturn, TValue]]]:
+    condition: Callable[[TArg], TypeGuard[TOther]],
+) -> Callable[[Callable[[TOther], TReturn]], Callable[[TArg], TReturn | TArg]]:
     ...
 
-
 @overload
 def apply_formatter_if(
-    condition: Callable[..., bool], formatter: Callable[..., TReturn]
-) -> Callable[[TValue], Union[TReturn, TValue]]:
+    condition: Callable[[TArg], TypeGuard[TOther]], formatter: Callable[[TOther], TReturn]
+) -> Callable[[TArg], TReturn | TArg]:
     ...
 
-
 @overload
 def apply_formatter_if(
-    condition: Callable[..., bool], formatter: Callable[..., TReturn], value: TValue
-) -> Union[TReturn, TValue]:
+    condition: Callable[[TArg], TypeGuard[TOther]], formatter: Callable[[TOther], TReturn], value: TArg
+) -> TReturn | TArg:
     ...
 
-
-# This is just a stub to appease mypy, it gets overwritten later
+@overload
 def apply_formatter_if(
-    condition: Callable[..., bool],
-    formatter: Callable[..., TReturn] = None,
-    value: TValue = None,
-) -> Union[
-    Callable[[Callable[..., TReturn]], Callable[[TValue], Union[TReturn, TValue]]],
-    Callable[[TValue], Union[TReturn, TValue]],
-    TReturn,
-    TValue,
-]:
+    condition: Callable[[TArg], bool], formatter: Callable[[TArg], TReturn], value: TArg
+) -> TReturn | TArg:
     ...
 
+def apply_formatter_if(  # type: ignore
+    condition: Callable[[TArg], TypeGuard[TOther]] | Callable[[TArg], bool],
+    formatter: Callable[[TOther], TReturn] | Callable[[TArg], TReturn] | None = None,
+    value: TArg | None = None,
+) -> (
+    Callable[[Callable[[TOther], TReturn]], Callable[[TArg], TReturn | TArg]] |
+    Callable[[TArg], TReturn | TArg] |
+    TReturn |
+    TArg
+):
+    pass
+
 
 @overload
 def apply_one_of_formatters(
     formatter_condition_pairs: Sequence[
-        Tuple[Callable[..., bool], Callable[..., TReturn]]
-    ]
-) -> Callable[[TValue], TReturn]:
-    ...
+        tuple[Callable[[TArg], "SupportsBool"], Callable[[TArg], TReturn]]
+    ],
+) -> Callable[[TArg], TReturn]: ...
 
 
 @overload
 def apply_one_of_formatters(
     formatter_condition_pairs: Sequence[
-        Tuple[Callable[..., bool], Callable[..., TReturn]]
+        tuple[Callable[[TArg], "SupportsBool"], Callable[[TArg], TReturn]]
     ],
-    value: TValue,
-) -> TReturn:
-    ...
+    value: TArg,
+) -> TReturn: ...
 
 
 # This is just a stub to appease mypy, it gets overwritten later
-def apply_one_of_formatters(
+def apply_one_of_formatters(  # type: ignore[empty-body]
     formatter_condition_pairs: Sequence[
-        Tuple[Callable[..., bool], Callable[..., TReturn]]
+        tuple[Callable[[TArg], "SupportsBool"], Callable[[TArg], TReturn]]
     ],
-    value: TValue = None,
-) -> TReturn:
-    ...
+    value: TArg | None = None,
+) -> Callable[[TArg], TReturn] | TReturn: ...
 
 
 @overload
 def hexstr_if_str(
-    to_type: Callable[..., TReturn]
-) -> Callable[[Union[bytes, int, str]], TReturn]:
-    ...
+    to_type: Callable[..., TReturn],
+) -> Callable[[bytes | int | str], TReturn]: ...
 
 
 @overload
 def hexstr_if_str(
-    to_type: Callable[..., TReturn], to_format: Union[bytes, int, str]
-) -> TReturn:
-    ...
+    to_type: Callable[..., TReturn], to_format: bytes | int | str
+) -> TReturn: ...
 
 
 # This is just a stub to appease mypy, it gets overwritten later
-def hexstr_if_str(
-    to_type: Callable[..., TReturn], to_format: Union[bytes, int, str] = None
-) -> TReturn:
-    ...
+def hexstr_if_str(  # type: ignore
+    to_type: Callable[..., TReturn], to_format: bytes | int | str | None = None
+) -> TReturn: ...
 
 
 @overload
 def text_if_str(
-    to_type: Callable[..., TReturn]
-) -> Callable[[Union[bytes, int, str]], TReturn]:
-    ...
+    to_type: Callable[..., TReturn],
+) -> Callable[[bytes | int | str], TReturn]: ...
 
 
 @overload
 def text_if_str(
-    to_type: Callable[..., TReturn], text_or_primitive: Union[bytes, int, str]
-) -> TReturn:
-    ...
+    to_type: Callable[..., TReturn], text_or_primitive: bytes | int | str
+) -> TReturn: ...
 
 
 # This is just a stub to appease mypy, it gets overwritten later
-def text_if_str(
-    to_type: Callable[..., TReturn], text_or_primitive: Union[bytes, int, str] = None
-) -> TReturn:
-    ...
+def text_if_str(  # type: ignore
+    to_type: Callable[..., TReturn],
+    text_or_primitive: bytes | int | str | None = None,
+) -> TReturn: ...
 
 
 @overload
 def apply_formatters_to_dict(
-    formatters: Dict[Any, Any]
-) -> Callable[[Dict[Any, Any]], TReturn]:
+    formatters: dict[Any, Any], unaliased: bool = False
+) -> Callable[[dict[Any, Any] | CamelModel], dict[Any, Any]]:
     ...
 
 
 @overload
 def apply_formatters_to_dict(
-    formatters: Dict[Any, Any], value: Dict[Any, Any]
-) -> TReturn:
+    formatters: dict[Any, Any], value: dict[Any, Any] | CamelModel, unaliased: bool = False
+) -> dict[Any, Any]:
     ...
 
 
 # This is just a stub to appease mypy, it gets overwritten later
 def apply_formatters_to_dict(
-    formatters: Dict[Any, Any], value: Optional[Dict[Any, Any]] = None
-) -> TReturn:
-    ...
+    formatters: dict[Any, Any],
+    value: dict[Any, Any] | CamelModel | None = None,
+    unaliased: bool = False,
+) -> dict[Any, Any]: ...
 
 
 apply_formatter_at_index = curry(apply_formatter_at_index)
-apply_formatter_if = curry(non_curried_apply_formatter_if)
+apply_formatter_if = curry(non_curried_apply_formatter_if)  # noqa: F811
 apply_formatter_to_array = curry(apply_formatter_to_array)
-apply_formatters_to_dict = curry(non_curried_apply_formatters_to_dict)
+apply_formatters_to_dict = curry(non_curried_apply_formatters_to_dict)  # noqa: F811
 apply_formatters_to_sequence = curry(apply_formatters_to_sequence)
 apply_key_map = curry(apply_key_map)
-apply_one_of_formatters = curry(non_curried_apply_one_of_formatters)
+apply_one_of_formatters = curry(non_curried_apply_one_of_formatters)  # noqa: F811
+filter_abi_by_name = curry(filter_abi_by_name)
+filter_abi_by_type = curry(filter_abi_by_type)
+flatten_return = curry(flatten_return)
 from_wei = curry(from_wei)
+from_wei_decimals = curry(from_wei_decimals)
+get_aligned_abi_inputs = curry(get_aligned_abi_inputs)
 get_logger = curry(get_logger)
-hexstr_if_str = curry(non_curried_hexstr_if_str)
+get_normalized_abi_inputs = curry(get_normalized_abi_inputs)
+hexstr_if_str = curry(non_curried_hexstr_if_str)  # noqa: F811
 is_same_address = curry(is_same_address)
-text_if_str = curry(non_curried_text_if_str)
+sort_return = curry(sort_return)
+text_if_str = curry(non_curried_text_if_str)  # noqa: F811
+to_ordered_dict = curry(to_ordered_dict)
 to_wei = curry(to_wei)
+to_wei_decimals = curry(to_wei_decimals)
 clamp = curry(clamp)
 
 # Delete any methods and classes that are not intended to be importable from
-#   eth_utils.curried
-# We do this approach instead of __all__ because this approach actually prevents
-#   importing the wrong thing, while __all__ only affects `from eth_utils.curried import *`
+# `eth_utils.curried`. We do this approach instead of __all__ because this approach
+# actually prevents importing the wrong thing, while __all__ only affects
+# `from eth_utils.curried import *`
 del Any
 del Callable
-del Dict
 del Generator
 del Optional
 del Sequence
 del TReturn
 del TValue
-del Tuple
+del TypeGuard
 del TypeVar
 del Union
 del curry

faster_eth_utils/debug.py

@@ -5,15 +5,15 @@ import sys
 
 def pip_freeze() -> str:
     result = subprocess.run("python -m pip freeze".split(), stdout=subprocess.PIPE)
-    return "python -m pip freeze result:\n%s" % result.stdout.decode()
+    return f"python -m pip freeze result:\n{result.stdout.decode()}"
 
 
 def python_version() -> str:
-    return "Python version:\n%s" % sys.version
+    return f"Python version:\n{sys.version}"
 
 
 def platform_info() -> str:
-    return "Operating System: %s" % platform.platform()
+    return f"Operating System: {platform.platform()}"
 
 
 def get_environment_summary() -> str:

faster_eth_utils/decorators.py

@@ -1,56 +1,103 @@
 import functools
-import itertools
-from typing import Any, Callable, Dict, Type, TypeVar, final
+from collections.abc import Callable
+from typing import (
+    Any,
+    Concatenate,
+    Final,
+    Generic,
+    TypeVar,
+    final,
+)
 
-from .types import is_text
+from typing_extensions import ParamSpec
+
+P = ParamSpec("P")
 
 T = TypeVar("T")
 
+TInstance = TypeVar("TInstance", bound=object)
+"""A TypeVar representing an instance that a method can bind to."""
+
 
 @final
-class combomethod(object):
-    def __init__(self, method: Callable[..., Any]) -> None:
-        self.method = method
-
-    def __get__(self, obj: T = None, objtype: Type[T] = None) -> Callable[..., Any]:
-        @functools.wraps(self.method)
-        def _wrapper(*args: Any, **kwargs: Any) -> Any:
-            if obj is not None:
-                return self.method(obj, *args, **kwargs)
-            else:
-                return self.method(objtype, *args, **kwargs)
+class combomethod(Generic[TInstance, P, T]):
+    def __init__(
+        self, method: Callable[Concatenate[TInstance | type[TInstance], P], T]
+    ) -> None:
+        self.method: Final = method
+
+    def __repr__(self) -> str:
+        return f"combomethod({self.method})"
+
+    def __get__(
+        self,
+        obj: TInstance | None,
+        objtype: type[TInstance],
+    ) -> Callable[P, T]:
+
+        method = self.method
+        bound_arg = objtype if obj is None else obj
+        
+        @functools.wraps(method)
+        def _wrapper(*args: P.args, **kwargs: P.kwargs) -> T:
+            return method(bound_arg, *args, **kwargs)
 
         return _wrapper
 
 
-def return_arg_type(at_position: int) -> Callable[..., Callable[..., T]]:
+_return_arg_type_deco_cache: Final[
+    dict[int, Callable[[Callable[P, T]], Callable[P, Any]]]
+] = {}
+# No need to hold so many unique instances in memory
+
+
+def return_arg_type(at_position: int) -> Callable[[Callable[P, T]], Callable[P, Any]]:
     """
     Wrap the return value with the result of `type(args[at_position])`.
     """
+    if deco := _return_arg_type_deco_cache.get(at_position):
+        return deco
 
-    def decorator(to_wrap: Callable[..., Any]) -> Callable[..., T]:
+    def decorator(to_wrap: Callable[P, Any]) -> Callable[P, Any]:
         @functools.wraps(to_wrap)
-        def wrapper(*args: Any, **kwargs: Any) -> T:
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> Any:
             result = to_wrap(*args, **kwargs)
             ReturnType = type(args[at_position])
-            return ReturnType(result)  # type: ignore
+            return ReturnType(result)  # type: ignore [call-arg]
 
         return wrapper
 
+    _return_arg_type_deco_cache[at_position] = decorator
+
     return decorator
 
 
+ExcType = type[BaseException]
+
+ReplaceExceptionsCache = dict[
+    tuple[tuple[ExcType, ExcType], ...],
+    Callable[[Callable[P, T]], Callable[P, T]],
+]
+
+_replace_exceptions_deco_cache: Final[ReplaceExceptionsCache[..., Any]] = {}
+# No need to hold so many unique instances in memory
+
+
 def replace_exceptions(
-    old_to_new_exceptions: Dict[Type[BaseException], Type[BaseException]]
-) -> Callable[[Callable[..., T]], Callable[..., T]]:
+    old_to_new_exceptions: dict[ExcType, ExcType],
+) -> Callable[[Callable[P, T]], Callable[P, T]]:
     """
     Replaces old exceptions with new exceptions to be raised in their place.
     """
-    old_exceptions = tuple(old_to_new_exceptions.keys())
+    cache_key = tuple(old_to_new_exceptions.items())
+    if deco := _replace_exceptions_deco_cache.get(cache_key):
+        return deco
 
-    def decorator(to_wrap: Callable[..., T]) -> Callable[..., T]:
+    old_exceptions = tuple(old_to_new_exceptions)
+
+    def decorator(to_wrap: Callable[P, T]) -> Callable[P, T]:
         @functools.wraps(to_wrap)
-        def wrapped(*args: Any, **kwargs: Any) -> T:
+        def wrapped(*args: P.args, **kwargs: P.kwargs) -> T:
             try:
                 return to_wrap(*args, **kwargs)
             except old_exceptions as err:
@@ -58,9 +105,11 @@ def replace_exceptions(
                     raise old_to_new_exceptions[type(err)](err) from err
                 except KeyError:
                     raise TypeError(
-                        "could not look up new exception to use for %r" % err
+                        f"could not look up new exception to use for {repr(err)}"
                     ) from err
 
         return wrapped
 
+    _replace_exceptions_deco_cache[cache_key] = decorator
+
     return decorator

faster_eth_utils/encoding.py

@@ -2,5 +2,5 @@ def int_to_big_endian(value: int) -> bytes:
     return value.to_bytes((value.bit_length() + 7) // 8 or 1, "big")
 
 
-def big_endian_to_int(value: bytes) -> int:
+def big_endian_to_int(value: bytes | bytearray) -> int:
     return int.from_bytes(value, "big")