1. """pydbg is an implementation of the Rust2018 builtin `dbg` for Python."""
    3. import inspect
    4. import sys
    5. import typing
    8. __version__ = "0.3.0"
    11. _ExpType = typing.TypeVar('_ExpType')
    14. def dbg(exp: _ExpType) -> _ExpType:
    15.     """Call dbg with any variable or expression.
    16.     Calling debug will print out the content information (file, lineno) as wil as the
    17.     passed expression and what the expression is equal to::
    18.         from pydbg import dbg
    19.         a = 2
    20.         b = 5
    21.         dbg(a+b)
    22.         def square(x: int) -> int:
    23.             return x * x
    24.         dbg(square(a))
    25.     """
    27.     for frame in inspect.stack():
    28.         line = frame.code_context[0]
    29.         if "dbg" in line:
    30.             start = line.find('(') + 1
    31.             end =  line.rfind(')')
    32.             if end == -1:
    33.                 end = len(line)
    34.             print(
    35.                 f"[{frame.filename}:{frame.lineno}] {line[start:end]} = {exp!r}",
    36.                 file=sys.stderr,
    37.             )
    38.             break
    40.     return exp