NAME
Path::ExpandTilde - Expand tilde (~) to homedir in file paths
SYNOPSIS
use Path::ExpandTilde;
my $homedir = expand_tilde('~');
my $bashrc = expand_tilde('~/.bashrc');
my $pg_home = expand_tilde('~postgres');
DESCRIPTION
This module uses bsd_glob from File::Glob to portably expand a leading
tilde (~) in a file path into the current or specified user's home
directory. No other glob metacharacters are expanded.
FUNCTIONS
expand_tilde
my $new_path = expand_tilde($path);
Exported by default. If the path starts with ~, expands that to the
current user's home directory. If the path starts with ~username,
expands that to the specified user's home directory. If the user
doesn't exist, no expansion is done. The returned path is canonicalized
as by "canonpath" in File::Spec either way.
NOTES
The algorithm should be portable to most operating systems supported by
Perl, though the home directory may not be found by bsd_glob on some.
BUGS
Report any issues on the public bugtracker.
AUTHOR
Dan Book <
[email protected]>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2018 by Dan Book.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
SEE ALSO
File::Path::Expand, File::HomeDir, File::HomeDir::Tiny