/ 
SVN-Hooks-0.06.353
River stage zero No dependents
/ SVN::Hooks::Mailer

NAME

SVN::Hooks::Mailer - Send emails after succesful commits.

SYNOPSIS

This SVN::Hooks plugin sends notification emails after succesful commits. The emails contain information about the commit like this:

Subject: [TAG] Commit revision 153 by jsilva

Author:   jsilva
Revision: 153
Date:     2008-09-16 11:03:35 -0300 (Tue, 16 Sep 2008)
Added files:
    trunk/conf/svn-hooks.conf
Deleted files:
    trunk/conf/hooks.conf
Updated files:
    trunk/conf/passwd
Log Message:
    Setting up the conf directory.

It's active in the post-commit hook.

It's configured by the following directives.

EMAIL_CONFIG()

SVN::Hooks::Mailer uses Email::Send to send emails.

This directive allows you to chose a particular mailer to send email with.

EMAIL_CONFIG(Sendmail => '/usr/sbin/sendmail');
EMAIL_CONFIG(SMTP => 'smtp.example.com');
EMAIL_CONFIG(IO => '/path/to/file');

The first two are the most common. The last can be used for debugging.

EMAIL_COMMIT(HASH_REF)

This directive receives a hash-ref specifying the email that must be sent. The hash must contain the following key/value pairs:

match => qr/Regexp/

The email will be sent only if the Regexp matches at least one of the files changed in the commit. In its absense, the email will be sent always.

from => 'ADDRESS'

The email address that will be used in the From: header.

to => 'ADDRESS, ...'

The email addresses to which the email will be sent. This is required.

tag => 'STRING'

If present, the subject will be prefixed with '[STRING] '.

cc, bcc, reply_to => 'ADDRESS, ...'

These are optional.

AUTHOR

Gustavo Chaves, <gustavo+perl at gnustavo.com>

BUGS

Please report any bugs or feature requests to bug-svn-hooks-checkmimetypes 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.

SUPPORT

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

perldoc SVN::Hooks

You can also look for information at:

COPYRIGHT & LICENSE

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.