__init__(self, ipaddr)
(Constructor)

Instantiate a new IPv4 object.

Args:
    ipaddr: A string or integer representing the IP [& network].
      '192.168.1.1/32'
      '192.168.1.1/255.255.255.255'
      '192.168.1.1/0.0.0.255'
      '192.168.1.1'
      are all functionally the same in IPv4. That is to say,
      failing to provide a subnetmask will create an object with
      a mask of /32. A netmask of '255.255.255.255' is assumed
      to be /32 and '0.0.0.0' is assumed to be /0, even though
      other netmasks can be expressed both as host- and
      net-masks. (255.0.0.0 == 0.255.255.255)

      Additionally, an integer can be passed, so
      IPv4('192.168.1.1') == IPv4(3232235777).
      or, more generally
      IPv4(IPv4('192.168.1.1').ip) == IPv4('192.168.1.1')

Raises:
    IPv4IpValidationError: If ipaddr isn't a valid IPv4 address.
    IPv4NetmaskValidationError: If the netmask isn't valid for
      an IPv4 address.

Overrides:

__builtin__.object.__init__

IsLinkLocal(self)

Test if the address is reserved for LinkLocal.

Returns:
    A boolean, True if the address is link local.

IsLoopback(self)

Test if the address is a loopback adddress.

Returns:
    A boolean, True if the address is a loopback.

IsMulticast(self)

Test if the address is reserved for multicast use.

Returns:
    A boolean, True if the address is multicast.

IsRFC1918(self)

Test if the IPv4 address is reserved per RFC1918.

Returns:
    A boolean, True if the address is reserved.

SetPrefix(self, prefixlen)

Change the prefix length.

Args:
    prefixlen: An integer, the new prefix length.

Raises:
    IPv4NetmaskValidationError: If prefixlen is out of bounds.

Subnet(self, prefixlen_diff=1)

The subnets which join to make the current subnet.

In the case that self contains only one IP
(self.prefixlen == 32), return a list with just ourself.

Args:
    prefixlen_diff: An integer, the amount the prefix length
      should be increased by.  Given a /24 network and a
      prefixlen_diff of 3, for example, 8 subnets of size /27
      will be returned.  The default value of 1 splits the
      current network into two halves.

Returns:
    A list of IPv4 objects.

Raises:
    PrefixlenDiffInvalidError: The prefixlen_diff is too small
      or too large.

Supernet(self, prefixlen_diff=1)

The supernet containing the current network.

Args:
    prefixlen_diff: An integer, the amount the prefix length of
      the network should be decreased by.  For example, given a
      /24 network and a prefixlen_diff of 3, a supernet with a
      /21 netmask is returned.

Returns:
    An IPv4 object.

Raises:
    PrefixlenDiffInvalidError: If
      self.prefixlen - prefixlen_diff < 0. I.e., you have a
      negative prefix length.

_IpIntFromStr(self, ip_str)

Turn the given IP string into an integer for comparison.

Args:
    ip_str: A string, the IP address.

Returns:
    The IP address as an integer.

_IsHostMask(self, ip_str)

Test if the IP string is a hostmask (rather than a netmask).

Args:
    ip_str: A string, the potential hostmask.

Returns:
    A boolean, True if the IP string is a hostmask.

_IsValidIp(self, ip_str)

Validate the dotted decimal notation IP/netmask string.

Args:
    ip_str: A string, the IP address.

Returns:
    A boolean, True if the string is a valid dotted decimal IP
    string.

_IsValidNetmask(self, netmask)

Verify that the netmask is valid.

Args:
    netmask: A string, either a prefix or dotted decimal
      netmask.

Returns:
    A boolean, True if the prefix represents a valid IPv4
    netmask.

_StrFromIpInt(self, ip_int)

Turns a 32-bit integer into dotted decimal notation.

Args:
    ip_int: An integer, the IP address.

Returns:
    The IP address as a string in dotted decimal notation.

version

Get Method:

version(...)