관리-도구
편집 파일: ini.cpython-39.opt-1.pyc
a �)g5D � @ s� d dl mZmZmZ eZdZdZd dlZd dl Z d dl m Z d dl m Z d dlmZmZ d dlmZmZ d d lmZ G d d � d e �ZdS ) � )�absolute_import�division�print_functionae 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. Zini)�;�#)� ;� #c s t t| ��� i | _d | _d S )N)�superr �__init__�patterns� _filename��self�� __class__� �A/usr/lib/python3.9/site-packages/ansible/plugins/inventory/ini.pyr ` s zInventoryModule.__init__Tc s t t| ��|||� || _z�| jr4| j�|�\}}n>t|dd�}t|d��}|�� }W d � n1 sh0 Y zt |dd�� � } W nT t y� g } |� � D ]4} | r�| d | j v r�| � d� q�| � t | dd�� q�Y n0 | �|| � W n. t�y } zt| ��W Y d } ~ n d } ~ 0 0 d S )N�surrogate_or_strict��errors�rbr � )r r �parser �loaderZ_get_file_contentsr �open�readr � splitlines� UnicodeError�b_COMMENT_MARKERS�append�_parse� Exceptionr ) r � inventoryr! �path�cacheZb_dataZprivate�b_pathZfh�data�line�er r r r g s& & zInventoryModule.parsec C s t d| j| jf | ��d S )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 rNq | jd �|�}|�r.|�� \}}t|�}|p~d}|dvr�d�|�� �}| � d||f � || j jvr�|d kr�||vr�t | j||d �||< | j � |� ||v r |d kr || d d k�r| � ||� q || d d kr ||= q n.|�d ��r\|�d��r\| � d| d d � |dk�r�| �|�\} } } | �| | || � q |d k�r�| �|�\} } | j �|| | � q |d k�r | �|�}|| j jv�r ||v�r�t | j|||gd�||< n|| d �|� n| j �||� q | � d| � q |D ]p}|| }|d d k�rltd||d |d |d f ��n2|d d k�r0td||d |d �� |d f ���q0dS )zt Populates self.groups from the given array of lines. Raises an error on any parse failure. Z ungrouped�hostsr � �section)r4 �children�vars�:z!Section [%s] has unknown type: %sr8 )r/ �state�namer: r7 �[�]zFInvalid section entry: '%s'. Please make sure that there are no spaces� zDin the section entry, and that there are no other invalid characters)r/ r: r; �parentsr? zEntered unhandled state: %sz:%s:%d: Section [%s:vars] not valid for undefined group: %sr/ r; z9%s:%d: Section [%s:children] includes undefined group: %sN)�_compile_patternsr1 �strip�_COMMENT_MARKERSr �match�groupsr �joinr3 r* �dict� add_group�_add_pending_children� startswith�endswith�_parse_host_definitionZ_populate_host_vars�_parse_variable_definitionZ set_variable�_parse_group_namer' � add_childr �pop)r r+ �linesZpending_declarations� groupnamer: r/ �m�titler4 �port� variables�k�v�child�gZdeclr r r r( � sh � "zInventoryModule._parsec C sN || d D ]6}| j �||� ||v r || d dkr | �||� q ||= d S )Nr? r: r7 )r* rN rH )r �group�pending�parentr r r rH � 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. rQ r5 z Expected group name, got: %sN)r rC rZ r3 )r r/ rR r r r rM s z!InventoryModule._parse_group_namec C sB d|v r0dd� |� 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 )rA )�.0r0 r r r � <listcomp> � z>InventoryModule._parse_variable_definition.<locals>.<listcomp>r5 zExpected key=value, got: %sN)�split� _parse_valuer3 )r r/ rV rW r r r rL s z*InventoryModule._parse_variable_definitionc C s� zt |dd�}W n6 tyF } z | �d||f � W Y d}~n d}~0 0 | �|d �\}}i }|dd� D ]8}d|vr�| �d| � |�dd�\}} | �| �||< qj|||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)Zcommentsz&Error parsing host definition '%s': %sNr r5 r] z4Expected key=value host variable assignment, got: %s)r � ValueErrorr3 �_expand_hostpatternra rb ) r r/ �tokensr0 � hostnamesrT rU �trV rW r r r rK s (z&InventoryModule._parse_host_definitionc s` t t| ��|�\}}|�� �d�r6|du r6td| ��|D ] }|�� dkr:td| ��q:||fS )z= do some extra checks over normal processing r9 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 rd rA rJ r )r Z hostpatternrf rT �patternr r r rd ? s � z#InventoryModule._expand_hostpatternc C s@ zt �| �} W n" ty Y n ty0 Y n0 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). Zpassthrur )Z nonstringr )�astZ literal_evalrc � SyntaxErrorr )rW r r r rb 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 r6 z�^ ([^:\]\s]+) \s* # ignore trailing whitespace (?:\#.*)? # and/or a comment till the $ # end of the line rQ N)�re�compiler �Xr r r r r r@ c s �� ��z!InventoryModule._compile_patterns)T)�__name__� __module__� __qualname__�__doc__�NAME� frozensetrB r& r r r3 r( rH rM rL rK rd � staticmethodrb r@ � __classcell__r r r r r W s $l ! r )Z __future__r r r �typeZ __metaclass__Z DOCUMENTATIONZEXAMPLESri rk Zansible.inventory.groupr Zansible.plugins.inventoryr Zansible.errorsr r Zansible.module_utils._textr r Zansible.utils.shlexr r r r r r �<module> s +