Config::Find::Where (3pm)

  use Config::Find::Where;

  my $temp_dir=Config::Find::Where->temp_dir( name => 'my_app',
                                              scope => 'process',
                                              create => 1 );

  my $path=Config::Find::Where->bin_dir( scope => 'app' );
  system $path."/app_helper.exe";

Config::Find searches for locations using \s-1OS\s0 dependent heuristics.

After releasing Config::Find I found much of its code could be reused to also find other interesting things like temporary directories, the script location, etc.

This module adds a public \s-1API\s0 to all the hiden functionality.

\s-1OPTIONS\s0

As in Config::Find, all the methods in this package accept a common set of options: specifies the primary application name used to generate the location paths or to search for them. -

create => 1

creates any unexistant directory in the path returned

\s-1METHODS\s0

All the methods in this package are class methods (you don't need an object to call them). returns a directory path inside a system temporary location. i.e.: Config::Find::Where->temp_dir( name =>'hello/world', scope => 'process', create => 1 ) returns something similar to '/tmp/jacks/hello/974/world/' on unix like systems and 'C:\Windows\Temp\jacks\hello\974\world' on some Windows ones ('jacks' is supposed to be the current user name and '974' the process number). The default scope for this method is \*(C`user\*(C'. returns a place to find/place binary files. The default scope for this method is \*(C`app\*(C'. i.e. Config::Find::Where->bin_dir() returns the path to the directory where binaries are located. Note that this directory is not necessarily the same as the one containing the running script. See documentation for \*(C`script_dir\*(C' below. returns a place to find/place working files. The default scope for this method is \*(C`app\*(C'. returns a place to find/place library files. The default scope for this method is \*(C`app\*(C'. For instance: use lib => Config::Find::Where->lib_dir; returns the application root directory. returns the name of the running script without any path information returns the name of the script as the absolute full path to it. returns the name of the directory containing the current script

Config::Find::Where->create_dir($dir)

creates directory $dir and any needed parents

Config::Find::Where->create_parent_dir($file)

recursively creates all the non existant parent dirs for $file.

\s-1EXPORT\s0

None, this module has an \s-1OO\s0 interface.

Some Win32 OSs are not completely implemented and default to inferior modes, but hey, this is a work in progress!!!

Contributions, bug reports, feedback and any kind of comments are welcome.

Config::Find

Copyright 2003-2008 by Salvador Fandin\*~o Garci\*'a ([email protected])

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