Convenience functions for the python execution stack.
Project description
I find the supplied python traceback facilities quite awkward. These functions provide convenient facilities.
Latest release 20240412:
- stack_dump: new select parameter to pick interesting frames for the listing.
- Provide StackSummary and FrameSummary if Python too old.
Function caller(frame_index=-3)
Return the Frame
of the caller's caller.
Returns None
if frame_index
is out of range.
Useful frame_index
values:
-1
: caller, this function-2
: invoker, who wants to know the caller-3
: the calling function of the invoker
The default from_index
value is -3
.
Function frames()
Return the current stack as a list of Frame
objects.
Function stack_dump(f=None, indent=0, frames=None, skip=None, select=None, format_frame=None)
Recite current or supplied stack to f
, default sys.stderr
.
Parameters:
f
: the output file object, defaultsys.stderr
indent
: how many spaces to indent the stack lines, default0
frames
: the stackFrame
s to write, default obtained from the current stackskip
: the number ofFrame
s to trim from the end offrames
; ifframes
isNone
this defaults to2
to trim theFrame
s for thestack_dump
function and its call toframes()
, otherwise the default is0
to use the suppliedFrame
s as isselect
: if notNone
, select particular frames; ifselect
is astr
it must be present in the frame filename; otherwiseselect(frame)
must be true
Release Log
Release 20240412:
- stack_dump: new select parameter to pick interesting frames for the listing.
- Provide StackSummary and FrameSummary if Python too old.
Release 20220918: caller(): return None if the frame offset is out of range.
Release 20220429: caller: return None if the stack index is out of range.
Release 20190812: stack_dump(): trim the last 2 frames from the listing by default (they are part of stack_dump's implementation).
Release 20190101:
- _Frame: rename .functionname to .funcname; caller: turn raw frames into Frames.
- caller(): accept optional frame_index, default -3.
Release 20160827: Add stack_dump().
Release 20150115: PyPI metadata fixups.
Release 20150111: Tag for initial PyPI release of cs.py.stack.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cs.py.stack-20240412-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf1b9d706e40f4a79ba23cc7b92123a4b9e448397b76208279eeb521ddc8656c |
|
MD5 | 9f325f4f3204e1187748484bc261fba9 |
|
BLAKE2b-256 | 3a0bde02e3753a060a987a17472dbdbf846b4168d72d9f01e5f165c50a76144c |