This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author sobolevn
Recipients docs@python, sobolevn
Date 2022-02-05.07:05:52
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1644044752.78.0.400898810491.issue46646@roundup.psfhosted.org>
In-reply-to
Content
Right now the docs say:

> ipaddress.ip_interface(address)
> Return an IPv4Interface or IPv6Interface object depending on the IP address passed as argument. **address is a string or integer** representing the IP address. Either IPv4 or IPv6 addresses may be supplied; integers less than 2**32 will be considered to be IPv4 by default. A ValueError is raised if address does not represent a valid IPv4 or IPv6 address.

Note the `address is a string or integer` part.

But, this is not true. Counter example:

```
>>> import ipaddress
>>> ipaddress.ip_interface(b'0000')
IPv4Interface('48.48.48.48/32')
>>> ipaddress.ip_interface(b'1111')
IPv4Interface('49.49.49.49/32')
```

So, packed version that accepts `bytes`, should be also mentioned.

For `ip_address` types are not mentioned:

> ipaddress.ip_address(address)
> Return an IPv4Address or IPv6Address object depending on the IP address passed as argument. Either IPv4 or IPv6 addresses may be supplied; integers less than 2**32 will be considered to be IPv4 by default. A ValueError is raised if address does not represent a valid IPv4 or IPv6 address.

I will send a PR with proposed changes.
History
Date User Action Args
2022-02-05 07:05:52sobolevnsetrecipients: + sobolevn, docs@python
2022-02-05 07:05:52sobolevnsetmessageid: <1644044752.78.0.400898810491.issue46646@roundup.psfhosted.org>
2022-02-05 07:05:52sobolevnlinkissue46646 messages
2022-02-05 07:05:52sobolevncreate