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).