Function download_wheel

etc/scripts/utils_thirdparty.py:240–283

Download the wheels binary distribution(s) of package ``name`` and ``version`` matching the ``environment`` Environment constraints into the ``dest_dir`` directory. Return a list of fetched_wheel_filenames, possibly empty. Use the first PyPI simple repository from a list of ``r

(name, version, environment, dest_dir=THIRDPARTY_DIR, repos=tuple())

def download_wheel(name, version, environment, dest_dir=THIRDPARTY_DIR, repos=tuple()):
    """
    Download the wheels binary distribution(s) of package ``name`` and
    ``version`` matching the ``environment`` Environment constraints into the
    ``dest_dir`` directory. Return a list of fetched_wheel_filenames, possibly
    empty.

    Use the first PyPI simple repository from a list of ``repos`` that contains this wheel.
    """
    if TRACE_DEEP:
        print(f"  download_wheel: {name}=={version} for envt: {environment}")

    if not repos:
        repos = DEFAULT_PYPI_REPOS

    fetched_wheel_filenames = []

    for repo in repos:
        package = repo.get_package_version(name=name, version=version)
        if not package:
            if TRACE_DEEP:
                print(f"    download_wheel: No package in {repo.index_url} for {name}=={version}")
            continue
        supported_wheels = list(package.get_supported_wheels(environment=environment))
        if not supported_wheels:
            if TRACE_DEEP:
                print(
                    f"    download_wheel: No supported wheel for {name}=={version}: {environment} "
                )
            continue

        for wheel in supported_wheels:
            if TRACE_DEEP:
                print(
                    f"    download_wheel: Getting wheel from index (or cache): {wheel.download_url}"
                )
            fetched_wheel_filename = wheel.download(dest_dir=dest_dir)
            fetched_wheel_filenames.append(fetched_wheel_filename)

        if fetched_wheel_filenames:
            # do not futher fetch from other repos if we find in first, typically PyPI
            break

    return fetched_wheel_filenames


def download_sdist(name, version, dest_dir=THIRDPARTY_DIR, repos=tuple()):