tools/patman/gitutil.py

361 def build_email_list(in_list, tag=None, alias=None, warn_on_error=True):
374         alias:          Alias dictionary
375         warn_on_error: True to raise an error when an alias fails to match,
381     >>> alias = {}
382     >>> alias['fred'] = ['f.bloggs@napier.co.nz']
383     >>> alias['john'] = ['j.bloggs@napier.co.nz']
384     >>> alias['mary'] = ['Mary Poppins <m.poppins@cloud.net>']
385     >>> alias['boys'] = ['fred', ' john']
386     >>> alias['all'] = ['fred ', 'john', '   mary   ']
387     >>> build_email_list(['john', 'mary'], None, alias)
389     >>> build_email_list(['john', 'mary'], '--to', alias)
392     >>> build_email_list(['john', 'mary'], 'Cc', alias)
398         raw += lookup_email(item, alias, warn_on_error=warn_on_error)
436                   self_only=False, alias=None, in_reply_to=None, thread=False,
445         warn_on_error: True to print a warning when an alias fails to match,
463     >>> alias = {}
464     >>> alias['fred'] = ['f.bloggs@napier.co.nz']
465     >>> alias['john'] = ['j.bloggs@napier.co.nz']
466     >>> alias['mary'] = ['m.poppins@cloud.net']
467     >>> alias['boys'] = ['fred', ' john']
468     >>> alias['all'] = ['fred ', 'john', '   mary   ']
469     >>> alias[os.getenv('USER')] = ['this-is-me@me.com']
474             False, alias)
478             alias)
483             True, alias)
487             False, alias)
495     to = build_email_list(series.get('to'), '--to', alias, warn_on_error)
507                           '--cc', alias, warn_on_error)
510                               alias, warn_on_error)
532 def lookup_email(lookup_name, alias=None, warn_on_error=True, level=0):
533     """If an email address is an alias, look it up and return the full name
535     TODO: Why not just use git's own alias feature?
539         alias: Dictionary containing aliases (None to use settings default)
540         warn_on_error: True to print a warning when an alias fails to match,
548         OSError if a recursive alias reference was found
549         ValueError if an alias was not found
551     >>> alias = {}
552     >>> alias['fred'] = ['f.bloggs@napier.co.nz']
553     >>> alias['john'] = ['j.bloggs@napier.co.nz']
554     >>> alias['mary'] = ['m.poppins@cloud.net']
555     >>> alias['boys'] = ['fred', ' john', 'f.bloggs@napier.co.nz']
556     >>> alias['all'] = ['fred ', 'john', '   mary   ']
557     >>> alias['loop'] = ['other', 'john', '   mary   ']
558     >>> alias['other'] = ['loop', 'john', '   mary   ']
559     >>> lookup_email('mary', alias)
561     >>> lookup_email('arthur.wellesley@howe.ro.uk', alias)
563     >>> lookup_email('boys', alias)
565     >>> lookup_email('all', alias)
567     >>> lookup_email('odd', alias)
570     >>> lookup_email('loop', alias)
573     OSError: Recursive email alias at 'other'
574     >>> lookup_email('odd', alias, warn_on_error=False)
577     >>> lookup_email('loop', alias, warn_on_error=False)
578     Recursive email alias at 'other'
579     Recursive email alias at 'john'
580     Recursive email alias at 'mary'
583     if not alias:
584         alias = settings.alias
594         msg = "Recursive email alias at '%s'" % lookup_name
602         if lookup_name not in alias:
607         for item in alias[lookup_name]:
608             todo = lookup_email(item, alias, warn_on_error, level + 1)
632     """Gets the name of the git alias file.
635         Filename of git alias file, or None if none
682     """Set up git utils, by reading the alias files."""
683     # Check for a git alias file also