관리-도구
편집 파일: dataclasses.cpython-39.pyc
a �)g�U � @ s� d Z ddlmZmZmZ eZddlZddlZ ddl m Z ddl m Z mZ ddlmZ ddlmZ ddlmZ e jr�dd lmZ e �d d d d �ZddlmZm Z ddl m Z ddl m Z m!Z!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z( dZ)dZ*dZ+dZ,e(� Z-dd� Z.dd� Z/d d � Z0d d � Z1d d!� Z2d"d#� Z3d$d%� Z4d&d'� Z5d(d)� Z6d*d+� Z7d,d-� Z8G d.d � d �Z9e d d/�Z:e d d0�Z;G d1d � d e9e:�Z<G d2d � d e9e;�Z=dS )3zDependency structs.� )�absolute_import�division�print_functionN)� namedtuple)�MutableSequence�MutableMapping)�iglob)�urlparse)� safe_load)�ConcreteArtifactsManager� Collection� Candidate� Requirement�_ComputedReqKindsMixin)� AnsibleError�AnsibleAssertionError)� GalaxyAPI)�to_bytes� to_native�to_text)�ArgumentSpecValidator)�AnsibleCollectionRef)�DisplayFs galaxy.ymls MANIFEST.jsons GALAXY.ymlc C s t | dd�}tj�| �s d S z8t| dd��}t|�}W d � n1 sH0 Y W nD ty� } z,t�d|� dt |dd�� �� W Y d }~d S d }~0 0 t |t �s�t�d|� d�� d S t ||||�}|� r�t�d|� d �� t�d � |�� t�d � d S |S ) N�surrogate_or_strict��errors�rb)�modez0Error getting collection source information at 'z': z ': expected a YAML dictionaryz!Ignoring source metadata file at z due to the following errors:� z@Correct the source metadata file by reinstalling the collection.) r �os�path�isfile�openr �OSError�display�warning� isinstancer � _validate_v1_source_info_schema�join) Zb_source_info_path� namespace�name�versionZsource_info_path�fd�metadata�eZ schema_errors� r/ �T/usr/lib/python3.9/site-packages/ansible/galaxy/dependency_resolution/dataclasses.py�get_validated_source_info. s* *� r1 c C s� t t dgd�t � t � t � t tt t � t � t � t � d�d�t |gd�t | gd�t |gd�d�}t|t �s�td| � d|� d|� d t|�� ���t|�}|�|�}|jS ) Nz1.0.0)�choices)Z signatureZpubkey_fingerprintZsigning_serviceZ pulp_created)�typeZ suboptions)Zformat_versionZ download_urlZ version_urlZserver� signaturesr* r) r+ z Invalid offline source info for �.�:z, expected a dict and got )�dict�listr& r r3 r ZvalidateZerror_messages)r) r* r+ Zprovided_argumentsZargument_spec_dataZ validatorZvalidation_resultr/ r/ r0 r' K s2 �� � � r' c C s" t | dd�}tj�tj�|t��S �Nr r )r r r r! r( � _GALAXY_YAML��dir_path� b_dir_pathr/ r/ r0 �_is_collection_src_diri s r> c C s" t | dd�}tj�tj�|t��S r9 )r r r r! r( �_MANIFEST_JSONr; r/ r/ r0 � _is_installed_collection_dirn s r@ c C s t | �pt| �S �N)r@ r> )r< r/ r/ r0 �_is_collection_dirs s �rB c c sf t | dd�}tj�|d�}t|�D ]>}tj�tj�|t��rD|V q"tj�tj�|t��r"|V q"d S )Nr r � *)r r r r( r r! r? r: )r< r= Zsubdir_glob_patternZsubdirr/ r/ r0 � _find_collections_in_subdirsz s � rD c C s t t| ��S rA )�anyrD �Z tested_strr/ r/ r0 � _is_collection_namespace_dir� s rG c C s t j�t| dd��S r9 )r r r! r rF r/ r/ r0 � _is_file_path� s rH c C s t | �j�� dv S )N> �https�http)r �scheme�lowerrF r/ r/ r0 � _is_http_url� s rM c C s | � d�S )N)zgit+zgit@)� startswithrF r/ r/ r0 � _is_git_url� s rO c s t � fdd�tttttfD ��S )Nc 3 s | ]}|� �V qd S rA r/ )�.0� predicaterF r/ r0 � <genexpr>� s �z0_is_concrete_artifact_pointer.<locals>.<genexpr>)rE rO rM rH rB rG rF r/ rF r0 � _is_concrete_artifact_pointer� s ��rS c @ s6 e Zd ZdZdd� Zdd� Zdd� Zedd � �Zed d � �Z ed d � �Z edd� �Z ed:dd��Z dd� Z dd� Zdd� Zedd� �Zdd � Zd d � Zed d � �Zed!d"� �Zed#d$� �Zed%d&� �Zed'd(� �Zed)d*� �Zed+d,� �Zed-d.� �Zed/d0� �Z ed1d2� �Z ed3d4� �Z ed5d6� �Z ed7d8� �Z d9S );r )�fqcn�ver�srcr3 c O s< | j sd | _n*| �t| jdd��}t|| j| j| j�| _d S r9 ) � may_have_offline_galaxy_info� _source_info�construct_galaxy_info_pathr rV r1 r) r* rU )�self�args�kwargsZ info_pathr/ r/ r0 �__init__� s �z _ComputedReqKindsMixin.__init__c s t t� fdd�tjD ���S )Nc 3 s | ]}t � |�V qd S rA )�getattr)rP �attr�rZ r/ r0 rR � � z2_ComputedReqKindsMixin.__hash__.<locals>.<genexpr>)�hash�tupler � UNIQUE_ATTRSr` r/ r` r0 �__hash__� s z _ComputedReqKindsMixin.__hash__c C s t | �t |�kS rA )rb )rZ � candidater/ r/ r0 �__eq__� s z _ComputedReqKindsMixin.__eq__c C sP t j�|�s tdjt|�d���z| �||�W S tyJ | �|� Y S 0 dS )a� Make collection from an unspecified dir type. This alternative constructor attempts to grab metadata from the given path if it's a directory. If there's no metadata, it falls back to guessing the FQCN based on the directory path and sets the version to "*". It raises a ValueError immediately if the input is not an existing directory path. z1The collection directory '{path!s}' doesn't exist�r N)r r �isdir� ValueError�formatr � from_dir_path�from_dir_path_implicit)�clsr< �art_mgrr/ r/ r0 �from_dir_path_as_unknown� s �� z/_ComputedReqKindsMixin.from_dir_path_as_unknownc C s� t |dd�}t|�sBt�djtt�tt�t|dd�d�� td��| dd|dd�}|� |�}z|� |�}W nd t y� } zLt�djtt�tt�t|dd�d�� td jt|dd�d ��|�W Y d}~n d}~0 0 | |||dd�S ) z0Make collection from an directory with metadata.r r zrCollection at '{path!s}' does not have a {manifest_json!s} file, nor has it {galaxy_yml!s}: cannot detect version.)� galaxy_yml� manifest_jsonr zJ`dir_path` argument must be an installed or a source collection directory.N�dirziCollection at '{path!s}' has a {manifest_json!s} or {galaxy_yml!s} file but it contains invalid metadata.z-Collection at '{path!s}' has invalid metadatarh ) r rB r$ r% rk r r: r? rj � get_direct_collection_version�get_direct_collection_fqcn� TypeError)rn r< ro r= � tmp_inst_req� req_version�req_name�errr/ r/ r0 rl � s@ �� � �� ���z$_ComputedReqKindsMixin.from_dir_pathc C s< t |dd�}|�tjj�}d�|dd� �}| |d|dd�S )a Construct a collection instance based on an arbitrary dir. This alternative constructor infers the FQCN based on the parent and current directory names. It also sets the version to "*" regardless of whether any of known metadata files are present. r r r5 ���N�*rs )r �splitr r �sepr( )rn r< Z u_dir_path� path_listry r/ r/ r0 rm s z-_ComputedReqKindsMixin.from_dir_path_implicitc C sP i }t |�r||d< n&|�d�\|d< }|d< |d s<|d= ||d< | �||�S )Nr* r6 r+ r4 )rS � partition�from_requirement_dict)rn Zcollection_inputZartifacts_managerZsupplemental_signaturesZreqZ_sepr/ r/ r0 � from_string s z"_ComputedReqKindsMixin.from_stringTc C s� |� dd �}|� dd�}|� d�}|� dd �}|� dd �}|d urx|r`|jd u r`td|� d���t|t�sp|g}t|�}|d u �rBtr�|d ur�t|�r�|} n�|d ur�t� |�r�d }n�|d ur�t|�r�|d } }nrd } |d ur�t j � |�r�| j |d �} n<|d u�r t j � |��r | j |d �} n|�r.d � |�} nd } tdj | d���|d u �r�t| ��r`d}| }n�t| ��rtd}| }n�t| ��r�d}| }nlt| ��r�t| ��r�t| ��r�tdj t| dd�tt�tt�d���d}| }n t| ��r�d }d}| }ntd��|dv�rtd��|d u �r"|d k�r"td ��|d k�r@|d u �r@|d }}|d k�rtt|t��rtt|j��sttd j |jd ���| |||||�} |d v�r�|d u �r�|�| �}|d v�r�|dk�r�|�| �}| |||||�S ) Nr* r+ r| r3 �sourcer4 z#Signatures were provided to verify z but no keyring was configured.�galaxyu� Tip: Make sure you are pointing to the right subdirectory — `{src!s}` looks like a directory but it is neither a collection, nor a namespace dir.)rV z Could not find {0}.� aM Neither the collection requirement entry key 'name', nor 'source' point to a concrete resolvable collection artifact. Also 'name' is not an FQCN. A valid collection name must be in the format <namespace>.<collection>. Please make sure that the namespace and the collection name contain characters from [a-zA-Z0-9_] only.{extra_tip!s})Z extra_tip�git�url�filez�Collection requirement at '{path!s}' has both a {manifest_json!s} file and a {galaxy_yml!s}. The requirement must either be an installed collection directory or a source collection directory, not both.r r )r rr rq rs �subdirsz?Failed to automatically detect the collection requirement type.> r� r� rs r� r� r� zcThe collection requirement entry key 'type' must be one of file, galaxy, git, dir, subdirs, or url.znCollections requirement entry should contain the key 'name' if it's requested from a Galaxy-like index server.z}Collections requirement 'source' entry should contain a valid Galaxy API URL but it does not: {not_url!s} is not an HTTP URL.)Znot_url> r� r� ) �getZkeyringr r& r � frozenset�!_ALLOW_CONCRETE_POINTER_IN_SOURCErS r Zis_valid_collection_namer r ri rk rO rM rH rB r@ r> r r? r: rG r Z api_serverru rt ) rn Zcollection_reqro Zvalidate_signature_optionsry rx Zreq_typeZ req_sourceZreq_signature_sourcesZsrc_pathZ dir_tip_tmplZtiprw r/ r/ r0 r� ! s� � ������� � �� �� � �� ����� �z,_ComputedReqKindsMixin.from_requirement_dictc C s dj | | j| jpdd�S )Nz-<{self!s} of type {coll_type!r} from {src!s}>ZGalaxy)rZ Z coll_typerV )rk r3 rV r` r/ r/ r0 �__repr__� s ��z _ComputedReqKindsMixin.__repr__c C s t | �� �S rA )r � __unicode__r` r/ r/ r0 �__str__� s z _ComputedReqKindsMixin.__str__c C sB | j d u r(| jr | j� d�S | j� d�S djt| j �t| j�d�S )Nz collection from a Git repoz collection from a namespacez{fqcn!s}:{ver!s})rT rU )rT �is_scmr3 rk r rU r` r/ r/ r0 r� � s ���z"_ComputedReqKindsMixin.__unicode__c C s0 | j d u rdS | jr(| jd u s(t| j�s,dS dS )NFT)rT �is_dirrV rB r` r/ r/ r0 rW � s z3_ComputedReqKindsMixin.may_have_offline_galaxy_infoc C s� | j s| jdkstd��t|dd�}|�ttjj��dd� }ttjj��|�}t| j � d| j � d| j � d �dd�}tj�||t �S ) Nr� zHOnly installed collections from a Galaxy server have offline Galaxy infor r r r{ r5 �-z.info) rW r3 rv r r} r r r~ r( r) r* rU �_SOURCE_METADATA_FILE)rZ Zb_collection_pathZb_srcZ b_path_partsZb_metadata_dirZ b_dir_namer/ r/ r0 rY � s $z1_ComputedReqKindsMixin.construct_galaxy_info_pathc C s | j �d�S )Nr5 )rT r} r` r/ r/ r0 �_get_separate_ns_n_name� s z._ComputedReqKindsMixin._get_separate_ns_n_namec C s" | j rt| j� d���| �� d S )Nz$ collections do not have a namespacer �� is_virtualrv r3 r� r` r/ r/ r0 r) � s z _ComputedReqKindsMixin.namespacec C s" | j rt| j� d���| �� d S )Nz collections do not have a name���r� r` r/ r/ r0 r* � s z_ComputedReqKindsMixin.namec C s* | j st| j�S djt| j�t| j�d�S )Nz5<virtual namespace from {src!s} of type {src_type!s}>)rV Zsrc_type)r� r rT rk rV r3 r` r/ r/ r0 �canonical_package_id� s ��z+_ComputedReqKindsMixin.canonical_package_idc C s | j p | jS rA )r� � is_subdirsr` r/ r/ r0 r� � s z!_ComputedReqKindsMixin.is_virtualc C s | j dkS )Nr� �r3 r` r/ r/ r0 �is_file� s z _ComputedReqKindsMixin.is_filec C s | j dkS )Nrs r� r` r/ r/ r0 r� s z _ComputedReqKindsMixin.is_dirc C s dd� t | j�D �S )Nc S s g | ] }t |��qS r/ )r )rP r r/ r/ r0 � <listcomp> s �zE_ComputedReqKindsMixin.namespace_collection_paths.<locals>.<listcomp>)rD rV r` r/ r/ r0 �namespace_collection_paths s �z1_ComputedReqKindsMixin.namespace_collection_pathsc C s | j dkS )Nr� r� r` r/ r/ r0 r� s z!_ComputedReqKindsMixin.is_subdirsc C s | j dkS )Nr� r� r` r/ r/ r0 �is_url s z _ComputedReqKindsMixin.is_urlc C s | j dkS )Nr� r� r` r/ r/ r0 r� s z _ComputedReqKindsMixin.is_scmc C s | j dv S )N> r� r� rs r� r� r� r` r/ r/ r0 �is_concrete_artifact s z+_ComputedReqKindsMixin.is_concrete_artifactc C s | j S rA )r� r` r/ r/ r0 �is_online_index_pointer s z._ComputedReqKindsMixin.is_online_index_pointerc C s | j S rA )rX r` r/ r/ r0 � source_info s z"_ComputedReqKindsMixin.source_infoN)T)!�__name__� __module__� __qualname__rd r] re rg � classmethodrp rl rm r� r� r� r� r� �propertyrW rY r� r) r* r� r� r� r� r� r� r� r� r� r� r� r/ r/ r/ r0 r � s` ( )rT rU rV r3 Zsignature_sources)rT rU rV r3 r4 c s( e Zd ZdZdd� Z� fdd�Z� ZS )r z An abstract requirement request.c O s t j| g|�R i |��}|S rA )�RequirementNamedTuple�__new__�rn r[ r\ rZ r/ r/ r0 r� 1 s zRequirement.__new__c s t t| ��� d S rA )�superr r] �rZ r[ r\ �� __class__r/ r0 r] 5 s zRequirement.__init__)r� r� r� �__doc__r� r] � __classcell__r/ r/ r� r0 r + s c s0 e Zd ZdZdd� Z� fdd�Zdd� Z� ZS )r z:A concrete collection candidate with its version resolved.c O s t j| g|�R i |��}|S rA )�CandidateNamedTupler� r� r/ r/ r0 r� ? s zCandidate.__new__c s t t| ��� d S rA )r� r r] r� r� r/ r0 r] C s zCandidate.__init__c C sX | j dkrtd| �d���| j�| j| j| j�}| �| j| j| j| j t g | j �|���S )z�Populate a new Candidate instance with Galaxy signatures. :raises AnsibleAssertionError: If the supplied candidate is not sourced from a Galaxy-like index. r� z Invalid collection type for z0: unable to get signatures from a galaxy server.) r3 r rV Zget_collection_signaturesr) r* rU r� rT r� r4 )rZ r4 r/ r/ r0 �with_signatures_repopulatedF s z%Candidate.with_signatures_repopulated)r� r� r� r� r� r] r� r� r/ r/ r� r0 r 9 s )>r� Z __future__r r r r3 Z __metaclass__r �typing�t� collectionsr �collections.abcr r �globr � urllib.parser Zyamlr � TYPE_CHECKINGZ3ansible.galaxy.collection.concrete_artifact_managerr �TypeVarr Zansible.errorsr r Zansible.galaxy.apir Zansible.module_utils._textr r r Z$ansible.module_utils.common.arg_specr Z ansible.utils.collection_loaderr Zansible.utils.displayr r� r: r? r� r$ r1 r' r> r@ rB rD rG rH rM rO rS r r� r� r r r/ r/ r/ r0 �<module> sh � � �