CiderW...::Part(3pm)

πŸ“¦
version 1.05+20240702 Β· 5 versions
, in debian trixie, ubuntu resolute

CiderW...::Part πŸ¦‹πŸ’–

okay bestie, gather round 🫢 this is CiderW...::Part, a lil Perl module that lives in the User Contributed Perl Documentation section of your man pages (that's the <3pm> part, iykyk). It's the part-y bit of CiderWebmail β€” like, one part of a message: a body, an attachment, a lil chunk of a MIME thing. And it has ✨methods✨. So many methods. All of them below, in order, no skips, no cap. πŸ’…


🌸 THE METHODS 🌸

main_body_part()

Returns the main body part for using when forwarding/replying the message. πŸŽ€ That's the one you actually want when you hit reply, bestie.

body()

returns the body of the part unless body({ raw => 1}) is specified β€” converting the body to utf-8 will be attempted. So if you pass raw => 1 you get it as-is, no glow-up. ✨

_decode_body()

attempt a best-effort $charset to utf-8 conversion. It's giving "we'll try our best" energy, not "we promise" energy. πŸ™ˆ

part_id()

returns the part_id of the part.

body_id()

returns the body_id of the part or undef. Yeah, sometimes it's just undef. Not everyone has a body_id and that's fine. πŸ’€

guess_recipient()

Tries to guess the recipient address used to deliver this message to this mailbox. Used for suggesting a From address on reply/forward. πŸ”₯

handler()

returns a CiderWebmail::Part::FooBar object for the specified part.

icon() {

returns the name of a icon representing the content type fo the part πŸŽ€ (yes, the brace is just there. it's iconic. we don't question it. πŸ’…)

render()

render a CiderWebmail::Part. just a stub - override in CiderWebmail::Part::FooBar. So this one literally does nothing on its own, it's the main character who's waiting for a subclass to show up. πŸ‘‘

cid()

returns the Content-ID of the part.

content_type()

returns the content type of the CiderWebmail::Part.

name()

returns the name of the part or "(attachment|part) content/type" β€” like, if there's no real name it'll hand you a placeholder situation. 🌈

file_name()

returns a best-guess file_name if one was supplied or undef. Best-guess!! It's doing its best!! 🫢

is_attachment()

returns true if the body disposition indicates it is an attachment.

bodydisp()

returnes the body disposition hash (if it exists) or undef. ("returnes" β€” the original said it, I'm keeping it, it's canon πŸ’–)

attachment()

returns true if the bodydisp indicates it is a attachment.

bodyparms()

returnes the bodyparms hash (if it exists) or undef.

uri_download

returns an http url to access the part. πŸ“₯

uri_render

returns an http url to render the part. πŸ–ΌοΈ

is_root_part

returns true if this part is the root part (RFC822 message). That's the mother of all parts, the OG, the one everything else hangs off of. πŸ‘‘


🌟 no options, no flags, no env vars, no exit statuses here β€” this page is just the method roster, and every single one made it in. vv important that nothing got dropped, so nothing got dropped. πŸ’―

that's the whole vibe, bestie πŸ’œ this page came from the User Contributed Perl Documentation, shipping with perl v5.40.1, dated 2025-03-02. mwah, go read some MIME parts πŸŽ€βœ¨πŸ’…

πŸ“¦ where this page comes from