arch::log(3pm) [debian man page]
Arch::Log(3pm) User Contributed Perl Documentation Arch::Log(3pm) NAME
Arch::Log - class representing Arch patch-log SYNOPSIS
use Arch::Log; my $log = Arch::Log->new($rfc2822_message_string); printf "Patch log date: %s ", $log->header('standard_date'); print $log->dump; my $first_new_file = $log->get_headers->{new_files}->[0]; DESCRIPTION
This class represents the patch-log concept in Arch and provides some useful methods. METHODS
The following class methods are available: get_message, get_headers, header, get_changes, split_version, get_version, get_revision, get_revision_kind, get_revision_desc, dump. get_message Return the original message with that the object was constructed. get_headers Return the hashref of all headers including body, see also "header" method. header name header name [new_value] Get or set the named header. The special name 'body' represents the message body (the text following the headers). body [new_value] existing_header_name [new_value] This is just a shortcut for "header"('method'). However unlike "header"('method'), method fails instead of returning undef if the log does not have the given header name. get_changes Return a list of changes in the corresponding changeset. ATTENTION! Patch logs do not distinguish metadata (ie permission) changes from ordinary content changes. Permission changes will be represented with a change type of 'M'. This is different from Arch::Changeset::get_changes and Arch::Tree::get_changes. split_version Return a list of 2 strings: full version and patch-level. get_version Return the full version name, not unlike split_version. get_revision Return the full revision name. This is currently a concatination of headers Archive and Revision with '/' separator. get_revision_kind Return one of the strings 'tag', 'import' or 'cset' depending on the revision kind this log represents. get_revision_desc Return revision description hashref with the keys: name, version, summary, creator, email, date, kind. dump Returns the object dump using Data::Dumper. 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::Changes. perl v5.10.1 2005-11-14 Arch::Log(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)