PR summary

Closes #27878

Add a name to the exception that is raised when an invalid keyword parameter is passed. This helps downstream packages who wrap our functions with their exception handling:

import matplotlib.pyplot as plt

def wobbly_plot(args, **kwargs):
    w = kwargs.pop('wobble_factor', None)
    
    try:
        plt.plot(args, **kwargs)
    except AttributeError as e:
        raise AttributeError(f'wobbly_plot does not take parameter {e.name}') from e
    
    
wobbly_plot([0, 1], wibble_factor=5)

<snip>
AttributeError: Line2D.set() got an unexpected keyword argument 'wibble_factor'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/ruth/python/wobble_plot.py", line 12, in <module>
    wobbly_plot([0, 1], wibble_factor=5)
  File "/home/ruth/python/wobble_plot.py", line 9, in wobbly_plot
    raise AttributeError(f'Wobbly_plot does not take parameter {e.name}') from e
AttributeError: wobbly_plot does not take parameter wibble_factor

We could also add the artist type as the obj attribute, or we could wait till someone asks for that.

Should this get a whatsnew entry?

PR checklist

• "closes #0000" is in the body of the PR description to link the related issue
• new and changed code is tested
• [n/a] Plotting related features are demonstrated in an example
• New Features and API Changes are noted with a directive and release note
• Documentation complies with general and docstring guidelines