CPAN::...Config(3perl)

✨ NAME ✨

CPAN::HandleConfig — internal configuration handling for CPAN.pm 💅

bestie this is the backstage-pass module, the little gremlin behind the curtain making sure CPAN.pm's config stays cute and functional. it's internal, so like… it's giving "don't touch unless you know what you're doing" energy, iykyk. 🎀

---

🌸 CLASS->safe_quote ITEM 🌸

okay so here's the whole vibe of this method: it takes an ITEM and makes it safe against spaces when it gets interpolated by the shell. no cap, spaces in directory names are the drama of the century, so we wrap things in double quotes to keep the shell from getting confused.

An ITEM gets enclosed in double quotes if:

• the ITEM contains spaces in the middle
• the ITEM does not start with a quote

like literally this all happens just to dodge shell interpolation problems when whitespace shows up in directory names. the way that a single space can ruin your whole day… 😭 anyway.

This method uses commands_quote to figure out the correct quote character for the job. If commands_quote is a space, then no quoting will take place at all — periodt. 🫶

so the full vibe check goes like this:

• if it starts and ends with the same quote character: leave it as it is ✨
• if it contains no whitespace: leave it as it is 💖
• if it contains whitespace, then:
  • if it contains quotes: better leave it as it is 🙈
  • else: quote it with the correct quote type for the box we're on 👑

---

📜 LICENSE 📜

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, iconic, legally blessed. 🌈👑

---

and that's the whole page bestie 💜 this lil doc came from the Perl Programmers Reference Guide, CPAN::...Config(3perl), from perl v5.44.0 dated 2026-10-17. mwah, go forth and quote safely 🍓💅