tcl::c...:facade(3tcl)

💖 tcl::chan::facade — bestie, it's the Facade channel 💖

okay so we're in the tcl::c...:facade(3tcl) page, part of the reflected/virtual channel support saga, and honestly? it's giving middle-management but make it iconic. let's go 🫶

---

✨ NAME ✨

tcl::chan::facade — Facade channel. that's it, that's the name, short and slay 💅

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require TclOO

package require logger

package require tcl::chan::core ?1.1?

package require tcl::chan::facade ?1.1?

::tcl::chan::facade chan

like yes you need all of those, no skipping, the dependency list is the whole vibe check ✨

---

🦋 DESCRIPTION 🦋

so the tcl::chan::facade package hands you a command that builds facades to other channels. and what even is a facade, you ask? it's a channel that owns exactly one subordinate channel and just... delegates every single operation to it. no cap. it's the friend who forwards your texts to the group chat 💀

the main reason facades exist is for debugging the actions on a channel. and here's the tea: most of the info could be tracked by a virtual channel transformation, BUT — and this is the plot twist — that transformation doesn't have access to the event-related operation, and on top of that, transformations are only available in Tcl 8.6. 🙈

so therefore: this channel works with Tcl 8.5, and it has access to everything going on for a channel. everything. all of it. main character energy fr fr 👑

the intercepted actions on the channel are logged through the package logger. so it's basically a lil spy that journals about it 🌸

and beyond all that, facades give you these extra channel configuration options:

• -self — the TclOO object handling the facade. yes, it knows itself, self-care 💖
• -fd — the handle of the subordinate channel, i.e. the wrapped channel. the lil one inside 🎀
• -used — the last time the wrapped channel was read from or written to by the facade, as per clock milliseconds. a value of 0 means the subordinate channel was not accessed at all, yet. not once. ghosted 😭
• -created — the time the facade was created, as per clock milliseconds. its birthday 🎂
• -user — a free-form value identifying the user of the facade and its wrapped channel. put whatever you want in there bestie, it's free-form ✨

⚠️ of these options, only -user is writable. the rest are read-only, look-don't-touch, admire-from-afar 💅

---

🔥 API 🔥

• ::tcl::chan::facade chan — this command creates the facade channel around the provided channel chan, and returns its handle. that's the whole API, one command, and it ATE 👑

---

💀 BUGS, IDEAS, FEEDBACK 💀

ngl this document, and the package it describes, will undoubtedly contain bugs and other problems. it's giving "we know, we know". so please report them in the category virtchannel of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. and if you have ideas for enhancements for either the package and/or the documentation, report those too, we wanna hear it 🫶

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

also note — and this part matters — attachments are strongly preferred over inlined patches. you can make an attachment 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. that's the whole ritual, no shortcuts 🧚

---

⭐ KEYWORDS ⭐

concatenation channel, reflected channel, tip 219, virtual channel

---

🌈 CATEGORY 🌈

Channels

---

👑 COPYRIGHT 👑

Copyright (c) 2011 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

and that's the page bestie!! this one shipped as tcllib version 1.1, and the manual page itself is titled tcl::c...:facade(3tcl) — so yeah, go forth, wrap a channel, log everything, and remember: only -user is writable 💜✨