summaryrefslogtreecommitdiff
path: root/function_utils.py
blob: f10776211df3ef8347d48486671577bc18d044bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#!/usr/bin/env python3

"""Helper methods dealing with functions."""

from typing import Callable


def function_identifier(f: Callable) -> str:
    """
    Given a callable function, return a string that identifies it.
    Usually that string is just __module__:__name__ but there's a
    corner case: when __module__ is __main__ (i.e. the callable is
    defined in the same module as __main__).  In this case,
    f.__module__ returns "__main__" instead of the file that it is
    defined in.  Work around this using pathlib.Path (see below).

    >>> function_identifier(function_identifier)
    'function_utils:function_identifier'

    """
    if f.__module__ == '__main__':
        from pathlib import Path

        import __main__

        module = __main__.__file__
        module = Path(module).stem
        return f'{module}:{f.__name__}'
    else:
        return f'{f.__module__}:{f.__name__}'