NAME Path::Mapper - Map a virtual path to an actual one VERSION Version 0.01 SYNOPSIS my $mapper = Path::Mapper->new( base => '../' ) $mapper->map( a/b => /apple ) $mapper->dir( /a/b/xyzzy/ ) # /apple/xyzzy $mapper->dir( /a/bxyzzy/ ) # ../a/bxyzzy DESCRIPTION Path::Mapper will map a virtual path to an actual one, doing a substitution based on the deepest common directory Think of it as doing something like symbolic link resolution (though not exactly) METHODS Path::Mapper->new( [ base => ] ) Create a new "Path::Mapper" object using as the 'root' directory (by default, everything is mapped to be under that directory) $mapper->base( ) Change the base directory for $mapper to $mapper->map( => ) Set up a map from and anything under (e.g. /*) to map to the prefix instead of the usual base $mapper->map( ) Return a 2-element list containing the actual base for this path and the path remainder. You probably don't want/need to use this method $mapper->dir( ) Map the virtual to an actual one and return the result as a Path::Class::Dir object $mapper->file( ) Map the virtual to an actual one and return the result as a Path::Class::File object $mapper->path( ) Map the virtual to an actual one and return the result as a Path::Abstract object AUTHOR Robert Krimen, "" BUGS Please report any bugs or feature requests to "bug-path-mapper at rt.cpan.org", or through the web interface at . I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. SUPPORT You can find documentation for this module with the perldoc command. perldoc Path::Mapper You can also look for information at: * RT: CPAN's request tracker * AnnoCPAN: Annotated CPAN documentation * CPAN Ratings * Search CPAN ACKNOWLEDGEMENTS COPYRIGHT & LICENSE Copyright 2009 Robert Krimen, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.