fileutil::multi(3tcl)

💖 fileutil::multi — the manual, but make it cute 💖

okay so bestie, welcome to fileutil::multi(3tcl) from the file utilities fam — the multi-file operation / scatter-gather / standard object icon that you didn't know you needed. no cap, it's giving main character energy. let's go 🦋

---

✨ NAME ✨

fileutil::multi — Multi-file operation, scatter/gather, standard object 💅

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require fileutil::multi ?0.2?

package require fileutil::multi::op ?0.5.4?

package require wip ?1.1?

::fileutil::multi ?word...?

---

🌸 DESCRIPTION 🌸

so basically this package hands you one single command that does actions on a whole bunch of files at once, and those files get picked out by glob patterns. iconic behavior honestly.

it's a thin layer sitting on top of the package fileutil::multi::op, which is the one that actually provides objects for the same thing. this package is lowkey just out here creating a single such object and sending every file command straight to it. no thoughts, just delegation. 🫶

at the core of it all is a domain specific language ✨ that lets you specify multi-file copy and/or move and/or deletion operations with ease. alternate names for this whole vibe would be scatter/gather processor, or maybe even assembler — the lore is real.

for the detailed specification of this language, plus examples, please go read the documentation for the package fileutil::multi::op. fr fr, that's where the whole grammar lives. 💜

---

👑 PUBLIC API 👑

the main command of the package is:

• ::fileutil::multi ?word...? — this command interprets the words you give it as file commands to execute. for the set of acceptable commands, their syntax, and semantics, check the section FILE API of the documentation for the package fileutil::multi::op. and the result of the command? it's the result generated by the last file command it executed. periodt. 💅

---

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document and the package it describes will undoubtedly contain bugs and other problems. please report such in the category fileutil of the Tcllib Trackers at [http://core.tcl.tk/tcllib/reportlist]. and please also report any ideas for enhancements you may have for either package and/or documentation. we love a glow-up suggestion. 🙈

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. iykyk. 🎀

---

⭐ KEYWORDS ⭐

copy, file utilities, move, multi-file, remove

---

🌈 CATEGORY 🌈

Programming tools

---

and that's the whole page bestie, no notes 💖 this was brought to you by tcllib, version 0.2 — slay, stan, and go copy some files. 🍓🧚♀️