summaryrefslogtreecommitdiff
path: root/lib/blib.pm
diff options
context:
space:
mode:
authorChip Salzenberg <chip@atlantic.net>1996-11-26 20:48:00 +1200
committerChip Salzenberg <chip@atlantic.net>1996-11-26 20:48:00 +1200
commit49624702b850ce75f102fc7902be1ca451941985 (patch)
tree2c7981762ceceb33181fd1403b1a3aa9180a1c9f /lib/blib.pm
parent93be69de7b7f75290f584f5b2d24cdcf0dd72c74 (diff)
downloadperl-49624702b850ce75f102fc7902be1ca451941985.tar.gz
Re: blib
(this is the same change as commit be9cdb876bca65c372096fa7626a5a9897471b1d, but as applied)
Diffstat (limited to 'lib/blib.pm')
-rw-r--r--lib/blib.pm71
1 files changed, 71 insertions, 0 deletions
diff --git a/lib/blib.pm b/lib/blib.pm
new file mode 100644
index 0000000000..4d8f609b52
--- /dev/null
+++ b/lib/blib.pm
@@ -0,0 +1,71 @@
+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
+arbitary 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;
+
+warn __FILE__;
+
+sub import
+{
+ my $package = shift;
+ my $dir = getcwd;
+ if (@_)
+ {
+ print join(',',@_),"\n";
+ $dir = shift;
+ $dir =~ s/blib$//;
+ $dir =~ s,/+$,,;
+ $dir = '.' unless ($dir);
+ die "$dir is not a directory\n" unless (-d $dir);
+ }
+ my $i = 5;
+ while ($i--)
+ {
+ my $blib = "${dir}/blib";
+ if (-d $blib && -d "$blib/arch" && -d "$blib/lib")
+ {
+ unshift(@INC,"$blib/arch","$blib/lib");
+ warn "Using $blib";
+ return;
+ }
+ $dir .= "/..";
+ }
+ die "Cannot find blib even in $dir\n";
+}
+
+1;