NAME

       Cwd::Guard - Temporary changing working directory (chdir)

SYNOPSIS

         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 Cwd:: Guard can change the current directory (chdir) using a limited scope.

FUNCTIONS

       cwd_guard($dir);
           chdir to $dir and returns Cwd::Guard object. return to current working directory, if
           this object destroyed.  if failed to chdir, cwd_guard return undefined value. You can
           get error messages with $Gwd::Guard::Error.

AUTHOR

       Masahiro Nagano <kazeburo {at} gmail.com>

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.