Reflection
**********

PyObject* PyEval_GetBuiltins(void)
    *Return value: Borrowed reference.*

   Return a dictionary of the builtins in the current execution frame,
   or the interpreter of the thread state if no frame is currently
   executing.

PyObject* PyEval_GetLocals(void)
    *Return value: Borrowed reference.*

   Return a dictionary of the local variables in the current execution
   frame, or "NULL" if no frame is currently executing.

PyObject* PyEval_GetGlobals(void)
    *Return value: Borrowed reference.*

   Return a dictionary of the global variables in the current
   execution frame, or "NULL" if no frame is currently executing.

PyFrameObject* PyEval_GetFrame(void)
    *Return value: Borrowed reference.*

   Return the current thread state’s frame, which is "NULL" if no
   frame is currently executing.

   See also "PyThreadState_GetFrame()".

int PyFrame_GetBack(PyFrameObject *frame)

   Get the *frame* next outer frame.

   Return a strong reference, or "NULL" if *frame* has no outer frame.

   *frame* must not be "NULL".

   New in version 3.9.

int PyFrame_GetCode(PyFrameObject *frame)

   Get the *frame* code.

   Return a strong reference.

   *frame* must not be "NULL". The result (frame code) cannot be
   "NULL".

   New in version 3.9.

int PyFrame_GetLineNumber(PyFrameObject *frame)

   Return the line number that *frame* is currently executing.

   *frame* must not be "NULL".

const char* PyEval_GetFuncName(PyObject *func)

   Return the name of *func* if it is a function, class or instance
   object, else the name of *func*s type.

const char* PyEval_GetFuncDesc(PyObject *func)

   Return a description string, depending on the type of *func*.
   Return values include “()” for functions and methods, ”
   constructor”, ” instance”, and ” object”.  Concatenated with the
   result of "PyEval_GetFuncName()", the result will be a description
   of *func*.
