Documentation of ipaddress behavior for prefix length with leading zeros.

[lay20114]

BPO	46620

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2022-02-03.02:46:49.404>
labels = ['3.7', '3.8', '3.9', '3.10', '3.11', 'type-feature', 'docs']
title = 'Documentation of ipaddress behavior for prefix length with leading zeros.'
updated_at = <Date 2022-02-03.02:46:49.404>
user = 'https://bugs.python.org/lay20114'

bugs.python.org fields:

activity = <Date 2022-02-03.02:46:49.404>
actor = 'lay20114'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2022-02-03.02:46:49.404>
creator = 'lay20114'
dependencies = []
files = []
hgrepos = []
issue_num = 46620
keywords = []
message_count = 1.0
messages = ['412412']
nosy_count = 2.0
nosy_names = ['docs@python', 'lay20114']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue46620'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9', 'Python 3.10', 'Python 3.11']

[lay20114]

ipaddress library tolerate the prefix length with leading zeros.
$ ./python.exe 
Python 3.11.0a4+ (heads/main:8fb3649450, Jan 31 2022, 16:39:46) [Clang 13.0.0 (clang-1300.0.29.3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import ipaddress
>>> ipaddress.ip_interface('192.0.2.0/0000000024')
IPv4Interface('192.0.2.0/24')
>>> ipaddress.ip_interface('2001:db8::/0000000032')
IPv6Interface('2001:db8::/32')

The explanation of this behavior exists in follow tests.

cpython/Lib/test/test_ipaddress.py

Lines 747 to 748 in 51a95be

	# Zero prefix is treated as decimal.
	self.assertEqual(str(self.factory('::/0%d' % i)), net_str)

cpython/Lib/test/test_ipaddress.py

Lines 755 to 756 in 51a95be

	# Zero prefix is treated as decimal.
	self.assertEqual(str(self.factory('::/0%d' % i)), net_str)

cpython/Lib/test/test_ipaddress.py

Lines 592 to 593 in 51a95be

	# Zero prefix is treated as decimal.
	self.assertEqual(str(self.factory('0.0.0.0/0%d' % i)), net_str)

But, it seems that the explanation does not exists in the document.
https://docs.python.org/3.11/library/ipaddress.html
https://docs.python.org/3.10/library/ipaddress.html
https://docs.python.org/3.9/library/ipaddress.html
https://docs.python.org/3.8/library/ipaddress.html
https://docs.python.org/3.7/library/ipaddress.html