관리-도구
편집 파일: providers.cpython-39.pyc
a �)g�\ � @ s` d Z ddlmZmZmZ eZddlZddlZ e j rVddl m Z ddl mZ ddlmZ ddlmZ ddlmZmZ dd lmZmZ dd lmZ dd lm Z m Z z dd l m Z dd l m Z! W n$ e"y� G dd� d�Z dZ!Y n0 e d�Z#e d�Z$e �%e e!��Z&G dd� de �Z'G dd� de'�Z(G dd� de'�Z)G dd� de)�Z*G dd � d e)�Z+d d � Z,e,� Z-dS ) z Requirement provider interfaces.� )�absolute_import�division�print_functionN)�ConcreteArtifactsManager)�MultiGalaxyAPIProxy)� GalaxyAPI)�get_signature_from_source)� Candidate� Requirement)�is_pre_release�meets_requirements)� string_types)�SemanticVersion� LooseVersion)�AbstractProvider)� __version__c @ s e Zd ZdS )r N)�__name__� __module__� __qualname__� r r �R/usr/lib/python3.9/site-packages/ansible/galaxy/dependency_resolution/providers.pyr # s r z0.0.0z0.5.3z0.9.0c @ sZ e Zd ZdZddd�Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z dS )� CollectionDependencyProviderBasez<Delegate providing a requirement interface for the resolver.NTFc C sZ || _ tjtj|d�| _tdd� |p&dD ��| _t|p8d�| _|| _ || _ || _ || _ dS )aU Initialize helper attributes. :param api: An instance of the multiple Galaxy APIs wrapper. :param concrete_artifacts_manager: An instance of the caching \ concrete artifacts manager. :param with_deps: A flag specifying whether the resolver \ should attempt to pull-in the deps of the \ requested requirements. On by default. :param with_pre_releases: A flag specifying whether the \ resolver should skip pre-releases. \ Off by default. :param upgrade: A flag specifying whether the resolver should \ skip matching versions that are not upgrades. \ Off by default. :param include_signatures: A flag to determine whether to retrieve \ signatures from the Galaxy APIs and \ include signatures in matching Candidates. \ On by default. )Zart_mgrc s sB | ]:}|j s"|jd kr|j�d�st|j|j|j|jd�V qdS )�*)�<�>�!=N)�is_concrete_artifact�ver� startswithr �fqcn�src�type)�.0Zreqr r r � <genexpr>Z s �z<CollectionDependencyProviderBase.__init__.<locals>.<genexpr>r N) � _api_proxy� functools�partialr Zfrom_requirement_dict�_make_req_from_dict�set�_pinned_candidate_requests�_preferred_candidates� _with_deps�_with_pre_releases�_upgrade�_include_signatures) �selfZapisZconcrete_artifacts_managerZuser_requirementsZpreferred_candidatesZ with_depsZwith_pre_releasesZupgradeZinclude_signaturesr r r �__init__2 s #�� z)CollectionDependencyProviderBase.__init__c C s> || j v rdS |jr:|jdur:t|j|jd|jd�| j v S dS )z0Check if the candidate is requested by the user.TNF)r) Zis_online_index_pointerr r r r r! )r/ � candidater r r �_is_user_requestedj s ��z3CollectionDependencyProviderBase._is_user_requestedc C s |j S )ap Given requirement or candidate, return an identifier for it. This is used to identify a requirement or candidate, e.g. whether two requirements should have their specifier parts (version ranges or pins) merged, whether two candidates would conflict with each other (because they have same name but different versions). )Zcanonical_package_id)r/ Zrequirement_or_candidater r r �identify� s z)CollectionDependencyProviderBase.identifyc O s t �dS )a� Return sort key function return value for given requirement. This result should be based on preference that is defined as "I think this requirement should be resolved first". The lower the return value is, the more preferred this group of arguments is. resolvelib >=0.5.3, <0.7.0 :param resolution: Currently pinned candidate, or ``None``. :param candidates: A list of possible candidates. :param information: A list of requirement information. Each ``information`` instance is a named tuple with two entries: * ``requirement`` specifies a requirement contributing to the current candidate list * ``parent`` specifies the candidate that provides (dependend on) the requirement, or `None` to indicate a root requirement. resolvelib >=0.7.0, < 0.8.0 :param identifier: The value returned by ``identify()``. :param resolutions: Mapping of identifier, candidate pairs. :param candidates: Possible candidates for the identifer. Mapping of identifier, list of candidate pairs. :param information: Requirement information of each package. Mapping of identifier, list of named tuple pairs. The named tuples have the entries ``requirement`` and ``parent``. resolvelib >=0.8.0, <= 0.8.1 :param identifier: The value returned by ``identify()``. :param resolutions: Mapping of identifier, candidate pairs. :param candidates: Possible candidates for the identifer. Mapping of identifier, list of candidate pairs. :param information: Requirement information of each package. Mapping of identifier, list of named tuple pairs. The named tuples have the entries ``requirement`` and ``parent``. :param backtrack_causes: Sequence of requirement information that were the requirements that caused the resolver to most recently backtrack. The preference could depend on a various of issues, including (not necessarily in this order): * Is this package pinned in the current resolution result? * How relaxed is the requirement? Stricter ones should probably be worked on first? (I don't know, actually.) * How many possibilities are there to satisfy this requirement? Those with few left should likely be worked on first, I guess? * Are there any known conflicts for this requirement? We should probably work on those with the most known conflicts. A sortable value should be returned (this will be used as the `key` parameter of the built-in sorting function). The smaller the value is, the more preferred this requirement is (i.e. the sorting function is called with ``reverse=False``). N��NotImplementedError�r/ �args�kwargsr r r �get_preference� s Lz/CollectionDependencyProviderBase.get_preferencec s& t � fdd�|D ��r td�S t|�S )Nc 3 s | ]}|� j v V qd S �N)r* )r" r1 �r/ r r r# � s �zCCollectionDependencyProviderBase._get_preference.<locals>.<genexpr>z-inf)�any�float�len)r/ � candidatesr r; r �_get_preference� s �z0CollectionDependencyProviderBase._get_preferencec O s t �dS )a: Find all possible candidates satisfying given requirements. This tries to get candidates based on the requirements' types. For concrete requirements (SCM, dir, namespace dir, local or remote archives), the one-and-only match is returned For a "named" requirement, Galaxy-compatible APIs are consulted to find concrete candidates for this requirement. Of theres a pre-installed candidate, it's prepended in front of others. resolvelib >=0.5.3, <0.6.0 :param requirements: A collection of requirements which all of \ the returned candidates must match. \ All requirements are guaranteed to have \ the same identifier. \ The collection is never empty. resolvelib >=0.6.0 :param identifier: The value returned by ``identify()``. :param requirements: The requirements all returned candidates must satisfy. Mapping of identifier, iterator of requirement pairs. :param incompatibilities: Incompatible versions that must be excluded from the returned list. :returns: An iterable that orders candidates by preference, \ e.g. the most preferred candidate comes first. Nr4 r6 r r r � find_matches� s "z-CollectionDependencyProviderBase.find_matchesc s@ �d � � j �d}|d7 }t� }�jsH� jdkrH���fdd��jD �}z|rRg n �j�� �}W nB ty� } z*� jr�t d� � d|� ��|�� W Y d }~n d }~0 0 � j�rH|D ]�\}}d� � d |� d t|�� d |� �}t |t �s�t |��q�|d kr�z t |� W q� t �y0 } zt |�| �W Y d } ~ q�d } ~ 0 0 q�� �fd d�|D �S g �g } g } |D ]�\}} t �|| dd �} d}�D ]B}|��|| � O }|�r� �q��j�s��qx| �|j�p�g � �qx|�sX�j�r�| D ]}| �t|�� �qΈ�t �|| dt| ��� �qX�jdd� dd� |�s4����fdd��jD �}t|�� S )Nr zlA SemVer-compliant version or '*' is required. See https://semver.org to learn how to compose it correctly. z%This is an issue with the collection.Zgalaxyc s2 h | ]*� � j �krt� �fd d��D ��r� �qS )c 3 s | ]}�� |� �V qd S r: ��is_satisfied_by�r" � requirement�r1 r/ r r r# * � �KCollectionDependencyProviderBase._find_matches.<locals>.<setcomp>.<genexpr>)r �all�r" )r � requirementsr/ �r1 r � <setcomp>' s �zACollectionDependencyProviderBase._find_matches.<locals>.<setcomp>z*Invalid version found for the collection 'z'. z': z (z). r c s" g | ]\}}t �||� jd ��qS r: )r r! )r" �versionZ_none_src_server)� first_reqr r r � <listcomp>Q s �zBCollectionDependencyProviderBase._find_matches.<locals>.<listcomp>Fc S s t | j�| jfS r: )r r r rL r r r �<lambda>t s �z@CollectionDependencyProviderBase._find_matches.<locals>.<lambda>T)�key�reversec sN h | ]F� � j �krt� �fd d��D ��r�jrFt� fdd��D ��r� �qS )c 3 s | ]}�� |� �V qd S r: rB rD rF r r r# � rG rH c 3 s" | ]}t |j�t � j�kV qd S r: )r r )r" ZlatestrL r r r# � rG )r rI r- rJ )r �latest_matchesrK r/ rL r rM { s �)r r( r- r! r* r$ Zget_collection_versions� TypeErrorr � ValueError� isinstancer r r rC r. �extendZsignature_sources�appendr � frozenset�sort�list)r/ rK Z version_reqZpreinstalled_candidatesZ coll_versions�excrN Zreq_srcZ version_err�exZ signaturesZextra_signature_sourcesZ src_serverZ tmp_candidateZ unsatisfiedrE Z extra_sourcer )rO r rT rK r/ r � _find_matches sz ��� " � ���z.CollectionDependencyProviderBase._find_matchesc C s| | j p>|jdkp2|j�d�p2|j�d�p2|j�d� p>| �|�}t|j�rR|sRdS |jsh|jsh|jdkrldS t|j|jd�S )a� Whether the given requirement is satisfiable by a candidate. :param requirement: A requirement that produced the `candidate`. :param candidate: A pinned candidate supposedly matchine the \ `requirement` specifier. It is guaranteed to \ have been generated from the `requirement`. :returns: Indication whether the `candidate` is a viable \ solution to the `requirement`. r r r r FT)rN rK )r, r r r2 r � is_virtualr )r/ rE r1 Zallow_pre_releaser r r rC � s. � � ������z0CollectionDependencyProviderBase.is_satisfied_byc s2 � j �|�}� js |js g S � fdd�|�� D �S )z�Get direct dependencies of a candidate. :returns: A collection of requirements that `candidate` \ specifies as its dependencies. c s g | ]\}}� � ||d ���qS ))�namerN )r' )r" Zdep_nameZdep_reqr; r r rP � s �zECollectionDependencyProviderBase.get_dependencies.<locals>.<listcomp>)r$ Zget_collection_dependenciesr+ r` �items)r/ r1 Zreq_mapr r; r �get_dependencies� s �z1CollectionDependencyProviderBase.get_dependencies)NNNTFFT) r r r �__doc__r0 r2 r3 r9 r@ rA r_ rC rc r r r r r / s" � 8$ N $t*r c @ s e Zd Zdd� Zdd� ZdS )� CollectionDependencyProvider050c C s | � |�S r: )r_ )r/ rK r r r rA � s z,CollectionDependencyProvider050.find_matchesc C s | � |�S r: �r@ �r/ Z resolutionr? � informationr r r r9 � s z.CollectionDependencyProvider050.get_preferenceN�r r r rA r9 r r r r re � s re c @ s e Zd Zdd� Zdd� ZdS )� CollectionDependencyProvider060c s" � �fdd�| � t|� ��D �S )Nc s* g | ]"� t � fd d��� D ��s� �qS )c 3 s | ]}� j |j kV qd S r: )r )r" Zincompat��matchr r r# � rG zJCollectionDependencyProvider060.find_matches.<locals>.<listcomp>.<genexpr>)r< rJ �� identifier�incompatibilitiesrk r rP � s �z@CollectionDependencyProvider060.find_matches.<locals>.<listcomp>)r_ r\ )r/ rn rK ro r rm r rA � s �z,CollectionDependencyProvider060.find_matchesc C s | � |�S r: rf rg r r r r9 � s z.CollectionDependencyProvider060.get_preferenceNri r r r r rj � s rj c @ s e Zd Zdd� ZdS )� CollectionDependencyProvider070c C s | � t|| ��S r: �r@ r\ )r/ rn � resolutionsr? rh r r r r9 � s z.CollectionDependencyProvider070.get_preferenceN�r r r r9 r r r r rp � s rp c @ s e Zd Zdd� ZdS )� CollectionDependencyProvider080c C s | � t|| ��S r: rq )r/ rn rr r? rh Zbacktrack_causesr r r r9 � s z.CollectionDependencyProvider080.get_preferenceNrs r r r r rt � s rt c C s4 t td�krtS t td�kr tS t td�kr0tS tS )Nz0.8.0z0.7.0z0.6.0)�RESOLVELIB_VERSIONr rt rp rj re r r r r � _get_provider� s rv ).rd Z __future__r r r r! Z __metaclass__r% �typing�t� TYPE_CHECKINGZ3ansible.galaxy.collection.concrete_artifact_managerr Z*ansible.galaxy.collection.galaxy_api_proxyr Zansible.galaxy.apir Z ansible.galaxy.collection.gpgr Z0ansible.galaxy.dependency_resolution.dataclassesr r Z/ansible.galaxy.dependency_resolution.versioningr r Zansible.module_utils.sixr Zansible.utils.versionr r Z resolvelibr r Zresolvelib_version� ImportErrorZRESOLVELIB_LOWERBOUNDZRESOLVELIB_UPPERBOUNDZfrom_loose_versionru r re rj rp rt rv Z CollectionDependencyProviderr r r r �<module> s@ ,