Class PEX

pex/pex.py:136–897

PEX, n. A self-contained python environment.

class PEX(object):  # noqa: T000
    """PEX, n.

    A self-contained python environment.
    """

    class Error(Exception):
        pass

    class NotFound(Error):
        pass

    class InvalidEntryPoint(Error):
        pass

    class ResourceBindingError(Error):
        pass

    @classmethod
    def _resolve_resource_path(
        cls,
        name,  # type: str
        resource,  # type: str
    ):
        # type: (...) -> str

        rel_path = os.path.normpath(os.path.join(*resource.split("/")))
        if os.path.isabs(resource) or rel_path.startswith(os.pardir):
            raise cls.ResourceBindingError(
                "The following resource binding spec is invalid: {name}={resource}\n"
                "The resource path {resource} must be relative to the `sys.path`.".format(
                    name=name, resource=resource
                )
            )

        for entry in sys.path:
            value = os.path.join(entry, rel_path)
            if os.path.isfile(value):
                return value

        raise cls.ResourceBindingError(
            "There was no resource file {resource} found on the `sys.path` corresponding to "
            "the given resource binding spec `{name}={resource}`".format(
                resource=resource, name=name
            )
        )

    @classmethod
    def _clean_environment(cls, env=None, strip_pex_env=True):
        if not strip_pex_env:
            return
        env = env or os.environ
        for key in list(env):
            if key and key.startswith("PEX_"):
                del env[key]

    def __init__(
        self,