Path::Abstract 0.06

Path::Abstract is a fast and featurefull class for UNIX-style path manipulation.

SYNOPSIS

use Path::Abstract;

my $path = Path::Abstract->new("/apple/banana");

# $parent is "/apple"
my $parent = $path->parent;

# $cherry is "/apple/banana/cherry.txt"
my $cherry = $path->child("cherry.txt");

Path::Abstract->new( < path> )
Path::Abstract->new( < part>, [ < part>, ..., < part> ] )

Create a new Path::Abstract object using < path> or by joining each < part> with "/"

Returns the new Path::Abstract object

Path::Abstract::path( < path> )
Path::Abstract::path( < part>, [ < part>, ..., < part> ] )

Create a new Path::Abstract object using < path> or by joining each < part> with "/"

Returns the new Path::Abstract object

$path->clone

Returns an exact copy of $path

$path->set( < path> )
$path->set( < part>, [ < part>, ..., < part> ] )

Set the path of $path to < path> or the concatenation of each < part> (separated by "/")

Returns $path

$path->is_nil
$path->is_empty

Returns true if $path is equal to ""

$path->is_root

Returns true if $path is equal to "/"

$path->is_tree

Returns true if $path begins with "/"

path("/a/b")->is_tree # Returns true
path("c/d")->is_tree # Returns false
$path->is_branch

Returns true if $path does NOT begin with a "/"

path("c/d")->is_branch # Returns true
path("/a/b")->is_branch # Returns false
$path->to_tree

Change $path by prefixing a "/" if it doesnt have one already

Returns $path

$path->to_branch

Change $path by removing a leading "/" if it has one

Returns $path

$path->list
$path->split

Returns the path in list form by splitting at each "/"

path("c/d")->list # Returns ("c", "d")
path("/a/b/")->last # Returns ("a", "b")
$path->first

Returns the first part of $path up to the first "/" (but not including the leading slash, if any)

path("c/d")->first # Returns "c"
path("/a/b")->first # Returns "a"
$path->last

Returns the last part of $path up to the last "/"

path("c/d")->last # Returns "d"
path("/a/b/")->last # Returns "b"
path

$path->get
$path->stringify

Returns the path in string or scalar form

path("c/d")->list # Returns "c/d"
path("/a/b/")->last # Returns "/a/b"

$path->push( < part>, [ < part>, ..., < part> ] )
$path->down( < part>, [ < part>, ..., < part> ] )

Modify $path by appending each < part> to the end of $path, separated by "/"

Returns $path

$path->child( < part>, [ < part>, ..., < part> ] )

Make a copy of $path and push each < part> to the end of the new path.

Returns the new child path

$path->pop( < count> )

Modify $path by removing < count> parts from the end of $path

Returns the removed path as a Path::Abstract object

$path->up( < count> )

Modify $path by removing < count> parts from the end of $path

Returns $path

$path->parent( < count> )

Make a copy of $path and pop < count> parts from the end of the new path

Returns the new parent path

$path->file
$path->file( < part>, [ < part>, ..., < part> ] )

Create a new Path::Class::File object using $path as a base, and optionally extending it by each < part>

Returns the new file object

$path->dir
$path->dir( < part>, [ < part>, ..., < part> ] )

Create a new Path::Class::Dir object using $path as a base, and optionally extending it by each < part>
Returns the new dir object