bpo-45141: allow specifying files for mailcap.getcaps

[pacien]

This allows the caller of the function to specify a list of files to
parse and get the MIME mapping from. The added parameter is optional and
the previous behaviour is preserved otherwise.

https://bugs.python.org/issue45141

[the-knights-who-say-ni]

Hello, and thanks for your contribution!

I'm a bot set up to make sure that the project can legally accept this contribution by verifying everyone involved has signed the PSF contributor agreement (CLA).

CLA Missing

Our records indicate the following people have not signed the CLA:

@pacien

For legal reasons we need all the people listed to sign the CLA before we can look at your contribution. Please follow the steps outlined in the CPython devguide to rectify this issue.

If you have recently signed the CLA, please wait at least one business day
before our records are updated.

You can check yourself to see if the CLA has been received.

Thanks again for the contribution, we look forward to reviewing it!

[github-actions]

This PR is stale because it has been open for 30 days with no activity.

[MaxwellDupre]

Ran 8 tests in 0.023s

OK

== Tests result: SUCCESS ==

[hugovk]

Note that mailcap will be deprecated in Python 3.11 and removed in 3.13:

• PEP 594 – Removing dead batteries from the standard library
• Deprecate modules listed in PEP 594 #91217

[furkanonder]

Note that mailcap will be deprecated in Python 3.11 and removed in 3.13:

* [PEP 594 – Removing dead batteries from the standard library](https://peps.python.org/pep-0594/)

* [Deprecate modules listed in PEP 594 #91217](https://github.com/python/cpython/issues/91217)

Now that the module has been deprecated and the related issue has been closed. I think we can close the PR.

[arhadthedev]

I agree. Closing because 3.12 (the last version with mailcap) no longer accepts new features.