595413d113
PR #72591 This change: * Adds an artifacts manager that abstracts away extracting the metadata from artifacts, downloading and caching them in a temporary location. * Adds `resolvelib` to direct ansible-core dependencies[0]. * Implements a `resolvelib`-based dependency resolver for `collection` subcommands that replaces the legacy in-house code. This is a dependency resolution library that pip 20.3+ uses by default. It's now integrated for use for the collection dependency resolution in ansible-galaxy CLI. * Refactors of the `ansible-galaxy collection` CLI. In particular, it: - reimplements most of the `download`, `install`, `list` and `verify` subcommands from scratch; - reuses helper bits previously moved out into external modules; - replaces the old in-house resolver with a more clear implementation based on the resolvelib library[0][1][2]. * Adds a multi Galaxy API proxy layer that abstracts accessing the version and dependencies via API or local artifacts manager. * Makes `GalaxyAPI` instances sortable. * Adds string representation methods to `GalaxyAPI`. * Adds dev representation to `GalaxyAPI`. * Removes unnecessary integration and unit tests. * Aligns the tests with the new expectations. * Adds more tests, integration ones in particular. [0]: https://pypi.org/p/resolvelib [1]: https://github.com/sarugaku/resolvelib [2]: https://pradyunsg.me/blog/2020/03/27/pip-resolver-testing Co-Authored-By: Jordan Borean <jborean93@gmail.com> Co-Authored-By: Matt Clay <matt@mystile.com> Co-Authored-By: Sam Doran <sdoran@redhat.com> Co-Authored-By: Sloane Hertel <shertel@redhat.com> Co-Authored-By: Sviatoslav Sydorenko <webknjaz@redhat.com> Signed-Off-By: Sviatoslav Sydorenko <webknjaz@redhat.com>
50 lines
1.9 KiB
Python
50 lines
1.9 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright: (c) 2020-2021, Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
"""Dependency resolution machinery."""
|
|
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
try:
|
|
from typing import TYPE_CHECKING
|
|
except ImportError:
|
|
TYPE_CHECKING = False
|
|
|
|
if TYPE_CHECKING:
|
|
from typing import Iterable
|
|
from ansible.galaxy.api import GalaxyAPI
|
|
from ansible.galaxy.collection.concrete_artifact_manager import (
|
|
ConcreteArtifactsManager,
|
|
)
|
|
from ansible.galaxy.dependency_resolution.dataclasses import Candidate
|
|
|
|
from ansible.galaxy.collection.galaxy_api_proxy import MultiGalaxyAPIProxy
|
|
from ansible.galaxy.dependency_resolution.providers import CollectionDependencyProvider
|
|
from ansible.galaxy.dependency_resolution.reporters import CollectionDependencyReporter
|
|
from ansible.galaxy.dependency_resolution.resolvers import CollectionDependencyResolver
|
|
|
|
|
|
def build_collection_dependency_resolver(
|
|
galaxy_apis, # type: Iterable[GalaxyAPI]
|
|
concrete_artifacts_manager, # type: ConcreteArtifactsManager
|
|
preferred_candidates=None, # type: Iterable[Candidate]
|
|
with_deps=True, # type: bool
|
|
with_pre_releases=False, # type: bool
|
|
): # type: (...) -> CollectionDependencyResolver
|
|
"""Return a collection dependency resolver.
|
|
|
|
The returned instance will have a ``resolve()`` method for
|
|
further consumption.
|
|
"""
|
|
return CollectionDependencyResolver(
|
|
CollectionDependencyProvider(
|
|
apis=MultiGalaxyAPIProxy(galaxy_apis, concrete_artifacts_manager),
|
|
concrete_artifacts_manager=concrete_artifacts_manager,
|
|
preferred_candidates=preferred_candidates,
|
|
with_deps=with_deps,
|
|
with_pre_releases=with_pre_releases,
|
|
),
|
|
CollectionDependencyReporter(),
|
|
)
|