human
Here's a good function header given the following:
I wrote the below code

    prompt = ('[sudo]    password    for    %s:    ' % getpass.getuser())
    def stdin():
        pw = (getpass.getpass(prompt=prompt) + '\n')
        (yield pw)
    def process(args, kwargs):
        password = kwargs.pop('password', None)
        if (password is None):
            pass_getter = stdin()
        else:
            pass_getter = (password.rstrip('\n') + '\n')
        kwargs['_in'] = pass_getter
        return (args, kwargs)
    cmd = orig.bake('-S', _arg_preprocess=process)
    return cmd

What's a good function header?
assistant
#Here's a good function header.

@contrib('sudo')
def sudo(orig):