Skip to content

utils

Utility module for things that make the arc apis cleaner

dispatch_args(func, *args)

Calls the given func with the maximum slice of *args that it can accept. Handles function and method types

For example: 

def foo(bar, baz): # only accepts 2 args
    arc.print(bar, baz)

# Will call the provided function with the first
# two arguments
dispatch_args(foo, 1, 2, 3, 4)
# 1 2

Source code in /home/runner/work/arc/arc/arc/utils.py 
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
def dispatch_args(func: t.Callable[..., T], *args: t.Any) -> T:
    """Calls the given `func` with the maximum
    slice of `*args` that it can accept. Handles
    function and method types

    For example:
    ```py
    def foo(bar, baz): # only accepts 2 args
        arc.print(bar, baz)

    # Will call the provided function with the first
    # two arguments
    dispatch_args(foo, 1, 2, 3, 4)
    # 1 2
    ```
    """
    # TODO: I haven't tested if this will capture
    # all callables, but it should hopefully.
    if isinstance(func, MethodType):
        arg_count = func.__func__.__code__.co_argcount - 1
    elif inspect.isfunction(func):
        arg_count = func.__code__.co_argcount
    else:
        arg_count = func.__call__.__func__.__code__.co_argcount - 1  # type: ignore

    args = args[0:arg_count]
    return func(*args)

display(*members)

Construct a repr that displays the values of the provided members

Source code in /home/runner/work/arc/arc/arc/utils.py 
12
13
14
15
16
17
18
19
20
21
def display(*members: str) -> t.Callable[[object], str]:
    """Construct a repr that displays the values of the provided members"""

    def __repr__(self: object) -> str:
        values = Join.with_comma(
            f"{member}={repr(getattr(self, member))}" for member in members
        )
        return f"{type(self).__name__}({values})"

    return __repr__