Fix the documented type of IPv4Address.ipv6_mapped

[Prafyl]

The docs for IPv4Address.ipv6_mapped in Doc/library/ipaddress.rst say it is an

:class:IPv4Address object representing the IPv4-mapped IPv6 address.

but it returns an IPv6Address:

>>> import ipaddress
>>> ipaddress.IPv4Address('192.0.2.1').ipv6_mapped
IPv6Address('::ffff:192.0.2.1')

The implementation is return IPv6Address(f'::ffff:{self}') and the docstring already says "Return the IPv4-mapped IPv6 address", so its just the class name in the docs thats wrong. An IPv4-mapped IPv6 address cant really be an IPv4Address anyway.

Docs only, one word, no behaviour change. ipv6_mapped was added in 3.13 so this applies to 3.13 onwards.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #34668605 | 📁 Comparing 7d2ebd9 against main (e9ae46f)

  🔍 Preview build  

1 file changed

± library/ipaddress.html

[StanFromIreland]

LGTM

[miss-islington-app]

Thanks @Prafyl for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

[bedevere-app]

GH-157918 is a backport of this pull request to the 3.15 branch.

[bedevere-app]

GH-157919 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-157920 is a backport of this pull request to the 3.13 branch.