gh-107995: Fix doctest collection of functools.cached_property objects

[tjsmart]

DocTestFinder would skip functools.cached_property objects because they were not considered to be a part of the module that it is collecting doc tests from. To fix this issue I added a check for cached_property that grabs the underlying function, similar to what is done for staticmethod and classmethod.

• Issue: @cached_property is not checked for doctests #107995

[ghost]

All commit authors signed the Contributor License Agreement.

[bedevere-bot]

Most changes to Python require a NEWS entry.

Please add it using the blurb_it web app or the blurb command-line tool.

[sobolevn]

LGTM, thank you!

[AlexWaygood]

Thanks! You can also add your name to this file here, if you like, but it isn't mandatory: https://github.com/python/cpython/blob/main/Misc/ACKS

[AlexWaygood]

By the way, for future PRs to CPython, please avoid force-pushing where possible. It interacts badly with the GitHub UI, making it hard for reviewers to see what changed between commits. We merge everything using GitHub's "squash and merge" button in CPython, so we don't care about a messy commit history for a PR :-)

[tjsmart]

By the way, for future PRs to CPython, please avoid force-pushing where possible. It interacts badly with the GitHub UI, making it hard for reviewers to see what changed between commits. We merge everything using GitHub's "squash and merge" button in CPython, so we don't care about a messy commit history for a PR :-)

Sounds good. Thanks for the heads up! 👍

[carljm]

LGTM!