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

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

NAME

       Arch::TempFiles - help to manage temporary files/dirs

SYNOPSIS

	   use Arch::TempFiles qw(temp_file_name temp_file temp_dir);
	   # all will be removed automatically on the script completion
	   my $file_name1 = temp_file();
	   my $file_name2 = temp_file_name("status");
	   my $dir_name = temp_dir("arch-tree");

	   use Arch::TempFiles;
	   my $tmp = new Arch::TempFiles;
	   $tmp->root($tmp->dir);
	   my $file_name = $tmp->name;
	   open OUT, ">$file_name";
	   close OUT;

DESCRIPTION

       This module deals with temporary file names. It is similar to File::Temp, but simplier and more focused. Also, File::Temp is relatively new
       and was not shipped with older perl versions.

       Both function interface and object oriented interface are supported.

FUNCTIONS
/METHODS
       The following functions are available:

       temp_root, temp_name, temp_file_name, temp_dir_name, temp_file, temp_dir.

       The corresponding class methods are available too:

       root, name, file_name, dir_name, file, dir.

       temp_root [dir]
       $tmp->root [dir]
	   Change or return the root of the temporary files and dirs. The default is either $ENV{TMP_DIR} or "/tmp".

       temp_name [label]
       $tmp->name [label]
	   Return the unused temporary file name. The default file name is "/tmp/,,arch-XXXXXX" where XXXXXX is a random number. To change this
	   name use "temp_root" and/or provide label that replaces "arch".

	   Please note, that the operation of acquiring the file name using this function/method and actual creating of this file is not atomic.
	   So you may need to call this method again if the creation is failed, for example if some other process created the same file in the
	   middle.

       temp_file_name [label]
       $tmp->file_name [label]
	   Like "temp_name", but stores the name in the file list that will be removed on the end (on object destruction).

       temp_dir_name [label]
       $tmp->dir_name [label]
	   Like "temp_name", but stores the name in the dir list that will be removed on the end (on object destruction).

       temp_file [label]
       $tmp->file [label]
	   Like "temp_file_name", but also creates the file.

       temp_dir [label]
       $tmp->dir [label]
	   Like "temp_dir_name", but also creates the dir.

BUGS

       Awaiting for your reports.

AUTHORS

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

SEE ALSO

       For a different interface, see File::Temp.

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

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

NAME

       Arch::Changeset - class representing Arch changeset

SYNOPSIS

       Arch::Changeset objects may be created directly if you got a changeset directory:

	   use Arch::Changeset;
	   my $changeset = Arch::Changeset->new(
	       'migo@homemail.com--Perl-GPL/arch-perl--devel--0--patch-6',
	       '/tmp/,,changeset-6',
	   );

       But often are created indirectly by other objects:

	   use Arch::Session;
	   $changeset = Arch::Session->new->get_revision_changeset(
	       'migo@homemail.com--Perl-GPL/arch-perl--devel--0--patch-6'
	   );

	   use Arch::Library;
	   $changeset = Arch::Library->new->get_revision_changeset(
	       'migo@homemail.com--Perl-GPL/arch-perl--devel--0--patch-6'
	   );

	   print scalar $changeset->get_patch("perllib/Arch/Changeset.pm");

	   my $diff_file = ($changeset->get_patch("README", 1))[2];
	   print Arch::Util::load_file($diff_file);

DESCRIPTION

       This class represents the changeset concept in Arch and provides some useful methods.

METHODS

       The following methods are available:

       new, get_patch, get_index, get_changes, get_all_diffs, join_all_diffs, ancestor.

       new revision-spec dir-name
	   Construct the Arch::Changeset object associated with the given fully-qualified revision-spec and the existing directory dir-name.

       get_patch file-path
       get_patch file-path type
       get_patch file-path type full-file-asis
	   Return the patch (or otherwise content) of the given file-path in the changeset.

	   type is integer: 0 (unknown, try to autodetect, this is the default), 1 (modified file, or metadata change), 2 (new file), 3 (removed
	   file).

	   The default behaviour is to create a fake diff against /dev/null for non-binary new and removed files; the full-file-asis flag, if set
	   to true, changes this behaviour and causes to return the content of such file as-is. Binary new and removed files are always returned
	   as-is regardless of the flag. This flag is also ignored if type is 1.

	   In the scalar content return the patch in diff(1) format (or the whole file content as described above). In the list content return 4
	   scalars: the patch, the file name on the disk containing this patch (or the whole file), the change type (that is "patch", "new" or
	   "removed") and the as-is flag.

	   The returned values that follow the first one (the patch/file content) share the order of the corresponding parameters; the parameters
	   are more hints, while the returned values accurately describe the content.

       get_index name
	   Returns the content of the index file name as an ID => path hash.

	   Valid names are 'orig-dirs-index', 'orig-files-index', 'mod-dirs-index' and 'mod-files-index'.

       get_changes
	   Returns a list of changes in the changeset.

       get_all_diffs
	   Returns all diffs in the changeset (array or arrayref). This includes changes of types MODIFY, ADD and DELETE.

       join_all_diffs
	   Returns concatenated output of all diffs in the changeset.

       ancestor
	   Return the ancestor of the changeset. If =ancestor file is found (that is the case for library changesets) its content is returned,
	   otherwise try to guess the ancestor of the revision using Arch::Util::adjacent_revision.

BUGS

       Awaiting for your reports.

AUTHORS

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

SEE ALSO

       For more information, see tla, Arch::Session, Arch::Library, Arch::Util.

perl v5.10.1							    2006-04-15						      Arch::Changeset(3pm)