Introduction

A Python library for representing and manipulating network addresses.

Provides support for:

Layer 3 addresses

• IPv4 and IPv6 addresses, subnets, masks, prefixes
• iterating, slicing, sorting, summarizing and classifying IP networks
• dealing with various ranges formats (CIDR, arbitrary ranges and globs, nmap)
• set based operations (unions, intersections etc) over IP addresses and subnets
• parsing a large variety of different formats and notations
• looking up IANA IP block information
• generating DNS reverse lookups
• supernetting and subnetting

Layer 2 addresses

• representation and manipulation MAC addresses and EUI-64 identifiers
• looking up IEEE organisational information (OUI, IAB)
• generating derived IPv6 addresses

Changes

For details on the latest updates and changes, see What’s new in netaddr 0.7.19

License

This software is released under the liberal BSD license.

See the License and Copyright for full text.

Dependencies

• Python 2.5.x through 3.5.x
• IPython (for netaddr interactive shell)

Installation

See Installing netaddr for details.

Documentation

This library has comprehensive docstrings and a full set of project documentation (including tutorials):

• http://pythonhosted.org/netaddr/
• http://netaddr.readthedocs.io/en/latest/

Tests

netaddr requires py.test (http://pytest.org/).

To run the test suite, clone the repository and run:

python setup.py test

If any of the tests fail, please help the project’s user base by filing bug reports on the netaddr issue tracker:

• http://github.com/drkjam/netaddr/issues

Finally…

Share and enjoy!