Function install_wheel

pex/pep_427.py:835–1167

(
    wheel,  # type: InstallableWheel
    install_paths,  # type: InstallPaths
    copy_mode=CopyMode.LINK,  # type: CopyMode.Value
    interpreter=None,  # type: Optional[PythonInterpreter]
    rel_extra_path=None,  # type: Optional[str]
    compile=False,  # type: bool
    requested=True,  # type: bool
    install_entry_point_scripts=True,  # type: bool
    record_entry_info=False,  # type: bool
    normalize_file_stat=False,  # type: bool
    re_hash=False,  # type: bool
    hermetic_scripts=False,  # type: bool
)

def install_wheel(
    wheel,  # type: InstallableWheel
    install_paths,  # type: InstallPaths
    copy_mode=CopyMode.LINK,  # type: CopyMode.Value
    interpreter=None,  # type: Optional[PythonInterpreter]
    rel_extra_path=None,  # type: Optional[str]
    compile=False,  # type: bool
    requested=True,  # type: bool
    install_entry_point_scripts=True,  # type: bool
    record_entry_info=False,  # type: bool
    normalize_file_stat=False,  # type: bool
    re_hash=False,  # type: bool
    hermetic_scripts=False,  # type: bool
):
    # type: (...) -> Tuple[Tuple[Text, Text], ...]

    # See: https://packaging.python.org/en/latest/specifications/binary-distribution-format/#installing-a-wheel-distribution-1-0-py32-none-any-whl

    dest = install_paths.purelib if wheel.root_is_purelib else install_paths.platlib
    if rel_extra_path:
        dest = os.path.join(dest, rel_extra_path)
        if wheel.root_is_purelib:
            install_paths = attr.evolve(install_paths, purelib=dest)
        else:
            install_paths = attr.evolve(install_paths, platlib=dest)

    data_dir = None  # type: Optional[str]
    if wheel.is_whl:
        whl = wheel.location
        zip_metadata = None  # type: Optional[ZipMetadata]
        with open_zip(whl) as zf:
            # 1. Unpack
            zf.extractall(dest)
            data_dir = os.path.join(dest, wheel.data_dir)
            if record_entry_info:
                zip_metadata = ZipMetadata.from_zip(
                    filename=whl, info_list=zf.infolist(), normalize_file_stat=normalize_file_stat
                )

            # TODO(John Sirois): Consider verifying signatures.
            # N.B.: Pip does not and its also not clear what good this does. A zip can be easily
            # poked on a per-entry basis allowing forging a RECORD entry and its associated file.
            # Only an outer fingerprint of the whole wheel really solves this sort of tampering.

        unpacked_wheel = Wheel.load(dest, project_name=wheel.project_name, known_tags=wheel.tags)
        wheel = InstallableWheel(
            wheel=unpacked_wheel,
            install_paths=InstallPaths.wheel(dest, wheel=unpacked_wheel),
            zip_metadata=zip_metadata,
        )

        # Deal with bad whl `RECORD`s. We happen to hit one from selenium-4.1.2-py3-none-any.whl
        # in our tests. The selenium >=4,<4.1.3 wheels are all published with absolute paths for
        # all the .py file RECORD entries. The .dist-info and .data entries are fine though.
        record_data = wheel.metadata_files.read("RECORD")

        record_lines = []  # type: List[Text]
        eol = os.sep