Arch::Test::Tree.3pm

Langue: en

Version: 2005-04-16 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

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