PFT::Co...t::Entry(3)

💖 PFT::Content::Entry 💖

okay so bestie, welcome to the PFT::Content::Entry page from the User Contributed Perl Documentation — yes it's a Perl manpage, yes it's giving vintage, and yes we're gonna read it together like it's a group chat. pull up a chair 🫶

---

✨ NAME ✨

PFT::Content::Entry — content edited by user. that's it, that's the whole vibe. a file that you touched. main character energy fr 💅

---

✨ SYNOPSIS ✨

use PFT::Content::Entry;

my $p = PFT::Content::Entry->new({
    tree => $tree,
    path => $path,
    name => $name,
})

look at that constructor. so clean. so demure. it takes a tree, a path, and a name, and it just works ✨

---

✨ DESCRIPTION ✨

so PFT::Content::Entry is the basetype for all text-based content files. every text-y content thing in this whole system? it's a descendant of this. it's the mother of the group chat. 👑

it inherits from PFT::Content::File, and it has two specific subtypes that are lowkey its whole personality:

• PFT::Content::Blog — representing an entry with a date 📅
• PFT::Content::Page — representing an entry without a date 🙈 (yes, the original really does spell it "withouth", iconic typo, we love her)

---

🌸 Methods 🌸

🎀 open

Open the file, and hand you back a file handler. it also sets the binmode according to the locale, because we are respectful of encodings in this house 🫶

🎀 header

Reads the header from the page.

• Returns undef if the entry isn't backed by a file (no file, no header, no problem 💀)
• Croaks if the file doesn't contain a healthy header — and ngl, if your header isn't healthy you deserve to hear about it 😭

🎀 read

Read the page.

• In scalar context it returns an open file descriptor, configured with the correct binmode according to the header
• In list context it returns the header and that same descriptor
• Returns undef if the file doesn't exist

it croaks if the header is broken. so like… don't have a broken header. or do, and get yelled at. your call bestie 💀

🎀 void

Evaluates as true if the entry is void — meaning the file does not exist, or it contains only the header. empty girlies. header-only girlies. they're all void here ✨

🎀 set_header

Sets a new header, passed by parameter.

heads up: this will rewrite the file. the content will be maintained, so no casualties, but still — it's writing to your file, be normal about it 🙈

🎀 make_consistent

Make the page consistent with the filesystem tree. alignment. harmony. self-care. 🌈

---

💀 POD ERRORS 💀

not me having to tell you this but — hey! the above document had some coding errors, which are explained below:

Around line 43:

=back without =over

yeah. a =back with no =over to back. it's giving orphaned formatting directive. it's giving "who raised you". we still love her though 💜

---

okay that's the whole page, you ate that reading session fr fr 🍓

perl v5.42.0 · 2025-07-25 · from the User Contributed Perl Documentation — this manpage was served fresh on that date and you just devoured it. no cap. periodt. 💅✨