summaryrefslogtreecommitdiff
path: root/ext/File-Find/t/lib/Testing.pm
diff options
context:
space:
mode:
Diffstat (limited to 'ext/File-Find/t/lib/Testing.pm')
-rw-r--r--ext/File-Find/t/lib/Testing.pm61
1 files changed, 61 insertions, 0 deletions
diff --git a/ext/File-Find/t/lib/Testing.pm b/ext/File-Find/t/lib/Testing.pm
index 70c5dcd6d0..c638ce06b7 100644
--- a/ext/File-Find/t/lib/Testing.pm
+++ b/ext/File-Find/t/lib/Testing.pm
@@ -8,6 +8,8 @@ our @EXPORT_OK = qw(
create_file_ok
mkdir_ok
symlink_ok
+ dir_path
+ file_path
);
# Wrappers around Test::More::ok() for creation of files, directories and
@@ -36,4 +38,63 @@ sub symlink_ok($$;$) {
or die("Unable to symlink from $oldfile to $newfile");
}
+# Use dir_path() to specify a directory path that is expected for
+# $File::Find::dir (%Expect_Dir). Also use it in file operations like
+# chdir, rmdir etc.
+#
+# dir_path() concatenates directory names to form a *relative*
+# directory path, independent from the platform it is run on, although
+# there are limitations. Do not try to create an absolute path,
+# because that may fail on operating systems that have the concept of
+# volume names (e.g. Mac OS). As a special case, you can pass it a "."
+# as first argument, to create a directory path like "./fa/dir". If there is
+# no second argument, this function will return "./"
+
+sub dir_path {
+ my $first_arg = shift @_;
+
+ if ($first_arg eq '.') {
+ return './' unless @_;
+ my $path = File::Spec->catdir(@_);
+ # add leading "./"
+ $path = "./$path";
+ return $path;
+ }
+ else { # $first_arg ne '.'
+ return $first_arg unless @_; # return plain filename
+ my $fname = File::Spec->catdir($first_arg, @_); # relative path
+ $fname = VMS::Filespec::unixpath($fname) if $^O eq 'VMS';
+ return $fname;
+ }
+}
+
+# Use file_path() to specify a file path that is expected for $_
+# (%Expect_File). Also suitable for file operations like unlink etc.
+#
+# file_path() concatenates directory names (if any) and a filename to
+# form a *relative* file path (the last argument is assumed to be a
+# file). It is independent from the platform it is run on, although
+# there are limitations. As a special case, you can pass it a "." as
+# first argument, to create a file path like "./fa/file" on operating
+# systems. If there is no second argument, this function will return the
+# string "./"
+
+sub file_path {
+ my $first_arg = shift @_;
+
+ if ($first_arg eq '.') {
+ return './' unless @_;
+ my $path = File::Spec->catfile(@_);
+ # add leading "./"
+ $path = "./$path";
+ return $path;
+ }
+ else { # $first_arg ne '.'
+ return $first_arg unless @_; # return plain filename
+ my $fname = File::Spec->catfile($first_arg, @_); # relative path
+ $fname = VMS::Filespec::unixify($fname) if $^O eq 'VMS';
+ return $fname;
+ }
+}
+
1;