debug::caller(n)

📦
version 2.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 debug::caller(n) — the debug narrative caller, bestie edition 💖

ok so this is the debug::caller page from the debug narrative crew. yes it's a Tcl thing. yes it's adorable. let's get into it 🦋

✨ NAME ✨

debug::caller — debug narrative - caller 💅

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require debug::caller ?1.2?

debug caller ?args...?

🎀 DESCRIPTION 🎀

👑 API 👑

  • debug caller ?args...? — bestie this one is so useful. Drop it in a tag-specific prefix and it'll auto-magically hand you caller info for every single use of that tag. Or just use it inside a message when only a few specific spots actually need that kind of detail. either way, it ate. ✨

Beyond that? It recognizes the various internal forms of method calls that the snit OO system generates and rewrites them back into their original form, because readability is the moment. Same deal for TclOO. 🔥

Now, if args are specified, they get treated as the integer indices of command arguments that should not show up in the output. Those referenced arguments get swapped out for * instead. The main anticipated use case here is excluding arguments you already know are gonna hold big chonky Tcl values — think long lists, large dictionaries, etc. — so they don't overwhelm the narrative. keep the vibe cute, keep the output smol. 🙈

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document and the package it describes will undoubtedly contain bugs and other problems. it's giving "we're all just doing our best". 😭 Please report them in the category debug of the Tcllib Trackers:

[http://core.tcl.tk/tcllib/reportlist](http://core.tcl.tk/tcllib/reportlist)

Also pls report any ideas for enhancements you have for either the package and/or the docs. we're listening 🫶

When proposing code changes, please provide unified diffs, i.e. the output of diff -u.

⚠️ Note further that attachments are strongly preferred over inlined patches. You can attach stuff by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. iykyk 👑

🌈 KEYWORDS 🌈

debug, log, narrative, trace

⭐ CATEGORY ⭐

debugging, tracing, and logging

Copyright (c) 2012-2015, Andreas Kupries <andreas_kupries@users.sourceforge.net>

tcllib version 1.2 of this little icon, and that's the whole page bestie — go forth and debug caller responsibly, mwah 💅🎀🦋

📦 where this page comes from