/ 
SVN-Notify-Filter-AuthZMail-1.01
River stage zero No dependents
/ SVN::Notify::Filter::AuthZMail

NAME

SVN::Notify::Filter::AuthZMail - Determines Subversion accounts to receive the email, via the AuthZSVNAccess file

VERSION

Version 1.01

SYNOPSIS

This is intended to work with SVN::Notify, as part of a subversion post-commit hook.

svnnotify --repos-path "$1" --revision "$2" ..etc..  \
          --filter AuthZMail                         \
                --authz_file /x/x/x/authz            \
                --authz_module yyy

DESCRIPTION

This module is a filter for SVN::Notify, intended to assist with the maintenance of access control lists with Subversion repositories. This module removes the need to maintain a separate list of people to send email notification messages to (via svnnotify --to arguments), from the AuthZSVNAccessFile.

Based upon the Subversion revision, it finds the files that were modified in the commit, determines the union of people that access to those files (via the AuthZ file), and passes those account names into the SVN::Notify. Hopefully, this module follows Subversion's rules for determining access.

This module works well with SVN::Notify::Filter::EmailFlatFileDB. If this filter is put first in the svnnotify argument list, it will add to the usernames to SVN::Notify's list of recipient names, and then the EmailFlatFileDB filter will convert those usernames into email addresses.

(Note that for SVN::Notify versions less than 2.76, you may need to include a --to option line in order to bypass some of SVN::Notify's checking.)

DEPENDENCIES

This module depends upon SVN::Notify, by David Wheeler. It also depends upon SVN::Access, by Michael Gregorowicz, to parse the AuthZ file.

FUNCTIONS

from

This SVN::Notify callback function is not used.

pre_prepare

This SVN::Notify callback function adds the usernames to the list, based on the contents of the authz file. This is executed automatically by the SVN::Notify framework. It will add to the list of recipients. Note that any other SVN::Notify::Filter that manipulates the list of recipients should be specified after this filter.

AUTHOR

Jeffrey Borlik, <jborlik at earthlink.net>

BUGS

Please report any bugs or feature requests to bug-svn-notify-filter-authzmail at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SVN-Notify-Filter-AuthZMail. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc SVN::Notify::Filter::AuthZMail

You can also look for information at:

ACKNOWLEDGEMENTS

Thanks to David Wheeler for his SVN::Notify Perl module. Also, thanks to Michael Gregorowicz for SVN::Access.

COPYRIGHT & LICENSE

Copyright 2008 Jeffrey Borlik, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.