NAME

Path::FindDev - Find a development path somewhere in an upper hierarchy.

VERSION

version v0.5.3

DESCRIPTION

This package is mostly a glue layer around Path::IsDev with a few directory walking tricks.

            

              
              
use Path::FindDev qw( find_dev );
if ( my $root = find_dev('/some/path/to/something/somewhere')) {
    print "development root = $root";
} else {
    print "No development root :(";
}
            
          

FUNCTIONS

find_dev

            

              
              
my $result = find_dev('/some/path');
            
          

If a dev directory is found at, or above, /some/path, it will be returned as a Path::Tiny

If you pass configurations to import:

            

              
              
use Path::FindDev find_dev => { set => $someset };
            
          

Then the exported find_dev will pass that set name to Path::IsDev.

Though you should only do this if

• the default set is inadequate for your usage

• you don't want the set to be overridden by %ENV

Additionally, you can call find_dev directly:

            

              
              
require Path::FindDev;
my $result = Path::FindDev::find_dev('/some/path');
            
          

Which by design inhibits your capacity to specify an alternative set in code.

EXAMPLE USE-CASES

Have you ever found yourself doing

            

              
              
use FindBin;
use lib "$FindBin::Bin/../../../tlib"
            
          

In a test?

Have you found yourself paranoid of file-system semantics and tried

            

              
              
use FindBin;
use Path::Tiny qw(path)
use lib path($FindBin::Bin)->parent->parent->parent->child('tlib')->stringify;
            
          

Have you ever done either of the above in a test, only to find you've needed to move the test to a deeper hierarchy, and thus, need to re-write all your path resolution?

Have you ever had this problem for multiple files?

No more!

            

              
              
use FindBin;
use Path::FindDev qw(find_dev);
use lib find_dev($FindBin::Bin)->child('t','tlib')->stringify;
            
          

^ Should work, regardless of which test you put it in, and regardless of what $CWD happens to be when you call it.

AUTHOR

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Kent Fredric <kentfredric@gmail.com>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.