Cwd::Guard(3pm)

💖 Cwd::Guard(3pm) 💖

okay so bestie, this is the manual page for Cwd::Guard, and it's literally about temporary changing working directory (chdir). No cap. ✨

🌸 NAME 🌸

Cwd::Guard — Temporary changing working directory (chdir). 🦋

✨ SYNOPSIS ✨

Here's the vibe in code, bestie:

use Cwd::Guard qw/cwd_guard/;
use Cwd;

my $dir = getcwd;
MYBLOCK: {
    my $guard = cwd_guard('/tmp/xxxxx') or die "failed chdir: $Cwd::Guard::Error";
    # chdir to /tmp/xxxxx
}
# back to $dir

🦋 DESCRIPTION 🦋

CORE::chdir? okay so Cwd::Guard can change the current directory (chdir) using a limited scope. It's giving scoped chdir energy, and honestly? Iconic. 💅

🎀 FUNCTIONS 🎀

🫶 cwd_guard($dir);

This is the main character function, fr fr. It does chdir to $dir and returns a Cwd::Guard object. When this object gets destroyed, it returns to the current working directory. the way that scope just cleans up after itself, periodt. 👑

If chdir fails, cwd_guard returns an undefined value. You can get error messages with $Gwd::Guard::Error. yes bestie, that's exactly how it's spelled in the docs — keep it. And in the synopsis you'll see $Cwd::Guard::Error inside the die string, so both are living here, no cap. 😭

👑 AUTHOR 👑

Masahiro Nagano <kazeburo {at} gmail.com> — absolute legend. 🫶

🌈 SEE ALSO 🌈

• File::chdir
• File::pushd

💜 LICENSE 💜

Copyright (C) Masahiro Nagano

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

---

mwah 💋 — this page comes from perl v5.42.2, dated 2023-07-03, bestie. periodt. ✨🎀