GitHub

ProcessWorker

API reference for ProcessWorker.

A worker running python <args> (executable defaults to this interpreter), in cwd with env (default: this process's).

Attributes

AttributeTypeDescription
args= tuple(args)
executable= executable
cwd= cwd
env= env

Functions

__init__

__init__(args, *, executable=None, cwd=None, env=None) -> None
ParameterTypeDescription
argsSequence[str]
executablestr | None = None
cwdstr | os.PathLike[str] | None = None
envMapping[str, str] | None = None
def __init__(
    self,
    args: Sequence[str],
    *,
    executable: str | None = None,
    cwd: str | os.PathLike[str] | None = None,
    env: Mapping[str, str] | None = None,
) -> None:
    self.args = tuple(args)
    self.executable = executable
    self.cwd = cwd
    self.env = env

start

start() -> WorkerPort

Returns WorkerPort

def start(self) -> WorkerPort:
    parent, child = socket.socketpair()
    try:
        env = dict(os.environ if self.env is None else self.env)
        env[CHANNEL_ENV] = str(child.fileno())
        env[PARENT_ENV] = str(os.getpid())
        popen = subprocess.Popen(
            [self.executable or sys.executable, *self.args],
            pass_fds=(child.fileno(),),
            env=env,
            cwd=self.cwd,
        )
    except BaseException:
        parent.close()
        raise
    finally:
        child.close()
    return _ProcessWorkerPort(popen, parent)