[perl5.git] / lib / ExtUtils / testlib.pm

package ExtUtils::testlib;

use strict;
use warnings;

our $VERSION = 6.44;

use Cwd;
use File::Spec;

# So the tests can chdir around and not break @INC.
# We use getcwd() because otherwise rel2abs will blow up under taint
# mode pre-5.8.  We detaint is so @INC won't be tainted.  This is
# no worse, and probably better, than just shoving an untainted, 
# relative "blib/lib" onto @INC.
my $cwd;
BEGIN {
    ($cwd) = getcwd() =~ /(.*)/;
}
use lib map { File::Spec->rel2abs($_, $cwd) } qw(blib/arch blib/lib);
1;
__END__

=head1 NAME

ExtUtils::testlib - add blib/* directories to @INC

=head1 SYNOPSIS

  use ExtUtils::testlib;

=head1 DESCRIPTION

After an extension has been built and before it is installed it may be
desirable to test it bypassing C<make test>. By adding

    use ExtUtils::testlib;

to a test program the intermediate directories used by C<make> are
added to @INC.
Commit	Line	Data
b0c8af80	1	package ExtUtils::testlib;
1e65eb70 SP	2
1e65eb70 SP	3	use strict;
a592ba15	4	use warnings;
1e65eb70	5
3040be6a	6	our $VERSION = 6.44;
d713330a	7
9ce33444	8	use Cwd;
f6d6199c	9	use File::Spec;
9ce33444 MS	10
	11	# So the tests can chdir around and not break @INC.
	12	# We use getcwd() because otherwise rel2abs will blow up under taint
a67d7a01 MS	13	# mode pre-5.8. We detaint is so @INC won't be tainted. This is
	14	# no worse, and probably better, than just shoving an untainted,
	15	# relative "blib/lib" onto @INC.
	16	my $cwd;
	17	BEGIN {
	18	($cwd) = getcwd() =~ /(.*)/;
	19	}
a592ba15	20	use lib map { File::Spec->rel2abs($_, $cwd) } qw(blib/arch blib/lib);
b0c8af80	21	1;
	22	__END__
	23
	24	=head1 NAME
	25
	26	ExtUtils::testlib - add blib/* directories to @INC
	27
	28	=head1 SYNOPSIS
	29
39234879	30	use ExtUtils::testlib;
b0c8af80	31
	32	=head1 DESCRIPTION
	33
	34	After an extension has been built and before it is installed it may be
	35	desirable to test it bypassing C<make test>. By adding
	36
	37	use ExtUtils::testlib;
	38
	39	to a test program the intermediate directories used by C<make> are
	40	added to @INC.
	41