This class represents and manipulates 128-bit IPv6 networks. Attributes: [examples for IPv6('2001:db8::1000/124')] .network_address: IPv6Address('2001:db8::1000') .hostmask: IPv6Address('::f') .broadcast_address: IPv6Address('2001:db8::100f') .netmask: IPv6Addres
| 2275 | |
| 2276 | |
| 2277 | class IPv6Network(_BaseV6, _BaseNetwork): |
| 2278 | |
| 2279 | """This class represents and manipulates 128-bit IPv6 networks. |
| 2280 | |
| 2281 | Attributes: [examples for IPv6('2001:db8::1000/124')] |
| 2282 | .network_address: IPv6Address('2001:db8::1000') |
| 2283 | .hostmask: IPv6Address('::f') |
| 2284 | .broadcast_address: IPv6Address('2001:db8::100f') |
| 2285 | .netmask: IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff:ffff:fff0') |
| 2286 | .prefixlen: 124 |
| 2287 | |
| 2288 | """ |
| 2289 | |
| 2290 | # Class to use when creating address objects |
| 2291 | _address_class = IPv6Address |
| 2292 | |
| 2293 | def __init__(self, address, strict=True): |
| 2294 | """Instantiate a new IPv6 Network object. |
| 2295 | |
| 2296 | Args: |
| 2297 | address: A string or integer representing the IPv6 network or the |
| 2298 | IP and prefix/netmask. |
| 2299 | '2001:db8::/128' |
| 2300 | '2001:db8:0000:0000:0000:0000:0000:0000/128' |
| 2301 | '2001:db8::' |
| 2302 | are all functionally the same in IPv6. That is to say, |
| 2303 | failing to provide a subnetmask will create an object with |
| 2304 | a mask of /128. |
| 2305 | |
| 2306 | Additionally, an integer can be passed, so |
| 2307 | IPv6Network('2001:db8::') == |
| 2308 | IPv6Network(42540766411282592856903984951653826560) |
| 2309 | or, more generally |
| 2310 | IPv6Network(int(IPv6Network('2001:db8::'))) == |
| 2311 | IPv6Network('2001:db8::') |
| 2312 | |
| 2313 | strict: A boolean. If true, ensure that we have been passed |
| 2314 | A true network address, eg, 2001:db8::1000/124 and not an |
| 2315 | IP address on a network, eg, 2001:db8::1/124. |
| 2316 | |
| 2317 | Raises: |
| 2318 | AddressValueError: If address isn't a valid IPv6 address. |
| 2319 | NetmaskValueError: If the netmask isn't valid for |
| 2320 | an IPv6 address. |
| 2321 | ValueError: If strict was True and a network address was not |
| 2322 | supplied. |
| 2323 | """ |
| 2324 | addr, mask = self._split_addr_prefix(address) |
| 2325 | |
| 2326 | self.network_address = IPv6Address(addr) |
| 2327 | self.netmask, self._prefixlen = self._make_netmask(mask) |
| 2328 | packed = int(self.network_address) |
| 2329 | if packed & int(self.netmask) != packed: |
| 2330 | if strict: |
| 2331 | raise ValueError('%s has host bits set' % self) |
| 2332 | else: |
| 2333 | self.network_address = IPv6Address(packed & |
| 2334 | int(self.netmask)) |
no outgoing calls
no test coverage detected