NAME

Meta::Archive::Tar - extended Archive::Tar class.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.

DETAILS

        MANIFEST: Tar.pm
        PROJECT: meta
        VERSION: 0.18

SYNOPSIS

        package foo;
        use Meta::Archive::Tar qw();
        my($object)=Meta::Archive::Tar->new();
        my($result)=$object->method();

DESCRIPTION

This class extends the Archive::Tar class. It adds services like adding a file under a different name, and adding a baseline relative file.

It also guards the user from adding the same file several times.

Currently, because of the underlying Archive::Tar implementation, only the gzip mode is supported.

FUNCTIONS

        BEGIN()
        new($)
        add_data($$$)
        add_file($$$)
        add_deve($$$)
        add_modu($$$)
        write($$)
        TEST($)

FUNCTION DOCUMENTATION

BEGIN()

Setup method for this class which sets up get/set methods for the following attributes: type - type of archive (gzip,zip,bzip2). uname - user name under which the archive will be created. gname - group name under which the archive will be created.

new($)

This is a constructor for the Meta::Archive::Tar object.

add_data($$$)

This method overrides the default add_data since the default method does not handle empty data well (it does not put them in the archive and I written that as a bug to mail the author).

add_file($$$)

This method will add a file you specify under the name you specify.

add_deve($$$)

This method will add a file relative to the baseline. Parameters are: 0. Meta::Archive::Tar object handle. 1. name under which to store the file. 2. file name relative to the baseline root.

add_modu($$$)

This method will add a module to the baseline. Parameters are: 0. Meta::Archive::Tar object handle. 1. name under which to store the file. 2. Meta::Development::Module module.

write($$)

This method will write the archive. This method overrides the Archive::Tar method by the same name because that method passes the gzip compression factor in the activation too (which I think is bad practice).

TEST($)

This is a test suite for the Meta::Archive::Tar package. Currently it just creates an archive with some data.

SUPER CLASSES

Archive::Tar(3)

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV perl packaging
        0.01 MV validate writing
        0.02 MV PDMT
        0.03 MV fix database problems
        0.04 MV md5 project
        0.05 MV database
        0.06 MV perl module versions in files
        0.07 MV movies and small fixes
        0.08 MV thumbnail user interface
        0.09 MV import tests
        0.10 MV more thumbnail issues
        0.11 MV website construction
        0.12 MV web site development
        0.13 MV web site automation
        0.14 MV SEE ALSO section fix
        0.15 MV move tests to modules
        0.16 MV finish papers
        0.17 MV teachers project
        0.18 MV md5 issues

SEE ALSO

Archive::Tar(3), Meta::Baseline::Aegis(3), Meta::Class::MethodMaker(3), Meta::Ds::Set(3), Meta::Utils::File::File(3), Meta::Utils::File::Remove(3), Meta::Utils::Output(3), Meta::Utils::System(3), Meta::Utils::Utils(3), strict(3)

TODO

-once the author of Archive::Tar gets ridd of the bug where empty data files could not be created then fix the code here.

-add method to add a files under the same name as the addition (bypass the load mechanism).

cpanm Meta::Init

perl -MCPAN -e shell
install Meta::Init