SVN::Look - A caching wrapper aroung the svnlook command.
Version 0.15
use SVN::Look;
my $revlook = SVN::Look->new('/repo/path', -r => 123);
my $author = $revlook->author();
my $msg = $revlook->log_msg();
my @added_files = $revlook->added();
my @updated_files = $revlook->updated();
my @deleted_files = $revlook->deleted();
my @changed_files = $revlook->changed();
my $file_contents = $revlook->cat('/path/to/file/in/repository');
my $trxlook = SVN::Look->new('/repo/path', -t => 123);
The svnlook command is the workhorse of Subversion hook scripts, being used to gather all sorts of information about a repository, its revisions, and its transactions. This script provides a simple object oriented interface to a specific svnlook invocation, to make it easier to hook writers to get and use the information they need. Moreover, all the information gathered buy calling the svnlook command is cached in the object, avoiding repetitious calls.
The SVN::Look constructor needs three arguments:
Returns the repository path that was passed to the constructor.
Returns the transaction number that was passed to the constructor. If none was passed, returns undef.
Returns the revision number that was passed to the constructor. If none was passed, returns undef.
Returns the author of the revision/transaction.
Returns the log message of the revision/transaction.
Returns the date of the revision/transaction.
Returns a reference to a hash containing the properties associated with PATH.
Returns a reference to a hash containing information about all file changes occurred in the revision. The hash always has the following pairs:
A list of files added in the revision.
A list of files deleted in the revision.
A list of files updated in the revision.
A list of files that had properties modified in the revision.
A hash mapping the old to the new name of each file moved in the revision.
Returns the list of files added in the revision/transaction.
Returns the list of files updated in the revision/transaction.
Returns the list of files deleted in the revision/transaction.
Returns the list of files that had properties modified in the revision/transaction.
Returns the list of all files added, updated, deleted, and the ones that had properties modified in the revision/transaction.
Returns the list of directories changed in the revision/transaction.
Returns the list of original names of files that were renamed in the revision/transaction.
Returns the list of new names of files that were renamed in the revision/transaction. The order of this list is guaranteed to agree with the order generated by the method copied_from.
Returns the contents of the file at PATH. In scalar context, return the whole contents in a single string. In list context returns a list of chomped lines.
Returns the GNU-style diffs of changed files and properties. There are three optional options that can be passed as strings:
--no-diff-deletedDo not print differences for deleted files
--no-diff-addedDo not print differences for added files.
--diff-copy-fromPrint differences against the copy source.
In scalar context, return the whole diff in a single string. In list context returns a list of chomped lines.
Gustavo Chaves, <gnustavo@cpan.org>
Please report any bugs or feature requests to bug-svn-look at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SVN-Hooks. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
perldoc SVN::Look
You can also look for information at:
Copyright 2008 CPqD, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
