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)