ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / share / perl5

package blib;

=head1 NAME

blib - Use MakeMaker's uninstalled version of a package

=head1 SYNOPSIS

perl -Mblib script [args...]

perl -Mblib=dir script [args...]

=head1 DESCRIPTION

Looks for MakeMaker-like I<'blib'> directory structure starting in
I<dir> (or current directory) and working back up to five levels of '..'.

Intended for use on command line with B<-M> option as a way of testing
arbitrary scripts against an uninstalled version of a package.

However it is possible to :

use blib;
 or
 use blib '..';

etc. if you really must.

=head1 BUGS

Pollutes global name space for development only task.

=head1 AUTHOR

Nick Ing-Simmons nik@tiuk.ti.com

=cut

use Cwd;
use File::Spec;

use vars qw($VERSION $Verbose);
$VERSION = '1.06';
$Verbose = 0;

sub import
{
 my $package = shift;
 my $dir;
 if ($^O eq "MSWin32" && -f "Win32.xs") {
     # We don't use getcwd() on Windows because it will internally
     # call Win32::GetCwd(), which will get the Win32 module loaded.
     # That means that it would not be possible to run `make test`
     # for the Win32 module because blib.pm would always load the
     # installed version before @INC gets updated with the blib path.
     chomp($dir = `cd`);
 }
 else {
     $dir = getcwd;
 }
 if ($^O eq 'VMS') { ($dir = VMS::Filespec::unixify($dir)) =~ s-/\z--; }
 if (@_)
  {
   $dir = shift;
   $dir =~ s/blib\z//;
   $dir =~ s,/+\z,,;
   $dir = File::Spec->curdir unless ($dir);
   die "$dir is not a directory\n" unless (-d $dir);
  }

# detaint: if the user asked for blib, s/he presumably knew
 # what s/he wanted
 $dir = $1 if $dir =~ /^(.*)$/;

my $i = 5;
 my($blib, $blib_lib, $blib_arch);
 while ($i--)
  {
   $blib = File::Spec->catdir($dir, "blib");
   $blib_lib = File::Spec->catdir($blib, "lib");
   $blib_arch = File::Spec->catdir($blib, "arch");

if (-d $blib && -d $blib_arch && -d $blib_lib)
    {
     unshift(@INC,$blib_arch,$blib_lib);
     warn "Using $blib\n" if $Verbose;
     return;
    }
   $dir = File::Spec->catdir($dir, File::Spec->updir);
  }
 die "Cannot find blib even in $dir\n";
}

[-] AutoLoader.pm [edit]
[+] warnings
[+] Perl
[-] CORE.pod [edit]
[+] Compress
[-] fields.pm [edit]
[-] SelectSaver.pm [edit]
[+] vendor_perl
[-] DirHandle.pm [edit]
[-] Safe.pm [edit]
[+] HTTP
[+] B
[-] vmsish.pm [edit]
[+] Memoize
[-] SelfLoader.pm [edit]
[-] overloading.pm [edit]
[-] bigrat.pm [edit]
[+] Config
[-] bytes_heavy.pl [edit]
[+] ..
[+] IPC
[-] lwptut.pod [edit]
[+] File
[-] blib.pm [edit]
[-] strict.pm [edit]
[+] IO
[+] Net
[-] Memoize.pm [edit]
[+] DBM_Filter
[+] Version
[-] utf8_heavy.pl [edit]
[-] lwpcook.pod [edit]
[-] less.pm [edit]
[+] Pod
[+] Archive
[-] Symbol.pm [edit]
[+] Object
[-] utf8.pm [edit]
[-] XSLoader.pm [edit]
[-] CPAN.pm [edit]
[+] Tie
[-] deprecate.pm [edit]
[+] PerlIO
[-] if.pm [edit]
[+] pod
[-] diagnostics.pm [edit]
[-] subs.pm [edit]
[+] Encode
[+] Filter
[+] CPAN
[+] unicore
[+] Devel
[-] filetest.pm [edit]
[-] LWP.pm [edit]
[+] Unicode
[+] Test
[-] NEXT.pm [edit]
[-] sort.pm [edit]
[-] Test.pm [edit]
[+] Term
[+] overload
[-] FindBin.pm [edit]
[+] Attribute
[-] open.pm [edit]
[-] sigtrap.pm [edit]
[-] bignum.pm [edit]
[-] vars.pm [edit]
[-] AutoSplit.pm [edit]
[-] FileHandle.pm [edit]
[-] base.pm [edit]
[-] PerlIO.pm [edit]
[+] Time
[+] Text
[-] English.pm [edit]
[+] Getopt
[+] ExtUtils
[+] URI
[-] Benchmark.pm [edit]
[+] Package
[+] Thread
[-] DBM_Filter.pm [edit]
[-] _charnames.pm [edit]
[-] warnings.pm [edit]
[-] feature.pm [edit]
[+] LWP
[-] integer.pm [edit]
[+] Module
[+] encoding
[-] Thread.pm [edit]
[-] AnyDBM_File.pm [edit]
[+] User
[-] dumpvar.pl [edit]
[+] Log
[-] Dumpvalue.pm [edit]
[-] bigint.pm [edit]
[+] Search
[+] I18N
[+] Class
[-] URI.pm [edit]
[-] autouse.pm [edit]
[-] perlfaq.pm [edit]
[-] locale.pm [edit]
[-] bytes.pm [edit]
[+] Math
[-] DB.pm [edit]
[-] FileCache.pm [edit]
[+] JSON
[-] overload.pm [edit]
[-] charnames.pm [edit]
[+] App
[-] perl5db.pl [edit]
[+] Locale
[-] UNIVERSAL.pm [edit]