Class _PipSession

pex/resolver.py:292–523

@attr.s(frozen=True)
class _PipSession(object):
    requests = attr.ib(converter=_uniqued_download_requests)  # type: Tuple[DownloadRequest, ...]
    direct_requirements = attr.ib()  # type: Iterable[ParsedRequirement]
    allow_prereleases = attr.ib(default=False)  # type: bool
    transitive = attr.ib(default=True)  # type: bool
    package_index_configuration = attr.ib(default=None)  # type: Optional[PackageIndexConfiguration]
    build_configuration = attr.ib(default=BuildConfiguration())  # type: BuildConfiguration
    observer = attr.ib(default=None)  # type: Optional[ResolveObserver]
    pip_log = attr.ib(default=None)  # type: Optional[PipLog]
    pip_version = attr.ib(default=None)  # type: Optional[PipVersionValue]
    resolver = attr.ib(default=None)  # type: Optional[Resolver]
    dependency_configuration = attr.ib(
        default=DependencyConfiguration()
    )  # type: DependencyConfiguration

    def iter_local_projects(self):
        # type: () -> Iterator[BuildRequest]
        for requirement in self.direct_requirements:
            if isinstance(requirement, LocalProjectRequirement):
                for request in self.requests:
                    yield BuildRequest.for_directory(
                        target=request.target,
                        source_path=requirement.path,
                        editable=requirement.editable,
                    )

    def generate_reports(self, max_parallel_jobs=None):
        # type: (Optional[int]) -> Reports

        if not self.requests or not any(request.has_requirements for request in self.requests):
            # Nothing to report.
            return Reports()

        dest = safe_mkdtemp(
            prefix="resolver_report.", dir=safe_mkdir(CacheDir.DOWNLOADS.path(".tmp"))
        )

        log_manager = PipLogManager.create(
            self.pip_log,
            download_targets=tuple(request.download_target for request in self.requests),
        )
        if self.pip_log and not self.pip_log.user_specified:
            TRACER.log(
                "Preserving `pip install --dry-run` log at {log_path}".format(
                    log_path=self.pip_log.path
                ),
                V=ENV.PEX_VERBOSE,
            )

        spawn_report = functools.partial(
            self._spawn_report, resolved_target_dir=dest, log_manager=log_manager
        )
        with TRACER.timed(
            "Resolving for:\n  {}".format(
                "\n  ".join(request.render_description() for request in self.requests)
            )
        ):
            try: