Documentation

(And also for ipaddress.IPv6Network.hosts())

Inhttps://docs.python.org/3/library/ipaddress.html#ipaddress.IPv4Network.hosts andhttps://docs.python.org/3/library/ipaddress.html#ipaddress.IPv6Network.hosts thehosts() method is documented as returning an iterator, when in reality it can return an iteratoror a list.

This extra return possibilty can be seen in

and
and was introduced in 2020 in8e9c47a, but was fixed only recently in typeshed:python/typeshed@c0fed91

Linked PRs

• gh-141497: makeipaddress.IP{v4,v6}Network.hosts() return an iterator #141547
• [3.14] gh-141497: Make ipaddress.IP{v4,v6}Network.hosts() always returning an iterator (GH-141547) #141673
• [3.13] gh-141497: makeipaddress.IP{v4,v6}Network.hosts() return an iterator (GH-141547) #141695