fileutil::magic::filetype(3tcl)

📦
version 2.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 fileutil::magic::filetype 💖

okay bestie, welcome to the manual page for fileutil::magic::filetype, which lives in the file utilities corner of the Tcllib manual (section 3tcl, iykyk). this is the whole page, every last crumb of it, but make it cute. let's go ✨

🌸 SYNOPSIS 🌸

package require Tcl 8.6 9

package require fileutil::magic::filetype ?2.0?

::fileutil::magic::filetype filename

like, yes, she needs Tcl 8.6 or 9 to even show up to the party, and the package itself can be pinned at version 2.0 if you're the type who likes to lock things down (valid 💅).

🦋 DESCRIPTION 🦋

so this package gives you a command for recognizing file types, and the entire thing is written in pure Tcl. no compiled C shenanigans, no shady binaries, just vibes and Tcl. periodt.

the core of the recognizer was generated from a "magic(5)" file — you know, the one holding all the checks to perform to recognize files, plus the associated file-types. so it's got receipts, it's not just guessing. 🎀

Beware! this recognizer is large. we're talking about 752 Kilobyte of generated Tcl code. not a typo, not a drill, seven hundred and fifty-two kilobytes of pure generated Tcl. she's big. she's beautiful. she takes a minute to load. 😭

👑 ::fileutil::magic::filetype filename

this command is similar to the command fileutil::fileType. (sisters, basically, same energy.)

what she returns is a list containing:

  • a list of descriptions
  • a list of mimetype components
  • a list of file extensions

and if the file content is just... not recognized? you get an empty string. no drama, no error, just nothing. it's giving mysterious. 🫶

🌈 REFERENCES 🌈

  1. File(1) sources [ftp://ftp.astron.com/pub/file/] — this site contains the current sources for the file command, including the magic definitions used by it. those magic definitions were the ones used by us to generate this recognizer. so like, credit where credit is due, bestie. ⭐

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document and the package it describes will undoubtedly contain bugs and other problems. it's a manual page, they all do. 🙈

please report such bugs in the category fileutil :: magic 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. we're obsessed with them.

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

also note 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. iconique workflow, we don't make the rules. ✨

🌸 SEE ALSO 🌸

🎀 KEYWORDS 🎀

file recognition, file type, file utilities, type

💜 CATEGORY 💜

Programming tools

and that's the whole page, bestie, no cap. this absolute queen of a manpage is brought to you by tcllib, version 2.0 — slay, go recognize some file types, you got this 💅✨🦋

📦 where this page comes from