arch::tarball(3pm) [debian man page]

Arch::Tarball(3pm)					User Contributed Perl Documentation					Arch::Tarball(3pm)

NAME

       Arch::Tarball - an interface to create and work with tarballs

SYNOPSIS

	   use Arch::Tarball

	   my $tarball = Arch::Tarball->new;
	   my $pipe = $tarball->create(
	       dir => '/path/to/subdir-to-pack',
	       base_name => 'new-subdir-to-pack',
	       pipe => 1,
	   );

DESCRIPTION

       Arch::Tarball provides an object oriented interface to work with (create, examine or extract) standard gzipped tarballs.

       Note: As functionality is added only when needed, a lot of features are currently not implemented.

METHODS

       The following functions are available:

       new, create, extract, list.

       new %opts
	   Creates a new Arch::Tarball object.

	   The following parameters can be set via %opts:

	   tar The name of the tar executable. Defaults to "tar".

	   file
	       The filename of the Tarball.

       create %opts
	   Creates a new tarball (tar.gz) from a given directory structure.

	   create understands the following options:

	   dir (mandatory)
	       Specifies the base directory for the tarball. The given directory and recursively its content will be added to the tarball. The
	       directory's basename will be used as the first and the only subdirectory in the tarball.

	   base_name
	       Allow the programmer to specify a different base directory name for the tarball content than the basename of dir. In this case,
	       'cp' process is launched to temporarily rename the last element of dir.

	   pipe
	       When set, create does not create a physical tarball but writes the tarballs content to a newly created pipe. The pipe is returned
	       by the create method.

	   Note: Currently the pipe option is mandatory.

       extract %opts
	   Extracts the tarball to a given target directory, specified by dir option.  If dir option is not given, a temporary directory is
	   created that will hold the extracted dirs/files. This directory is returned.

	   The file option specifies the tarball file name. It may be given in the constructor instead.

       list %opts (not implemented yet)
	   Returns a list of files and directories in the tarball.

BUGS

       Most functionality is currently not implemented. If you need part of the missing functionality, please contact the authors.

       Patches are greatly appreciated.

AUTHORS

       Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).

       Enno Cramer (uebergeek@web.de--2003/arch-perl--devel).

perl v5.10.1							    2005-04-22							Arch::Tarball(3pm)

Arch::Test::Tree(3pm)					User Contributed Perl Documentation				     Arch::Test::Tree(3pm)

NAME

       Arch::Test::Tree - A test framework for Arch-Perl

SYNOPSIS

	   use Arch::Test::Framework;

	   my $fw = Arch::Test::Framework->new;
	   my $tree = $fw->make_tree($dir, $version);

	   my $dir = $tree->add_dir;
	   $tree->add_file($dir);
	   $tree->import;

DESCRIPTION

       Arch::Test::Tree provides methods to quickly build and modify Arch project trees within the Arch::Test framework.

METHODS

       new, root, framework, run_tla, add_file, add_dir, add_link, modify_file, rename_file, rename_dir, remove_file, remove_dir, inventory,
       import, commit.

       new [framework] [path]
	   Create a new Arch::Test::Tree instance for path. This method should not be called directly.

       root
	   Returns the project trees root directory.

       framework
	   Returns the associated Arch::Test::Framework reference.

       run_tla @args
	   Run "tla @args" from the tree root.

       add_file [dir [name [content]]]
	   Add a new file name in directory dir. Fill file with content.

	   dir defaults to the project root ("."). If name is not specified, a unique filename is generated. A default content is generated if
	   none is given.

       add_dir [parent [name]]
	   Add a new directory under parent, or "." if parent is not specified. If name is not given, a unique name is generated.

       add_link [parent [name [target]]]
	   Add a new symbolic link under parent, or "." if parent is not specified. If name is not given, a unique name is generated. If target is
	   omitted, a (probably) non-existing target is generated.

       modify_file file [content]
	   Change files content to content, or append "Has been modified."  if new content is omitted.

       rename_file old new
	   Rename file old to new. Returns new.

       rename_dir old new
	   Rename directory old to new. Returns new.

       remove_file file
	   Delete file and its associated arch id.

       remove_dir dir
	   Recursively delete dir and its content.

       inventory [flags]
	   Returns the inventory as generated by running "tla inventory flags". flags default to "-Bs" if not specified.

       import [summary [log]]
	   Create a "base-0" revision from tree using the summary line summary and log as log text. If tree contains a log file, summary and log
	   can be omitted.

       commit [summary [log]]
	   Commit a "patch-n" revision from tree using the summary line summary and log as log text. If tree contains a log file, summary and log
	   can be omitted.

AUTHORS

       Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).

       Enno Cramer (uebergeek@web.de--2003/arch-perl--devel).

perl v5.10.1							    2005-04-14						     Arch::Test::Tree(3pm)