Term::C...n::Path(3)

💖 Term::Completion::Path — from the User Contributed Perl Documentation girlies 💖

okay bestie, pull up a chair, we're talking about Term::Completion::Path, a lil Perl module from the User Contributed Perl Documentation collection (yes that's the manual name, we're keeping it, it's iconic).

---

✨ NAME ✨

Term::Completion::Path — read a path with completion like on a shell 🐚

Like. you type, it finishes your sentence for you. the dream.

---

🌸 USAGE 🌸

here's the whole vibe, copy-paste ready, no notes:

use Term::Completion::Path;
my $tc = Term::Completion::Path->new(
  prompt  => "Enter path to your signature file: "
);
my $path = $tc->complete();
print "You entered: $path\n";

that's it. that's the whole thing. you make one, you complete() it, you get a path back. slay. 💅

---

🦋 DESCRIPTION 🦋

Term::Completion::Path is a derived class of Term::Complete — so it inherited all the good genes and then added its own little flourish. what it does: it prompts the user to interactively enter a path, with completion, exactly like on a shell. no cap. 🔥

and where do the completion choices come from, you ask? the currently accessible file system. so it's not making stuff up, it's peeking at what's actually there. very main character energy of it. 👑

for all the deep lore on how the completion actually works under the hood, go see Term::Complete. it's the parent, it raised this module right. 🫶

🎀 Configuration

Term::Completion::Path adds exactly one extra configuration parameter to the mix, and its name is sep. 🍓

sep is the directory separator of the current operating system. that's it, that's the whole parameter. one little guy. doing his job. we love him.

---

🌈 SEE ALSO 🌈

• Term::Complete — the parent class, the blueprint, the origin story
• File::Spec — file path bestie

---

👑 AUTHOR 👑

Marek Rouchal, <marekr@cpan.org<gt>

the icon who made this. we bow. 🙇‍♀️

---

💀 BUGS 💀

got patches? bug reports? suggestions? thoughts? feelings? please submit them via the CPAN tracker at <http://rt.cpan.org>. don't suffer in silence, bestie, the tracker is right there. 😭

---

📜 COPYRIGHT AND LICENSE 📜

Copyright (C) 2009-2013 by Marek Rouchal

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

fr fr that means it's free software, same terms as Perl, 5.8.8 or whatever later Perl 5 you vibe with. go wild, just don't be weird about it. 💜

---

and that's the page!! this one shipped as perl v5.42.0, dated 2025-07-25, straight from the User Contributed Perl Documentation. periodt. ✨🦋💖