PFT::Content::File(3)

💖 PFT::Content::File 💖

okay so bestie, welcome to PFT::Content::File(3) — yeah that's the manual name, it's giving very "chapter three of the Perl docs", and honestly? iconic. this is the User Contributed Perl Documentation page and it's all about a content file that lives on your disk. let's get into it 🫶

---

✨ NAME ✨

PFT::Content::File — the on-disk content file. that's it, that's the whole vibe. a file. on a disk. we love her 💅

---

🌸 SYNOPSIS 🌸

here's how you actually summon one, no cap:

use PFT::Content::File;

my $f1 = PFT::Content::File->new({
    tree => $tree,
    path => $path,
    name => $name,  # optional, defaults to basename($path)
});

so like. tree, path, and optionally name (which, if you don't hand it over, lowkey just defaults to basename($path) — she figures it out herself, main character energy fr fr).

---

🦋 DESCRIPTION 🦋

this class describes a content file on disk. that's the whole job. she's a little object that knows about a file sitting on your filesystem, and she's got opinions (properties) about it.

---

🎀 Properties 🎀

okay so besides everything listed down here, there's more stuff she inherits from "PFT::Content::Base" — like, she's not doing all of this alone, she's got a whole family tree of inherited properties. periodt. anyway, here's what's hers:

• path — the absolute path of the file on the filesystem. like, the whole entire address, no shortcuts. 📍
• encpath — the absolute path, but encoded with locale. same file, different fit. ✨
• filename — the base name of the file. just the name-name, not the whole path situation. 🎀
• mtime — last modification time, according to the filesystem. the file's own little "when did i last change" receipt. ⏰
• open — opens a file descriptor for the file, like:

$f->open        # Read file descriptor
$f->open($mode) # Open with r|w|a mode

and the best part?? she does automatic error checking — if something goes wrong she confesses on error. so if it breaks, you will hear about it. no silent suffering. 😭

• touch — changes the modification time on the filesystem to the current timestamp. a lil glow-up for the mtime, she's fresh now. 💅
• exists — verifies if the file exists. are you there bestie?? 👀
• empty — checks if the file is empty. sometimes the vibe is just... nothing. 💀
• unlink
• rename_as — moves the file in the filesystem, and updates the internal data to match. she moves and she updates her own receipts, we stan a self-aware queen. 🦋

ngl, notice how unlink and rename_as are listed together up there — that's exactly how the original page lays them out, so that's how we're keeping them. no merging, no inventing, we don't do that here. 🙈

---

🌈 a lil sign-off 🌈

and that's the page, bestie!! this whole thing comes from perl v5.42.0, dated 2025-07-25 — so go forth and PFT::Content::File your heart out. you're gonna slay, fr fr. 💖✨🎀🦋🌸💅🫶👑