mirror of
https://github.com/AdaCore/git-hooks.git
synced 2026-02-12 12:43:11 -08:00
4106237e97
When a project's hooks.mailinglist configuration is the name of a script, the call to that script now includes the name of the reference being updated as the first (and so far only) command-line argument. This allows these projects to have different mailing list addresses depending on the name of the reference being updated. Change-Id: Idc920357023c2b5ec7b3b4d755e298a0f0b83bf0 TN: T209-008
75 lines
2.8 KiB
Python
75 lines
2.8 KiB
Python
"""Handling of the hooks.mailinglist config...
|
|
"""
|
|
from config import git_config
|
|
import os
|
|
from subprocess import Popen, PIPE
|
|
from utils import warn
|
|
|
|
|
|
def is_mailinglist_script(name):
|
|
"""Return true if the given hooks.mailinglist entry is a script...
|
|
|
|
... rather than an email address.
|
|
|
|
PARAMETERS
|
|
name: A string, containing one entry from the hooks.mailinglist
|
|
config.
|
|
"""
|
|
# By convention, we identify scripts as being absolute filenames
|
|
# that have enough permissions to execute.
|
|
return os.path.isabs(name) and os.access(name, os.R_OK and os.X_OK)
|
|
|
|
|
|
def get_emails_from_script(script_filename, ref_name, changed_files):
|
|
"""The list of emails addresses for the given list of changed files.
|
|
|
|
This list is obtained by running the given script, and passing it
|
|
the list of changed files via stdin (one file per line). By
|
|
convention, passing nothing via stdin (no file changed) should
|
|
trigger the script to return all email addresses.
|
|
|
|
PARAMETERS
|
|
ref_name: The name of the reference being updated.
|
|
script_filename: The name of the script to execute.
|
|
changed_files: A list of files to pass to the script (via stdin).
|
|
None is also accepted in place of an empty list.
|
|
"""
|
|
input_str = '' if changed_files is None else '\n'.join(changed_files)
|
|
|
|
p = Popen([script_filename, ref_name], stdin=PIPE, stdout=PIPE)
|
|
(output, _) = p.communicate(input=input_str)
|
|
if p.returncode != 0:
|
|
warn('!!! %s failed with error code: %d.'
|
|
% (script_filename, p.returncode))
|
|
return output.splitlines()
|
|
|
|
|
|
def expanded_mailing_list(ref_name, get_files_changed_cb):
|
|
"""Return the list of emails after expanding the hooks.mailinglist config.
|
|
|
|
This function iterates over all entries in hooks.mailinglist, and
|
|
replaces all entries which are a script by the result of calling
|
|
that script with the list of changed files.
|
|
|
|
PARAMETERS
|
|
ref_name: The name of the reference being updated.
|
|
get_files_changed_cb: A function to call in order to get
|
|
the list of files changed, to be passed to mailinglist
|
|
scripts. This is a function rather than a list to allow
|
|
us to compute that list of files only if needed.
|
|
None for no file changed.
|
|
"""
|
|
result = []
|
|
files_changed = () if get_files_changed_cb is None else None
|
|
|
|
for entry in git_config('hooks.mailinglist'):
|
|
if is_mailinglist_script(entry):
|
|
if files_changed is None:
|
|
files_changed = get_files_changed_cb()
|
|
result.extend(get_emails_from_script(entry,
|
|
ref_name,
|
|
files_changed))
|
|
else:
|
|
result.append(entry)
|
|
return result
|