App::KGB::Change(3pm)					User Contributed Perl Documentation				     App::KGB::Change(3pm)

NAME

       App::KGB::Change - a single file change

SYNOPSIS

	   my $c = App::KGB::Change->new(
	       { action => "M", prop_change => 1, path => "/there" } );

	   print $c;

	   my $c = App::KGB::Change->new("(M+)/there");

DESCRIPTION

       App::KGB::Change encapsulates a single path change from a given change set (or commit).

       App::KGB::Change overloads the "" operator in order to provide a default string representation of changes.

FIELDS

       action (mandatory)
	   The action performed on the item. Possible values are:

	   M   The path was modified.

	   A   The path was added.

	   D   The path was deleted.

	   R   The path was replaced.

       path (mandatory)
	   The path that was changed.

       prop_change
	   Boolean. Indicated that some properties of the path, not the content were changed.

CONSTRUCTOR

   new ( { initial values } )
       More-or-less standard constructor.

       It can take a hashref with keys all the field names (See ).

       Or, it can take a single string, which is de-composed into components.

       See  for examples.

METHODS

       as_string()
	   Return a string representation of the change. Used by the ""  overload. The resulting string is suitable for feeding the  constructor
	   if needed.

CLASS METHODS

       detect_common_dir("changes")
	   Given an arrayref of changes (instances of APP::KGB::Change), detects the longest path that is common to all of them. All the changes'
	   paths are trimmed from the common part.

	   Example:

	    foo/b
	    foo/x
	    foo/bar/a

	   would return 'foo' and the paths would be trimmed to

	    b
	    x
	    bar/a

perl v5.12.4							    2011-09-15						     App::KGB::Change(3pm)