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

    def positional_decorator(wrapped):
        def positional_wrapper(*args, **kwargs):
            if (len(args) > max_positional_args):
                plural_s = ''
                if (max_positional_args != 1):
                    plural_s = 's'
                raise TypeError(('%s()    takes    at    most    %d    positional    argument%s    (%d    given)' % (wrapped.__name__, max_positional_args, plural_s, len(args))))
            return wrapped(*args, **kwargs)
        return positional_wrapper
    if isinstance(max_positional_args, (int, long)):
        return positional_decorator
    else:
        (args, _, _, defaults) = inspect.getargspec(max_positional_args)
        if (defaults is None):
            raise ValueError('Functions    with    no    keyword    arguments    must    specify    max_positional_args')
        return positional((len(args) - len(defaults)))(max_positional_args)

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

def positional(max_positional_args):