NAME

TAP::DOM::Archive - Handle TAP:Archive files

SYNOPSIS

# Create a DOM from TAP archive file
use TAP::DOM::Archive;
my $tapdom = TAP::DOM::Archive->new( source => $taparchive_filename );
my $tapdom = TAP::DOM::Archive->new( source => $taparchive_filehandle );
print Dumper($tapdom);

DESCRIPTION

This is a frontend to TAP::DOM which handles TAP::Archive files. It reads the archive file and returns an array of TAP::DOMs.

Super DOM

The resulting TAP::DOM::Archive data structure looks like this:

$VAR1 = bless( {
                 'meta' => {
                             'file_order' => [
                                               't/some-test.t',
                                               # ... more ...
                                             ],
                             'file_attributes' => [
                                                  {
                                                    'end_time' => '1288275207.07508',
                                                    'start_time' => '1288275206.97027',
                                                    'description' => 't/some-test.t'
                                                  },
                                                  # ... more ...
                                                ],
                             'start_time' => '1288275206',
                             'stop_time' => '1288275207',
                           },
                 'dom' => [
                            bless( {...}, 'TAP::DOM' ),
                            bless( {...}, 'TAP::DOM' ),
                            # ... more ...
                          ],

METHODS

new

Constructor which immediately triggers reading the TAP archive file and parsing its contained TAP files via TAP::Parser. It returns an array of the extracted TAP::DOMs.

All parameters are passed through to TAP::DOM, except source which specifies the file to parse and tap which is ignored.

AUTHOR

Steffen Schwigon <ss5@renormalist.net>

COPYRIGHT AND LICENSE

This software is copyright (c) 2023 by Steffen Schwigon.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.