logger::appender(3tcl)

🌸 logger::appender 💅

okay bestie, you found the logger::appender page — it's part of the tcllib docs, and it's the object oriented logging facility's little box of pre-made appenders. it's giving "here are your templates, go log stuff." 🎀

---

✨ NAME ✨

logger::appender — a whole collection of predefined appenders for logger. no cap, that's literally the job. 🦋

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require logger::appender ?1.4?

::logger::appender::console -level level -service service ?options...?

::logger::appender::colorConsole -level level -service service ?options...?

like, you gotta have Tcl 8.5 through 9, and you gotta require the package (version 1.4 is optional-ish, the ?1.4? situation 💀). then you call one of the two appenders, which are iconic and colored respectively. ✨

---

✨ DESCRIPTION ✨

so this package provides a predefined set of logger templates. that's it, that's the vibe. here's the cast:

💖 ::logger::appender::console -level level -service service ?options...?

the classic. no frills, just console. here's what you can pass it:

• -level level — the name of the level to fill in as "priority" in the log procedure. so like, which level is this thing repping. 👑
• -service service — the name of the service to fill in as "category" in the log procedure. yes it's a category, yes we're calling it a service, that's just how it is bestie. 🫶
• -appenderArgs appenderArgs — any additional arguments for the log procedure, and they gotta be in list form. fr fr, list form. 📋
• -conversionPattern conversionPattern — the log pattern to use. (peep logger::utils::createLogProc for the allowed substitutions — that's where the receipts live 👀)
• -procName procName — explicitly set the name of the created procedure. you're the main character, you name it. 💅
• -procNameVar procNameVar — name of the variable to set in the calling context. this variable will contain the name of the procedure. so it hands you the name back, cute. 🎀

🌈 ::logger::appender::colorConsole -level level -service service ?options...?

the same but in color, obviously. ✨

see ::logger::appender::colorConsole for a description of the applicable options.

okay yes, that's what the original says — it points you at itself. it's a whole ouroboros moment 💀 not me adding anything, just keeping it 100.

---

🫶 BUGS, IDEAS, FEEDBACK 🫶

this document, and the package it describes, will undoubtedly contain bugs and other problems. not being dramatic, that's just the quote. 😭

please report such in the category logger of the Tcllib Trackers [http://core.tcl.tk/tcllib/reportlist]. please also report any ideas for enhancements you may have for either package and/or documentation. we want the thoughts. all of them. 🧚

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. attachments can be made 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. periodt. 💅

---

✨ KEYWORDS ✨

appender, logger

---

✨ CATEGORY ✨

Programming tools

---

✨ COPYRIGHT ✨

Copyright (c) 2005 Aamer Akhter <aakhter@cisco.com>

---

and that's the whole page bestie!! 🎀💖 this was tcllib, version 1.4, serving you logger::appender(3tcl) realness. go forth and log, you absolute icon. 👑✨🦋