taolib.testing.remote.probe_models

远端探测模型与可配置项。

该模块专注于“数据与配置”，不包含任何网络/远端执行逻辑，便于复用与测试。

Attributes

DEFAULT_TOOLS_ENV_CMD
DEFAULT_CONDA_ACTIVATE_CMD
DEFAULT_PROBE_CMD
DEFAULT_ENCODING

Classes

RemoteProbeReport	远端探测结果。
RemoteProbeCommands	远端探测使用的命令集合。
RemoteProbeRunOptions	远端命令执行选项与错误处理策略。

Module Contents

taolib.testing.remote.probe_models.DEFAULT_TOOLS_ENV_CMD

taolib.testing.remote.probe_models.DEFAULT_CONDA_ACTIVATE_CMD

taolib.testing.remote.probe_models.DEFAULT_PROBE_CMD

taolib.testing.remote.probe_models.DEFAULT_ENCODING

class taolib.testing.remote.probe_models.RemoteProbeReport

远端探测结果。

语义约定： - conda_available=False 时，不会尝试执行 probe_cmd（probe_attempted=False, probe_ok=None）。 - conda_available=True 且 probe_attempted=True 时，probe_ok 表示探测命令退出状态是否成功。

uname: str

conda_available: bool

probe_attempted: bool

probe_ok: bool | None

class taolib.testing.remote.probe_models.RemoteProbeCommands

远端探测使用的命令集合。

命令分为两类： - prefix 命令：tools_env_cmd、conda_activate_cmd，会在同一执行上下文中叠加生效； - 常规命令：uname_cmd、check_conda_cmd、probe_cmd，会在远端依次运行。

tools_env_cmd: str

conda_activate_cmd: str

probe_cmd: str

check_conda_cmd: str = 'command -v conda'

uname_cmd: str = 'uname -a'

class taolib.testing.remote.probe_models.RemoteProbeRunOptions

远端命令执行选项与错误处理策略。

encoding 与 run_kwargs 会被合并用于 Connection.run(...)。 raise_on_* 用于控制缺少 conda 或 probe 失败时，是返回结构化结果还是抛出异常。 timeout 用于设置命令执行超时时间（秒）。 retry 用于设置命令执行失败时的最大重试次数。 retry_delay 用于设置重试间隔时间（秒）。

encoding: str

run_kwargs: collections.abc.Mapping[str, Any] | None = None

raise_on_conda_missing: bool = False

raise_on_probe_failure: bool = False

timeout: int | None = None

retry: int = 0

retry_delay: float = 1.0

merged_run_kwargs() → dict[str, Any]