Module tree 

TreeWorker implementation for tree-based command propagation.

Provides TreeWorker, which distributes command execution across a cluster topology using gateway nodes and propagation channels. Mirrors ClusterShell’s TreeWorker class.

The TreeWorker uses:

• PropagationTreeRouter to determine next-hop gateways
• PropagationChannel to communicate with gateway processes
• Direct SshWorker/ExecWorker for leaf nodes reachable without gateways

Structs

TarExtractError

Error raised when rcopy tar extraction fails.

TreeWorker

Worker that distributes command execution across a cluster topology.

TreeWorkerConfig

Configuration for tree-based execution.

Enums

TarExtractFilter

Explicit trust level for tar extraction (PEP 706 filter= port).

TreeWorkerEvent

Result from a remote node received through the tree.

Constants

SNAME_STDERR

SNAME_STDERR equivalent: stream name attributed to stderr data.

SNAME_STDOUT

SNAME_STDOUT equivalent: stream name attributed to stdout data.

TAR_CMD_FMT

Remote tar|base64 command format for tree rcopy (TAR_CMD_FMT).

UNTAR_CMD_FMT

Remote untar command format for forward tree copy (UNTAR_CMD_FMT).

Functions

extract_tar

Extract a ustar archive into dest with explicit trust semantics.

shell_escape_single_quoted

Escape a string for inclusion between single quotes in a shell command.

tar_command

Build the remote tar|base64 command used for tree rcopy.

untar_command

Build the remote untar command used for forward tree copy.