CiderW...::Util(3pm)

🦋 CiderW...::Util 🦋

okay bestie, welcome to CiderW...::Util — the 3pm manual, aka User Contributed Perl Documentation, and honestly? it's giving utility drawer energy in the best way. it's a grab bag of helper functions for folder trees, URIs, message grouping, and encryption. let's get into it 💅

---

✨ FUNCTIONS ✨

🎀 add_foldertree_uris

add_foldertree_uris($c, {folders => $folder_tree, path => 'folder/path', uris => [{action => 'view', uri => 'view_folder'}, ...]})

Adds some URIs to a folder tree. that's it, that's the whole vibe. you hand it the folders, a path, and a little list of action/uri pairs, and it just... slots them in. iconic. ✨

---

🌸 add_foldertree_icons

add_foldertree_icons($c, {folders => $folder_tree})

Adds some icons to a folder tree. folders deserve cute little icons too, fr fr. 🎀

---

💜 uri_mask_folder_path

uri_mask_folder_path($path)

Mask all slashes in folder path for use in URIs. slashes are NOT invited to the URI party, so this function escorts them out. lowkey essential. 🙈

---

🦋 add_foldertree_to_stash

add_foldertree_to_stash($c)

Gets a folder tree and folders hash from the model, adds 'view' uris and puts them on the stash. so it does a lil three-step: grab from the model, sprinkle in the 'view' uris, drop it on the stash. main character behavior honestly. 💖

---

⭐ send_foldertree_update

send_foldertree_update($c)

Common function to reply to a request with a new folder tree. Used in AJAX commands. it's the shared reply-girl for AJAX commands — one function, everyone calls it. no cap. 🔥

---

🧚 filter_unusable_addresses

filter_unusable_addresses(@addresses)

Filters a list of addresses (string or Email::Address::XS) to get rid of stuff like 'undisclosed-recipients:' yes, it takes both plain strings and Email::Address::XS objects, and it yeets the junk. you're welcome. 💅

---

🌈 message_group_name

message_group_name

formats a date/subject/address for message-grouping — for examples, it removes (re:|fwd:) from subjects. so like, no more Re: Re: Re: chaos in your grouping. we love a clean subject line. 🍓

---

👑 encrypt

encrypt({ string => $string })

encrypt a string. secrets stay secret. 🔒✨

---

💖 decrypt

decrypt({ string => $string })

decrypt a string. and then secrets get un-secreted again, as a treat. 🫶

---

🔥 get_key

get_key()

gets the server-side encryption key — and if no key exists, one will be created. so it's never gonna leave you hanging, bestie. 😭💜

---

ngl, that's the whole page — every function, every signature, every detail, all accounted for. nothing skipped, nothing invented. periodt. 💅

---

and that's a wrap! this page is from perl v5.40.1, dated 2025-03-02, and it lives under CiderW...::Util(3pm) in the User Contributed Perl Documentation. mwah 💋 take care of her! 🦋🌸✨