Documentation

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

In https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv4Network.hosts and https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv6Network.hosts the hosts() method is documented as returning an iterator, when in reality it can return an iterator or a list.

This extra return possibilty can be seen in

and

and was introduced in 2020 in

, but was fixed only recently in typeshed:

Linked PRs

• gh-141497: make ipaddress.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: make ipaddress.IP{v4,v6}Network.hosts() return an iterator (GH-141547) #141695