deleg_proc(3tcl)

✨ deleg_proc — the manual page but make it a group chat ✨

okay bestie, so this is deleg_proc from the Interpreter utilities corner of tcllib, and it's giving tiny package, huge slay. Version 0.3, and we're literally about to make procedures that delegate all their work to somewhere else entirely. main character energy tbh. 🎀

---

💖 NAME 💖

deleg_proc — Creation of comm delegates (procedures)

Like, it makes procedures. But the procedures don't do the work themselves. They delegate. Periodt. 💅

---

🦋 SYNOPSIS 🦋

package require Tcl 8.5 9

package require interp::delegate::proc ?0.3?

::interp::delegate::proc ?-async? name arguments comm id

---

🌸 DESCRIPTION 🌸

So this package is a whole one-command situation. It gives you a single command for the convenient creation of procedures which delegate the actual work to a remote location via a "channel" created by the package comm.

That's it. That's the whole package. It's small but it ate. 🔥

---

✨ API ✨

💜 ::interp::delegate::proc ?-async? name arguments comm id

This command creates a procedure which is named by name and returns its fully-qualified name. Lowkey obsessed with the fact that you get the FQN back, ngl. 🫶

All invokations of this procedure will delegate the actual work to the remote location identified by the comm channel comm and the endpoint id.

The name of the remote procedure invoked by the delegator is [namespace tail name]. I.e., namespace information is stripped from the call. Bye bye namespace, you will not be missed. 👋

Normally the generated procedure marshalls the arguments, and returns the result from the remote procedure as its own result.

If however the option -async was specified then the generated procedure will not wait for a result and return immediately. No waiting around, she's busy, she has places to be. 💅

---

💀 BUGS, IDEAS, FEEDBACK 💀

Not me writing the bugs section, but here we are. This document, and the package it describes, will undoubtedly contain bugs and other problems. It's giving "we know, we know." 😭

Please report such in the category interp of the Tcllib Trackers at 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 ideas, fr fr. 🌈

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. Left-most button. Remember it. It's iconic. ⭐

---

👑 KEYWORDS 👑

comm, delegation, interpreter, procedure

---

🍓 CATEGORY 🍓

Programming tools

---

🧚 COPYRIGHT 🧚

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

---

okay that's the whole page, you're welcome. 💖 This was tcllib version 0.3, page deleg_proc(3tcl), brought to you by the Interpreter utilities section. go forth and delegate, bestie, you got this 🦋✨