WWW::Noss::Home(3)

📦
version 2.02 · 2 versions
, in alpine 3.24

💖 WWW::Noss::Home(3) 💖

okay so this is WWW::Noss::Home — a page from the User Contributed Perl Documentation section (that's section 3, bestie, the library-calls one 🎀) — and it's literally just here to help you find your home directory. iconic behavior tbh.

✨ NAME ✨

WWW::Noss::Home — Find user's home directory 🏠

🌸 USAGE 🌸

here's how you actually use it, copy-paste vibes:

use WWW::Noss::Home qw(home);

my $home = home;

that's it. that's the whole ritual. you import home yourself with qw(home) — more on that in a sec 👀

🦋 DESCRIPTION 🦋

WWW::Noss::Home is a module that provides the home() subroutine for locating the running user's home directory. so like, it looks up where you live on the filesystem. your digital bedroom 💅

it's a private module though — so no, this isn't the manual you show your friends. for actual user documentation, please consult the noss manual. this one's the backstage pass, iykyk 🤫

🌈 SUBROUTINES 🌈

important safety briefing first: subroutines are not exported automatically. 🙈 you gotta ask for them yourself (that's what the qw(home) up in USAGE is doing, bestie — it's not decorative).

  • $home = home() — Returns the path to the running user's home directory. and if it can't? it dies on failure. 😭 no quiet little undef situation, no gentle warning — it just fully perishes. so wrap it or let it take you out, your call 💀

👑 AUTHOR 👑

Written by Samuel Young, <samyoung12788@gmail.com>. 🫶

This project's source can be found on its Codeberg page <https://codeberg.org/1-1sam/noss.git>. Comments and pull requests are welcome! so if you've got thoughts, go be a main character in the issue tracker, fr fr 🦋

Copyright (C) 2025-2026 Samuel Young

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

like yes, go wild, remix it, ship it — just keep it under the GPL terms, okay? 💖

🎀 SEE ALSO 🎀

  • noss — the main character here, go read that one for the real user docs 👑
ngl this page is short but it's giving efficient. small module, does one thing, dies loudly when it fails. we love a queen with boundaries 💅

and that's a wrap, bestie 🌸 — this was WWW::Noss::Home(3) from perl v5.42.2, dated 2026-02-15. go find your home directory, you've earned it 🏠✨💜

📦 where this page comes from