Here the class hierarchy for IP related classes :
+--------+ +-------------+
| BaseIP | | IPListMixin |+---------+ +--------+ +-------------+ +---------+ | ipv4(M) | | | | | ipv6(M) | +---------+ | | | +---------+ | +----------------+----------------+ | | (HAS A) | | | | | (HAS A) | | | | | | | +-----+----------------+-----------------+ | | | | | +----------------+--------+ | | | | | | | | | | | | | | | | | | | | | | v v v v v v | | | | | +-----------+ +-----------+ | | | | | | IPAddress | | IPNetwork | | | +-----------+ +-----------+ | | | | | | | | | | (HAS A) (HAS A) | | | | | | v v v v +-------+--------+ +------------+ | | IPRange | | +------------+ v | +-------+ | | IPSet | v +-------+ +--------+ | IPGlob | +--------+
The following constants are used by the various flags arguments on netaddr class constructors.
P INET_PTON
Use inet_pton() semantics instead of inet_aton() when parsing IPv4.
Z ZEROFILL
Remove any preceding zeros from IPv4 address octets before parsing.
N NOHOST
Remove any host bits found to the right of an applied CIDR prefix
netaddr.AddrConversionError
netaddr.AddrFormatError
netaddr.NotRegisteredError
An IP address is a virtual address used to identify the source and destination of (layer 3) packets being transferred between hosts in a switched network. This library fully supports both IPv4 and the new IPv6 standards.
The IPAddress class is used to identify individual IP addresses.
netaddr.IPAddress
The following dialect classes can be used with the IPAddress.format method.
netaddr.ipv6_compact
netaddr.ipv6_full
netaddr.ipv6_verbose
The IPNetwork class is used to represent a group of IP addresses that comprise a network/subnet/VLAN containing hosts.
Nowadays, IP networks are usually specified using the CIDR format with a prefix indicating the size of the netmask. In the real world, there are a number of ways to express a "network"" and so the flexibility of the IPNetwork class constructor reflects this.
netaddr.IPNetwork
netaddr was designed to accommodate the many different ways in which groups of IP addresses and IP networks are specified, not only in router configurations but also less standard but more human-readable forms found in, for instance, configuration files.
Here are the options currently available.
A bounded range is a group of IP addresses specified using a start and end address forming a contiguous block. No bit boundaries are assumed but the end address must be numerically greater than or equal to the start address.
netaddr.IPRange
A very useful way to represent IP network in configuration files and on the command line for those who do not speak CIDR.
The IPGlob class is used to represent individual glob ranges.
netaddr.IPGlob
It is also very useful to be able to convert between glob ranges and CIDR and IP ranges. The following function enable these various conversions.
netaddr.cidr_to_glob
netaddr.glob_to_cidrs
netaddr.glob_to_iprange
netaddr.glob_to_iptuple
netaddr.iprange_to_globs
nmap is a well known network security tool. It has a particularly flexible way of specifying IP address groupings.
Functions are provided that allow the verification and enumeration of IP address specified in this format.
netaddr.valid_nmap_range
netaddr.iter_nmap_range
When dealing with large numbers of IP addresses and ranges it is often useful to manipulate them as sets so you can calculate intersections, unions and differences between various groups of them.
The IPSet class was built specifically for this purpose.
netaddr.IPSet
The following are a set of useful helper functions related to the various format supported in this library.
netaddr.all_matching_cidrs
netaddr.cidr_abbrev_to_verbose
netaddr.cidr_exclude
netaddr.cidr_merge
netaddr.iprange_to_cidrs
netaddr.iter_iprange
netaddr.iter_unique_ips
netaddr.largest_matching_cidr
netaddr.smallest_matching_cidr
netaddr.spanning_cidr
A MAC address is the 48-bit hardware address associated with a particular physical interface on a networked host. They are found in all networked devices and serve to identify (layer 2) frames in the networking stack.
The EUI class is used to represents MACs (as well as their larger and less common 64-bit cousins).
netaddr.EUI
netaddr.OUI
netaddr.IAB
The following dialects are used to specify the formatting of MAC addresses.
netaddr.mac_bare
netaddr.mac_cisco
netaddr.mac_eui48
netaddr.mac_pgsql
netaddr.mac_unix
netaddr.valid_ipv4
netaddr.valid_ipv6
netaddr.valid_glob
netaddr.valid_mac
Who said networking was all about being serious? It's always good to lighten up and have a bit of fun.
Let's face it, no networking library worth its salt would be complete without support for RFC 1924 - http://www.ietf.org/rfc/rfc1924 :-)
netaddr.base85_to_ipv6
netaddr.ipv6_to_base85