fileutil::multi(n)

🌸 fileutil::multi(n) — file utilities 🌸

ok so bestie, you know fileutil::multi? that's the page we're doing. it lives in the file utilities corner of the manual, and it is lowkey the main character of multi-file operations. let's get into it 💅

---

✨ 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 ✨

okay so here's the vibe: this package gives you one single command that performs actions on a whole bunch of files, and those files get picked out by glob patterns. iconic.

it's honestly a thin little layer sitting on top of the package fileutil::multi::op, which is the one that actually provides objects for exactly this. fileutil::multi just makes one of those objects for you and sends every single file command straight to it. no cap.

at the core of all of this is a domain specific language — yes, a whole lil language — that lets you specify multi-file copy and/or move and/or deletion operations super easily. alternate names for the whole thing would be scatter/gather processor, or maybe even assembler. fr fr.

for the detailed specification of this language, plus examples, please go read the documentation for the package fileutil::multi::op (the page spells it "documention", we love a typo moment 💀).

✨ 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. the set of acceptable commands, their syntax, and their semantics all live over in the section FILE API of the documentation for the package fileutil::multi::op. go look there, bestie.

the result of the command is the result generated by the last file command it executed. so like, whatever the final command spat out, that's what you get. periodt.

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document, and the package it describes, will undoubtedly contain bugs and other problems. it's giving "we know". please report such things in the category fileutil of the Tcllib Trackers:

http://core.tcl.tk/tcllib/reportlist

and please also report any ideas for enhancements you may have for either the package and/or the documentation. we want them 🫶

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

also note: attachments are strongly preferred over inlined patches. you can attach stuff by going to the Edit form of the ticket right after you create it, and then using the left-most button in the secondary navigation bar. that's the one, that's the button ✨

🌈 KEYWORDS 🌈

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

⭐ CATEGORY ⭐

Programming tools

---

and that's the whole page, bestie — tysm for reading 💖 this one comes to you from tcllib, version 0.2, page fileutil::multi(n). slay, go scatter and gather responsibly 🎀✨