Config...::Unix(3pm)

✨ NAME ✨

Config::Find::Unix — it's a Config::Find plugin for Unixen 💅 (yes the module is a whole 3pm perl thing, user contributed perl documentation vibes, iykyk)

---

🎀 SYNOPSIS 🎀

bestie listen. you do NOT use this module directly, okay? it's a plugin. it gets pulled in by its bestie:

  # don't use Config::Find::Unix directly
  use Config::Find;

that's it. that's the whole flex. 🫶

---

🦋 ABSTRACT 🦋

Config::Find plugin for Unixen</purl> — literally just that. short. sweet. iconic.

---

🌸 DESCRIPTION 🌸

okay so this module implements Config::Find for Unix 💖 and the tea is all about the order it goes looking for your config files in. so slay, here's the lineup:

  1  ~/.$name                             [user]
  1b ~/.$name.conf                        [user]
  2  /$path_to_script/../etc/$name.conf   [global]
  3  /$path_to_script/../conf/$name.conf  [global]
  4  /etc/$name.conf                      [global]

✨ and yes there is a 1b, that's not a typo, she's just built different ✨

BUT — plot twist — if the environment variable $ENV{${name}_HOME} is defined, it does this instead:

  1  ~/.$name                             [user]
  1b ~/.$name.conf                        [user]
  2  $ENV{${name}_HOME}/etc/$name.conf    [global]
  3  $ENV{${name}_HOME}/conf/$name.conf   [global]
  4  /etc/$name.conf                      [global]

instead. 💀 (same energy, different address, no cap)

---

and now for the other vibe: when the "several configuration files in one directory" approach is used, the order is somewhat different:

  1  ~/.$dir/$name.conf                        [user]
  2  /$path_to_script/../etc/$dir/$name.conf   [global]
  3  /$path_to_script/../conf/$dir/$name.conf  [global]
  4  /etc/$dir/$name.conf                      [global]

(also affected by $ENV{${name}_HOME}) 🧚 — she's everywhere, she's the main character fr fr

side note bestie: notice the 1b vanished in this one and $dir slid into the path. that's not me being messy, that's literally what the page says. 👑

---

🔥 SEE ALSO 🔥

go read these too, they're the friend group:

• Config::Find
• Config::Find::Any

---

👑 AUTHOR 👑

Salvador Fandiño García, <sfandino@yahoo.com> 💜

---

🌈 CONTRIBUTORS 🌈

• Barbie, <barbie@missbarbell.co.uk> (some bug fixes and documentation) 🎀

---

💜 COPYRIGHT AND LICENSE 💜

read this part, bestie, it's the legal slay 💅

Copyright 2003-2015 by Salvador Fandiño García (sfandino@yahoo.com) Copyright 2015 by Barbie (barbie@missbarbell.co.uk)

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's a wrap on Config::Find::Unix 🌟 this page was served up by perl v5.36.0, dated 2022-12-07, and the manual name is Config...::Unix(3pm) bc the terminal clipped her name like a bad screenshot 😭 periodt. bye bestie, go find some configs 💖✨