Mailing-List: contact test-cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: test-dev@httpd.apache.org
Date: 22 Jul 2003 11:21:37 -0000
Message-ID: <20030722112137.16648.qmail@icarus.apache.org>
From: stas@apache.org
To: httpd-test-cvs@apache.org
Subject: cvs commit: httpd-test/perl-framework/Apache-Test/lib/Apache
 TestRun.pm

stas        2003/07/22 04:21:37

  Modified:    perl-framework/Apache-Test/lib/Apache TestRun.pm
  Log:
  document the pre_configure() method
  
  Revision  Changes    Path
  1.113     +47 -0     httpd-test/perl-framework/Apache-Test/lib/Apache/TestRun.pm
  
  Index: TestRun.pm
  ===================================================================
  RCS file: /home/cvs/httpd-test/perl-framework/Apache-Test/lib/Apache/TestRun.pm,v
  retrieving revision 1.112
  retrieving revision 1.113
  diff -u -r1.112 -r1.113
  --- TestRun.pm	22 Jul 2003 11:06:18 -0000	1.112
  +++ TestRun.pm	22 Jul 2003 11:21:36 -0000	1.113
  @@ -918,3 +918,50 @@
   }
   
   1;
  +
  +__END__
  +
  +=head1 NAME
  +
  +Apache::TestRun - Run the test suite
  +
  +=head1 SYNOPSIS
  +
  +
  +=head1 DESCRIPTION
  +
  +The C<Apache::TestRun> package controls the configuration and running
  +of the test suite.
  +
  +=head1 METHODS
  +
  +Several methods are sub-classable, if the default behavior should be
  +changed.
  +
  +=head2 C<pre_configure>
  +
  +The C<pre_configure()> method is executed before the configuration for
  +C<Apache::Test> is generated. So if you need to adjust the setup
  +before I<httpd.conf> and other files are autogenerated, this is the
  +right place to do so.
  +
  +For example if you don't want to inherit a LoadModule directive for
  +I<mod_apreq.so> but to make sure that the local version is used, you
  +can sub-class C<Apache::TestRun> and override this method in
  +I<t/TEST.PL>:
  +
  +  package My::TestRun;
  +  use base 'Apache::TestRun';
  +  use Apache::TestConfig;
  +  __PACKAGE__->new->run(@ARGV);
  +  
  +  sub pre_configure {
  +      my $self = shift;
  +      # Don't load an installed mod_apreq
  +      Apache::TestConfig::autoconfig_skip_module_add('mod_apreq.c');
  +  }
  +
  +Notice that the extension is I<.c>, and not I<.so>.
  +
  +
  +=cut