NAME

Archive::Builder::Archive - Archive abstraction handles

DESCRIPTION

Archive::Builder::Archive objects provide a type neutral handle for outputing the various archive file types the Archive::Builder manpage objects.

For more information on Archive::Builder objects, see it's POD documentation.

METHODS

`types()`

When loaded, Archive::Builder::Archive examines your system to determine which archive types it is capable of creating, based on dependencies.

The types method returns a list of types that are supported by your system.

new( type, Archive::Builder|Archive::Builder::Section )

Although obtained via the Archive::Builder and Archive::Builder::Section archive methods, archives can be created directly, by passing them a valid type and either an Archive::Builder or Archive::Builder::Section object.

`type()`

Returns the type of an Archive::Builder::Archive object.

`generate()`

Generates and returns the actual archive object, with will be an the Archive::Zip manpage, the Archive::Tar manpage, or whatever, depending on the type.

Returns undef if an error occurs during file generation, or archive generation.

save( filename )

Generates and saves the archive file to a specific filename. If the file name does NOT end in the file type you have specified, it will be appended for you.

That is, save('file') will result in the creation of file.zip for an archive of type 'zip'.

TODO

More Archive types, like rar.

SUPPORT

Contact the author

AUTHOR

        Adam Kennedy ( maintainer )
        cpan@ali.as
        http://ali.as/


=head1 SEE ALSO

the Archive::Builder manpage, the Archive::Builder::Generators manpage, the Archive::Tar manpage, the Archive::Zip manpage.

COPYRIGHT

The full text of the license can be found in the LICENSE file included with this module.

Archive::Builder::Archive - Archive abstraction handles