�
�̸g� � �B � S r SSKJr SSKJrJr S rS rS rS r S r
g )
z�
Routines for dealing with nmap-style IPv4 address ranges.
Based on nmap's Target Specification :-
http://nmap.org/book/man-target-specification.html
� )�AddrFormatError)� IPAddress� IPNetworkc �, � [ 5 nU R S5 H� nSU; a� UR SS5 u p4U( d SnU( d Sn[ U5 n[ U5 nSUs=:: a S:: a O OSUs=:: a S:: d O [ SU < S35 eXV:� a [ SU< 35 e[ XVS- 5 H nUR U5 M M� [ U5 nSUs=:: a S:: d O [ SU < S35 eUR U5 M� [
U5 $ ) N�,�-� r � z octet value overflow for spec �!z%left side of hyphen must be <= right )�set�split�int�
ValueError�range�add�sorted)�spec�values�element�left�right�low�high�octets �1/usr/lib/python3/dist-packages/netaddr/ip/nmap.py�_nmap_octet_target_valuesr s� � � �U�F��:�:�c�?�� �'�>�!�-�-��Q�/�K�D��������d�)�C��u�:�D��#�_��_�1��+;��+;� ��!N�O�O��z� �g�!W�X�X� �s�1�H�-���
�
�5�!� .� ��L�E���%�#�%� ��!N�O�O� �J�J�u� �' #�* �&�>�� c �H � [ U [ 5 ( d [ S[ U 5 - 5 eU ( d [ S5 eU R S5 n[
U5 S:w a [ SU < 35 e[ US 5 [ US 5 [ US 5 [ US 5 4$ )
Nzstring expected, not %sz*nmap target specification cannot be blank!�.� zinvalid nmap range: r r � � ) �
isinstance�str� TypeError�typer r
�lenr r )�nmap_target_spec�tokenss r �_generate_nmap_octet_rangesr* / s� � � �&�� ,� ,��1�D�9I�4J�J�K�K� ��E�F�F�
�
#�
#�C�
(�F�
�6�{�a�� �:J� L�M�M� "�&��)�,�!�&��)�,�!�&��)�,�!�&��)�,� � r c # � # � SU ; ao U R SS5 u pS[ U5 s=: a S: d O [ SU< 35 e[ U 5 nUR S:w a [ S5 eU H nUv � M g SU ; a [ U 5 v � g [
U 5 nUS H: nUS H. nUS H" nUS
H n [ S XgX�4- S5 v � M M$ M0 M< g 7f) N�/r r �! zCIDR prefix expected, not r zCIDR only support for IPv4!�:r! r" z %d.%d.%d.%d)r
r r r �versionr r* )
� target_spec�_�prefix�net�ip� octet_ranges�w�x�y�zs
r �_parse_nmap_target_specr: E s� � � �
�k�� �%�%�c�1�-� ���C��K�$�"�$�!�F�"L�M� M�� �$�� �;�;�!� �!�"?�@� @��B��H� � � � �� �$�$�2�;�?� � �a� �A�!�!�_��%�a� �A� )�!�_�� '�
��q� �(D�a� H�H� -� )� %� !�s �CCc �d � [ [ U 5 5 g! [ [ [ 4 a gf = f)z�
:param target_spec: an nmap-style IP range target specification.
:return: ``True`` if IP range target spec is valid, ``False`` otherwise.
TF)�nextr: r% r r )r0 s r �valid_nmap_ranger= [ s4 � �
� �
$�[�
1�2��� �z�?� 3�
� � �
�s � �/�/c ' �J # � U H n[ U5 H nUv � M M g7f)a=
An generator that yields IPAddress objects from defined by nmap target
specifications.
See https://nmap.org/book/man-target-specification.html for details.
:param nmap_target_spec: one or more nmap IP range target specification.
:return: an iterator producing IPAddress objects for each IP in the target spec(s).
N)r: )r( r0 �addrs r �iter_nmap_ranger@ i s% � � � (� �+�K�8�D��J� 9� (�s �!#N) �__doc__� netaddr.corer �
netaddr.ipr r r r* r: r= r@ � r r �<module>rE s, �� � )� +��:�,I�, �
r