Skip to main content

Python 2.6 backport of 3.4's ipaddress module

Project description

This is a Python 2.6 backport of the Python 3.4 ipaddress module.

Please refer to the official Python 3.4 documentation for more information on the module.

Differences from Python 3.4’s ipaddress module

The backport should behave identically to 3.4, except as noted here.

bytearray instead of bytes

Since Python 2 has no distinct bytes type, bytearray is used instead for the “packed” (binary) address representation:

>>> ipaddress.ip_address(bytearray('\xc0\xa8\x54\x17'))
>>> ipaddress.ip_address('').packed

This means py2-ipaddress can accept both Python 2 string types (str and unicode) for the textual address representation.

If you prefer semantics closer to Python 3, you may be interested in Philipp Hagemeister’s ipaddress backport, which uses str for the “packed” address representation, but then requires all textual IP addresses to be given as unicode strings. That backport also supports Python 3.0–3.2.

Caching of is_private and is_global

Since Python 2.7’s functools module does not have Python 3.2’s lru_cache, no caching is performed for the is_private and is_global properties; this should be a minor problem as Python 3.3’s ipaddress did not use lru_cache either.


py2-ipaddress 3.4.2

Test suite and documentation improvements.

py2-ipaddress 3.4.1

Python 2.6 support and a bugfix.

py2-ipaddress 3.4

Since Python 2 does not distinguish between bytes and str like Python 3 does, version 2.0.1 and earlier of py2-ipaddress attempted to interpret str arguments as both and do the “right” thing.

This unfortunately led to surprising behavior in py2-ipaddress:

>>> ipaddress.ip_address('')

The ipaddress module does not, of course, perform DNS resolution. Rather, the argument is interpreted as a byte string (of length 16) and converted bit-for-bit into an IPv6 address. In Python 3, ipaddress correctly rejects such a constructor argument (unless the b prefix is used to explicitly mark the literal as a byte string).

Even worse, there is not always a single right interpretation. Python 3 example:

>>> ipaddress.ip_address('::1234:5678:9abc')
>>> ipaddress.ip_address(b'::1234:5678:9abc')

There is no way to distinguish the two invocations in Python 2. As a result, py2-ipaddress 3.4 uses bytearray for all byte strings, and str for text strings only:

>>> ipaddress.ip_address('::1234:5678:9abc')
>>> ipaddress.ip_address(b'::1234:5678:9abc')
>>> ipaddress.ip_address(bytearray('::1234:5678:9abc'))


The ipaddress modules (both the original and this backport) are licensed under the Python Software Foundation License version 2.

The modifications made for Python 2.6 compatibility are hereby released into the public domain by the authors.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py2-ipaddress-3.4.2.tar.gz (17.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page