Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

arch::test::tree(3pm) [debian man page]

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)

Check Out this Related Man Page

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

NAME

       Arch::Session - access arch archives

SYNOPSIS

	   use Arch::Session;

	   my $session = Arch::Session->new;

	   my $rev  = 'migo@homemail.com--Perl-GPL/arch-perl--devel--0--patch-1';
	   my $log  = $session->get_revision_log($rev);
	   my $cset = $session->get_revision_changeset($rev);
	   my $tree = $session->get_tree($rev);

DESCRIPTION

       Arch::Session provides an interface to access changesets and logs stored in arch archives.

METHODS

       The following common methods (inherited and pure virtual that this class implements) are documented in Arch::Storage:

       new, init, working_name, working_names, fixup_name_alias, is_archive_managed, expanded_revisions.

       archives, categories, branches, versions, revisions, get_revision_descs, expanded_archive_info, get_revision_changeset, get_changeset,
       get_revision_log, get_log.

       Additionally, the following methods are available:

       get_specified_changeset, clear_cache, get_tree, init_tree, my_id.

       get_specified_changeset arg
	   Get changeset object (Arch::Changeset) by a user specified input. arg may be revision name, or changeset directory, or tree directory
	   (then changeset for tree changes is constructed), and in the future local tarball filepath or remote tarball url.

       clear_cache [key ..]
	   For performance reasons, most method results are cached (memoized in fact).	Use this method to explicitly request this cache to be
	   cleared.

	   By default all cached keys are cleared; key may be one of the strings 'archives', 'categories', 'branches', 'versions', 'revisions' or
	   'revision_descs'.

       get_tree [{ options }] [revision [dir]]
	   Construct a working tree for revision or working_name in dir. If dir is not specified, a new temporary directory is automatically
	   created.

	   Keys of options may be pristine, link, library, sparse, non_sparse, no_greedy_add; all are false by default.  See "tla get".

       init_tree dir
	   Run "tla init-tree" in dir.

       my_id [newid]
	   Get or set "tla my-id".

BUGS

       No known bugs.

AUTHORS

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

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

SEE ALSO

       For more information, see tla, Arch::Storage, Arch::Library, Arch::Name, Arch::Log, Arch::Changeset.

perl v5.10.1							    2005-11-14							Arch::Session(3pm)
Man Page