Модуль ipaddress предоставляет возможности для создания, управления и работы с адресами и сетями IPv4 и IPv6.
Функции и классы в этом модуле упрощают выполнение различных задач, связанных с IP-адресами, включая проверку того, находятся ли два хоста в одной подсети, итерацию по всем хостам в определенной подсети, проверку того, представляет ли строка действительный IP-адрес или определение сети и т. д.
Так как ipaddress - это модуль для проверки и управления IP-адресами, первое, что нужно сделать, это создать несколько объектов. Объекты модуля ipaddress можно создавать из строк и целых чисел.
Примечание к версиям IP адресов: Для пользователей, которые не знакомы с IP-адресацией, важно знать, что Интернет-протокол в настоящее время находится в процессе перехода от версии 4 к версии 6. Этот переход происходит в основном потому, что версия 4 протокола не предоставляет достаточного количества адресов для удовлетворения потребностей всего мира, особенно учитывая растущее число устройств с прямым подключением к Интернету.
Адреса, часто называемые "адресами хостов", являются основной единицей при работе с IP-адресацией. Самый простой способ создания адресов - использовать фабричную функцию ipaddress.ip_address(), которая автоматически определяет, следует ли создавать адрес IPv4 или IPv6 на основе переданного значения:
>>> ipaddress.ip_address('192.0.2.1') # IPv4Address('192.0.2.1') >>> ipaddress.ip_address('2001:DB8::1') # IPv6Address('2001:db8::1')
Адреса также можно создавать непосредственно из целых чисел. Предполагается, что значения, которые соответствуют 32 битам, являются адресами IPv4:
>>> ipaddress.ip_address(3221225985) # IPv4Address('192.0.2.1') >>> ipaddress.ip_address(42540766411282592856903984951653826561) # IPv6Address('2001:db8::1')
Чтобы принудительно использовать адреса IPv4 или IPv6, соответствующие классы могут быть вызваны напрямую. Такое поведение полезно для принудительного создания адресов IPv6 для небольших целых чисел:
>>> ipaddress.ip_address(1) # IPv4Address('0.0.0.1') >>> ipaddress.IPv4Address(1) # IPv4Address('0.0.0.1') >>> ipaddress.IPv6Address(1) # IPv6Address('::1')
Адреса хостов обычно группируются в IP-сети, поэтому модуль ipaddress позволяет создавать, проверять и управлять определениями сети. Сетевые объекты IP состоят из строк, которые определяют диапазон адресов хостов, которые являются частью этой сети. Простейшей формой этой информации является пара "сетевой адрес/сетевой префикс", где префикс определяет количество ведущих битов, которые сравниваются, чтобы определить, является ли адрес частью сети, а сетевой адрес определяет ожидаемое значение этих бит.
Что касается адресов, предусмотрена фабричная функция, которая автоматически определяет правильную версию IP:
>>> ipaddress.ip_network('192.0.2.0/24') # IPv4Network('192.0.2.0/24') >>> ipaddress.ip_network('2001:db8::0/96') # IPv6Network('2001:db8::/96')
Объекты IP-сети не могут иметь никаких битов хоста. На практике это означает, что запись 192.0.2.1/24 не описывает сеть. Такие определения называются объектами сетевых интерфейсов, поскольку нотация ip-on-a-network обычно используется для описания сетевых интерфейсов компьютера в данной сети.
По умолчанию попытка создать сетевой объект с установленными битами хоста приведет к возникновению ValueError. Чтобы запросить приведение дополнительных битов к нулю, в конструктор необходимо передать флаг strict=False:
>>> ipaddress.ip_network('192.0.2.1/24') # Traceback (most recent call last): # ... # ValueError: 192.0.2.1/24 has host bits set >>> ipaddress.ip_network('192.0.2.1/24', strict=False) IPv4Network('192.0.2.0/24')
Хотя строковая форма предлагает значительно большую гибкость, объекты сети также можно определять с помощью целых чисел, как и адреса хостов. В этом случае считается, что сеть содержит только один адрес, обозначенный целым числом, поэтому префикс сети включает весь сетевой адрес:
>>> ipaddress.ip_network(3221225984) # IPv4Network('192.0.2.0/32') >>> ipaddress.ip_network(42540766411282592856903984951653826560) # IPv6Network('2001:db8::/128')
Как и в случае с адресами, определенный тип сети может быть принудительно создан прямым вызовом конструктора класса вместо использования фабричной функции.
Если нужно описать адрес в конкретной сети, ни объекта адреса, ни объекта сети недостаточно. Обозначение типа 192.0.2.1/24, используется сетевыми инженерами для определения правил маршрутизаторов и расшифровывается как "хост 192.0.2.1 в сети 192.0.2.0/24". Соответственно, модуль ipaddress предоставляет набор гибридных классов, которые связывают адрес с определенной сетью. Интерфейс для создания идентичен интерфейсу для определения объектов сети, за исключением того, что часть адреса не ограничивается объектом сетевого адреса.
>>> ipaddress.ip_interface('192.0.2.1/24') # IPv4Interface('192.0.2.1/24') >>> ipaddress.ip_interface('2001:db8::1/96') # IPv6Interface('2001:db8::1/96')
Для создания интерфейса могут использоваться целочисленные входные данные (как в случае с сетями), так же создание определенного типа интерфейса хоста может быть создано прямым вызовом конструктора соответствующего класса
И так, есть объект IPv(4/6) IP-адреса, сети или интерфейса, и вероятно, необходимо получить информацию о нем. Модуль ipaddress делает это простым и интуитивно понятным.
Извлечение версии IP:
>>> addr4 = ipaddress.ip_address('192.0.2.1') >>> addr6 = ipaddress.ip_address('2001:db8::1') >>> addr6.version # 6 >>> addr4.version # 4
Получение сети из интерфейса:
>>> host4 = ipaddress.ip_interface('192.0.2.1/24') >>> host4.network # IPv4Network('192.0.2.0/24') >>> host6 = ipaddress.ip_interface('2001:db8::1/96') >>> host6.network # IPv6Network('2001:db8::/96')
Узнаем, сколько отдельных адресов в сети:
>>> net4 = ipaddress.ip_network('192.0.2.0/24') >>> net4.num_addresses # 256 >>> net6 = ipaddress.ip_network('2001:db8::0/96') >>> net6.num_addresses # 4294967296
Перебор полезных адресов в сети:
>>> net4 = ipaddress.ip_network('192.0.2.0/24') >>> for x in net4.hosts(): ... print(x) # 192.0.2.1 # 192.0.2.2 # 192.0.2.3 # 192.0.2.4 # ... # 192.0.2.252 # 192.0.2.253 # 192.0.2.254
Получение сетевой маски (т. е. установки битов, соответствующих префиксу сети) или маски хоста (любых битов, не являющихся частью сетевой маски):
>>> net4 = ipaddress.ip_network('192.0.2.0/24') >>> net4.netmask # IPv4Address('255.255.255.0') >>> net4.hostmask # IPv4Address('0.0.0.255') >>> net6 = ipaddress.ip_network('2001:db8::0/96') >>> net6.netmask # IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff::') >>> net6.hostmask # IPv6Address('::ffff:ffff')
Расширение или сжатие IPv6-адреса:
>>> addr6.exploded # '2001:0db8:0000:0000:0000:0000:0000:0001' >>> addr6.compressed # '2001:db8::1' >>> net6.exploded # '2001:0db8:0000:0000:0000:0000:0000:0000/96' >>> net6.compressed # '2001:db8::/96'
Хотя IPv4 не поддерживает расширение или сжатие, связанные объекты по-прежнему предоставляют соответствующие свойства, поэтому нейтральный по версии код может легко гарантировать, что для адресов IPv6 используется наиболее краткая или самая подробная форма, при этом адреса IPv4, так же обрабатывая правильно.
Полезное свойство модуля, это предоставление объекта сети как списка адресов. Это означает, что их можно индексировать следующим образом:
>>> net4 = ipaddress.ip_network('192.0.2.0/24') >>> net4[1] # IPv4Address('192.0.2.1') >>> net4[-1] # IPv4Address('192.0.2.255') >>> net6 = ipaddress.ip_network('2001:db8::0/96') >>> net6[1] # IPv6Address('2001:db8::1') >>> net6[-1] # IPv6Address('2001:db8::ffff:ffff')
Сетевые объекты можно проверять на вхождение/членство в списке следующим образом:
if address in network: # do something
Вхождение/членство IP-адреса эффективно выполняется на основе префикса сети:
>>> addr4 = ipaddress.ip_address('192.0.2.1') >>> addr4 in ipaddress.ip_network('192.0.2.0/24') # True >>> addr4 in ipaddress.ip_network('192.0.3.0/24') # False
Модуль ipaddress предоставляет несколько простых, интуитивно понятных способов сравнения объектов, где это имеет смысл:
>>> ipaddress.ip_address('192.0.2.1') < ipaddress.ip_address('192.0.2.2') # True
Если производится попытка сравнить объекты разных версий или разных типов, то возникает исключение TypeError.
Другие модули, использующие IP-адреса (например, socket), обычно не принимают объекты IP-адреса напрямую. Следовательно они должны быть приведены к целому числу или строке, которые примет другой модуль:
>>> addr4 = ipaddress.ip_address('192.0.2.1') >>> str(addr4) # '192.0.2.1' >>> int(addr4) # 3221225985
При создании объектов адреса, сети или интерфейса с использованием фабричных функций, не зависящих от версии протокола, любые ошибки будут генерировать исключение ValueError с общим сообщением об ошибке (переданное значение не было распознано как объект этого типа).
Конструкторы классов, имеющих в названии конкретный протокол, при ошибках создания объекта вызывают исключения ipaddress.AddressValueError и ipaddress.NetmaskValueError и точно указывают, какую часть определения не удалось правильно проанализировать
Сообщения об ошибках значительно более детализированы при прямом использовании конструкторов классов. Например:
>>> ipaddress.ip_address("192.168.0.256") # Traceback (most recent call last): # ... # ValueError: '192.168.0.256' does not appear to be an IPv4 or IPv6 address >>> ipaddress.IPv4Address("192.168.0.256") # Traceback (most recent call last): # ... # ipaddress.AddressValueError: Octet 256 (> 255) not permitted in '192.168.0.256' >>> ipaddress.ip_network("192.168.0.1/64") # Traceback (most recent call last): # ... # ValueError: '192.168.0.1/64' does not appear to be an IPv4 or IPv6 network >>> ipaddress.IPv4Network("192.168.0.1/64") # Traceback (most recent call last): # ... # ipaddress.NetmaskValueError: '64' is not a valid netmask
Оба специфичных для модуля исключения имеют ValueError в качестве родительского класса, поэтому, если не беспокоит конкретный тип ошибки, все равно можно написать код, подобный следующему:
try: network = ipaddress.IPv4Network(address) except ValueError: print('address/netmask is invalid for IPv4:', address)