Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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)

Check Out this Related Man Page

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

NAME

       Arch::Changes - class representing a list of changes

SYNOPSIS

	   use Arch::Changes qw(:type);

	   use Arch::Tree;
	   my $changes = $tree->get_changes;
	   print $changes->get_listing;

	   use Arch::Log;
	   my $changed = $log->get_changes->is_changed('to', "COPYING");
	   die "License was compromised" if $changed && $changed->{&MODIFY};

DESCRIPTION

       Arch::Changes contains a list of elements, each representing a single tree change. Each change element is described by a hash with the
       following fields:

       type
	   The type of the change. Can be one of ADD, DELETE, MODIFY, META_MODIFY or RENAME.

       is_dir
	   A boolean value indicating whether the affected tree element is a directory.

       arguments
	   A list of arguments. The first element is always relative path of the affected tree element. For changes of type RENAME the first
	   argument is the old path and the second argument the new path name.

       The type constants can be conveniently imported using the tag ":type".

	   use Arch::Changes qw(:type);

METHODS

       The following methods are available:

       new, add, count, get, get_listing, is_changed, dump, type_string, to_string.

       new Creates a new, initially empty, changes list.

	   Typically it is called indirectly from method get_changes in Arch::Changeset, Arch::Tree or Arch::Log class.

       add type is_dir arguments...
	   Adds a new change element to the list of changes.

	   Typically it is called indirectly from method get_changes in Arch::Changeset, Arch::Tree or Arch::Log class.

       count
	   Returns the number of change elements.

       get num
	   Returns the num-th change element or all if num is undefined.

       get_listing
	   Generates a textual changes listing as produced by "tla changes".

       is_changed to filepath [is_dir]
	   Verify whether the given filepath is modified by the changes. The to parameter may get boolean values "0", "1", "from" or "to", it only
	   affects RENAME changes, and in some sense ADD and DELETE changes. If to is set, then the given filepath is taken as the destination of
	   RENAME or ADD, otherwise as the source of RENAME or DELETE. The MODIFY and META_MODIFY changes are not affected, since the destination
	   and the source is the same file/dir.

	   If filepath is not modified by any changes, return undef.

	   Otherwise, return hash with possible keys ADD, DELETE, MODIFY, META_MODIFY and RENAME. The hash values are 1 in all cases except for
	   RENAME, then the value is the file name on the opposite side (i.e., the source of RENAME if to is true, and the destination if false).

	   Note, the valid return values for arch are: undef, hashref with one key (ADD or DELETE) or hashref with combination of one-to-three
	   keys (MODIFY, META_MODIFY and RENAME).

       dump
	   Generates a dump of the changes list using Data::Dumper.

       type_string change
	   Returns the change type string as produced by "tla changes".

       to_string change
	   Generates a changes line for change as produced by "tla changes".

BUGS

       Awaiting for your reports.

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::Changeset, Arch::Tree, Arch::Log.

perl v5.10.1							    2005-10-23							Arch::Changes(3pm)
Man Page