TITLE PAGE

Detailed Software Test Description (STD)

for

Perl File::PM2File Program Module

Revision: -

Version: 

Date: 2004/04/08

Prepared for: General Public 

Prepared by:  http://www.SoftwareDiamonds.com support@SoftwareDiamonds.com

Classification: None

SCOPE

This detail STD and the General Perl Program Module (PM) STD establishes the tests to verify the requirements of Perl Program Module (PM) File::PM2File

The format of this STD is a tailored 2167A STD DID. in accordance with Detail STD Format.

####### # # 4. TEST DESCRIPTIONS # # 4.1 Test 001 # # .. # # 4.x Test x # #

TEST DESCRIPTIONS

The test descriptions uses a legend to identify different aspects of a test description in accordance with STD FormDB Test Description Fields.

Test Plan

T: 5^

ok: 1

 C:
    use File::Spec;
    use File::Package;
    my $fp = 'File::Package';
    my $uut = 'File::PM2File';
    my $loaded = '';
    # Use the test file as an example since no its absolue path
    # Calculate the absolute file, relative file, and include directory
    my $relative_file = File::Spec->catfile('t', 'File', 'PM2File.pm'); 
    my $restore_dir = cwd();
    chdir File::Spec->updir();
    chdir File::Spec->updir();
    my $include_dir = cwd();
    chdir $restore_dir;
    my $OS = $^^O;  # need to escape ^^
    unless ($OS) {   # on some perls $^^O is not defined
        require Config;
        $OS = $Config::Config{'osname'};
    } 
    $include_dir =~ s=/=\\=g if( $^^O eq 'MSWin32');
    my $absolute_file = File::Spec->catfile($include_dir, 't', 'File', 'PM2File.pm');
    $absolute_file =~ s=.t$=.pm=;
    # Put base directory as the first in the @INC path
    my @restore_inc = @INC;
    unshift @INC, $include_dir;
^
VO: ^
 N: UUT not loaded^
 A: $loaded = $fp->is_package_loaded('File::PM2File')^
 E:  ''^
ok: 1^

ok: 2

 N: Load UUT^
 S: $loaded^
 A: my $errors = $fp->load_package( 'File::PM2File' )^
SE: ''^
ok: 2^

ok: 3

 N: pm2require^
 A: $uut->pm2require( "$uut")^
 E: File::Spec->catfile('File', 'PM2File' . '.pm')^
ok: 3^

ok: 4

 N: find_in_include^
 A: [my @actual =  $uut->find_in_include( $relative_file )]^
 E: [$absolute_file, $include_dir]^
ok: 4^

ok: 5

 N: pm2file^
 A: [@actual = $uut->pm2file( 't::File::PM2File' )]^
 E: [$absolute_file, $include_dir, $relative_file]^
ok: 5^

####### # # 5. REQUIREMENTS TRACEABILITY # #

REQUIREMENTS TRACEABILITY

 Requirement                                                      Test
---------------------------------------------------------------- ----------------------------------------------------------------


 Test                                                             Requirement
---------------------------------------------------------------- ----------------------------------------------------------------

NOTES

copyright © 2003 Software Diamonds.

Software Diamonds permits the redistribution and use in source and binary forms, with or without modification, provided that the following conditions are met:

/=over 4

/=item 1

Redistributions of source code, modified or unmodified must retain the above copyright notice, this list of conditions and the following disclaimer.

/=item 2

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

/=back

SOFTWARE DIAMONDS, http://www.SoftwareDiamonds.com, PROVIDES THIS SOFTWARE 'AS IS' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SOFTWARE DIAMONDS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING USE OF THIS SOFTWARE, EVEN IF ADVISED OF NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE POSSIBILITY OF SUCH DAMAGE.

####### # # 2. REFERENCED DOCUMENTS # # #

SEE ALSO

File::PM2File






2 POD Errors

The following errors were encountered while parsing the POD:

Around line 177:

Non-ASCII character seen before =encoding in '©'. Assuming CP1252

Around line 231:

=back without =over