Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
ansible
/
plugins
/
inventory
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: ini.cpython-310.pyc
o O�h�D � @ s� d dl mZ dZdZd dlZd dlZd dlZd dlmZ d dl m Z d dl m Z m Z d dlmZmZ d d lmZ G d d � d e �ZdS ) � )� annotationsae name: ini version_added: "2.4" short_description: Uses an Ansible INI file as inventory source. description: - INI file based inventory, sections are groups or group related with special C(:modifiers). - Entries in sections C([group_1]) are hosts, members of the group. - Hosts can have variables defined inline as key/value pairs separated by C(=). - The C(children) modifier indicates that the section contains groups. - The C(vars) modifier indicates that the section contains variables assigned to members of the group. - Anything found outside a section is considered an 'ungrouped' host. - Values passed in the INI format using the C(key=value) syntax are interpreted differently depending on where they are declared within your inventory. - When declared inline with the host, INI values are processed by Python's ast.literal_eval function (U(https://docs.python.org/3/library/ast.html#ast.literal_eval)) and interpreted as Python literal structures (strings, numbers, tuples, lists, dicts, booleans, None). If you want a number to be treated as a string, you must quote it. Host lines accept multiple C(key=value) parameters per line. Therefore they need a way to indicate that a space is part of a value rather than a separator. - When declared in a C(:vars) section, INI values are interpreted as strings. For example C(var=FALSE) would create a string equal to C(FALSE). Unlike host lines, C(:vars) sections accept only a single entry per line, so everything after the C(=) must be the value for the entry. - Do not rely on types set during definition, always make sure you specify type with a filter when needed when consuming the variable. - See the Examples for proper quoting to prevent changes to variable type. notes: - Enabled in configuration by default. - Consider switching to YAML format for inventory sources to avoid confusion on the actual type of a variable. The YAML inventory plugin processes variable values consistently and correctly. a� # fmt: ini # Example 1 [web] host1 host2 ansible_port=222 # defined inline, interpreted as an integer [web:vars] http_port=8080 # all members of 'web' will inherit these myvar=23 # defined in a :vars section, interpreted as a string [web:children] # child groups will automatically add their hosts to parent group apache nginx [apache] tomcat1 tomcat2 myvar=34 # host specific vars override group vars tomcat3 mysecret="'03#pa33w0rd'" # proper quoting to prevent value changes [nginx] jenkins1 [nginx:vars] has_java = True # vars in child groups override same in parent [all:vars] has_java = False # 'all' is 'top' parent # Example 2 host1 # this is 'ungrouped' # both hosts have same IP but diff ports, also 'ungrouped' host2 ansible_host=127.0.0.1 ansible_port=44 host3 ansible_host=127.0.0.1 ansible_port=45 [g1] host4 [g2] host4 # same host as above, but member of 2 groups, will inherit vars from both # inventory hostnames are unique N)�to_safe_group_name)�BaseFileInventoryPlugin)� AnsibleError�AnsibleParserError)�to_bytes�to_text)� shlex_splitc s� e Zd ZdZdZed�Zed�Z� fdd�Zd � fdd � Z d d � Z d d � Z dd� Z dd� Z dd� Zdd� Z� fdd�Zedd� �Zdd� Z� ZS ) �InventoryModulez� Takes an INI-format inventory file and builds a list of groups and subgroups with their associated hosts and variable settings. �ini)�;�#)� ;� #c s t t| ��� i | _d | _d S )N)�superr �__init__�patterns� _filename��self�� __class__� �H/usr/local/lib/python3.10/dist-packages/ansible/plugins/inventory/ini.pyr ` s zInventoryModule.__init__Tc s t t| ��|||� || _zi| jr| j�|�\}}n t|dd�}t|d�� }|�� }W d � n1 s4w Y z t |dd�� � } W n* t ym g } |� � D ]} | ra| d | j v ra| � d� qP| � t | dd�� qPY nw | �|| � W d S ty� } zt| ��d } ~ ww )N�surrogate_or_strict��errors�rbr � )r r �parser �loader�_get_file_contentsr �open�readr � splitlines� UnicodeError�b_COMMENT_MARKERS�append�_parse� Exceptionr ) r � inventoryr �path�cache�b_data�private�b_path�fh�data�line�er r r r g s0 � �� ��zInventoryModule.parsec C s t d| j| jf | ��)Nz%s:%d: )r r �lineno)r �messager r r � _raise_error� s z InventoryModule._raise_errorc C s� | � � i }d}d}d| _|D ]�}| jd7 _|�� }|r%|d | jv r&q| jd �|�}|r�|�� \}}t|�}|p=d}|dvrRd�|�� �}| � d||f � || j jvrp|d krj||vrjt | j||d �||< | j � |� ||v r�|d kr�|| d d kr�| � ||� n || d d kr�||= q|�d �r�|�d�r�| � d| d d � |dkr�| �|�\} } } | �| | || � q|d kr�| �|�\} } | j �|| | � q|d k�r| �|�}|| j jvr�||vr�t | j|||gd�||< q|| d �|� q| j �||� q| � d| � q|D ]7}|| }|d d k�r+td||d |d |d f ��|d d k�rDtd||d |d �� |d f ���qdS )zt Populates self.groups from the given array of lines. Raises an error on any parse failure. � ungrouped�hostsr � �section)r8 �children�vars�:z!Section [%s] has unknown type: %sr< )r2 �state�namer> r; �[�]zFInvalid section entry: '%s'. Please make sure that there are no spaces� zDin the section entry, and that there are no other invalid characters)r2 r> r? �parentsrC zEntered unhandled state: %sz:%s:%d: Section [%s:vars] not valid for undefined group: %sr2 r? z9%s:%d: Section [%s:children] includes undefined group: %sN)�_compile_patternsr4 �strip�_COMMENT_MARKERSr �match�groupsr �joinr6 r* �dict� add_group�_add_pending_children� startswith�endswith�_parse_host_definition�_populate_host_vars�_parse_variable_definition� set_variable�_parse_group_namer' � add_childr �pop)r r+ �lines�pending_declarations� groupnamer> r2 �m�titler8 �port� variables�k�v�child�g�declr r r r( � sl � $��zInventoryModule._parsec C sN || d D ]}| j �||� ||v r!|| d dkr!| �||� q||= d S )NrC r> r; )r* rT rL )r �group�pending�parentr r r rL � s � z%InventoryModule._add_pending_childrenc C s0 | j d �|�}|r|�d�S | �d| � dS )z� Takes a single line and tries to parse it as a group name. Returns the group name if successful, or raises an error. rX r9 z Expected group name, got: %sN)r rG rb r6 )r r2 rY r r r rS s z!InventoryModule._parse_group_namec C sB d|v rdd� |� dd�D �\}}|| �|�fS | �d| � dS )z� Takes a string and tries to parse it as a variable definition. Returns the key and value if successful, or raises an error. �=c S s g | ]}|� � �qS r )rE )�.0r3 r r r � <listcomp> s z>InventoryModule._parse_variable_definition.<locals>.<listcomp>r9 zExpected key=value, got: %sN)�split� _parse_valuer6 )r r2 r] r^ r r r rQ s z*InventoryModule._parse_variable_definitionc C s� zt |dd�}W n ty# } z| �d||f � W Y d}~nd}~ww | �|d �\}}i }|dd� D ] }d|vrB| �d| � |�dd�\}} | �| �||< q5|||fS ) z� Takes a single line and tries to parse it as a host definition. Returns a list of Hosts if successful, or raises an error. T)�commentsz&Error parsing host definition '%s': %sNr r9 re z4Expected key=value host variable assignment, got: %s)r � ValueErrorr6 �_expand_hostpatternrh ri ) r r2 �tokensr3 � hostnamesr[ r\ �tr] r^ r r r rO s �� z&InventoryModule._parse_host_definitionc s` t t| ��|�\}}|�� �d�r|du rtd| ��|D ]}|�� dkr+td| ��q ||fS )z= do some extra checks over normal processing r= NzoInvalid host pattern '%s' supplied, ending in ':' is not allowed, this character is reserved to provide a port.z---zQInvalid host pattern '%s' supplied, '---' is normally a sign this is a YAML file.)r r rl rE rN r )r � hostpatternrn r[ �patternr r r rl ? s � �z#InventoryModule._expand_hostpatternc C st z!t �� � t �dt� t�| �} W d � n1 sw Y W n ty* Y n ty2 Y nw t| ddd�S )z� Attempt to transform the string value from an ini file into a basic python object (int, dict, list, unicode string, etc). �ignoreN�passthrur )� nonstringr ) �warnings�catch_warnings� simplefilter� SyntaxWarning�ast� literal_evalrk � SyntaxErrorr )r^ r r r ri Q s �� �z InventoryModule._parse_valuec C s< t �tddd�t j�| jd< t �tddd�t j�| jd< dS )z| Compiles the regular expressions required to parse the inventory and stores them in self.patterns. a� ^\[ ([^:\]\s]+) # group name (see groupname below) (?::(\w+))? # optional : and tag name \] \s* # ignore trailing whitespace (?:\#.*)? # and/or a comment till the $ # end of the line r r r: z�^ ([^:\]\s]+) \s* # ignore trailing whitespace (?:\#.*)? # and/or a comment till the $ # end of the line rX N)�re�compiler �Xr r r r r rD e s � ���z!InventoryModule._compile_patterns)T)�__name__� __module__� __qualname__�__doc__�NAME� frozensetrF r& r r r6 r( rL rS rQ rO rl � staticmethodri rD � __classcell__r r r r r W s" $l ! r )� __future__r � DOCUMENTATION�EXAMPLESry r| ru �ansible.inventory.groupr �ansible.plugins.inventoryr �ansible.errorsr r �+ansible.module_utils.common.text.convertersr r �ansible.utils.shlexr r r r r r �<module> s +
Save
Cancel