taolib.remote.probe_models#

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

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

Attributes#

Classes#

RemoteProbeReport

远端探测结果。

RemoteProbeCommands

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

RemoteProbeRunOptions

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

Module Contents#

taolib.remote.probe_models.DEFAULT_TOOLS_ENV_CMD[源代码]#
taolib.remote.probe_models.DEFAULT_CONDA_ACTIVATE_CMD[源代码]#
taolib.remote.probe_models.DEFAULT_PROBE_CMD[源代码]#
taolib.remote.probe_models.DEFAULT_ENCODING[源代码]#
class taolib.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.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.remote.probe_models.RemoteProbeRunOptions[源代码]#

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

encoding 与 run_kwargs 会被合并用于 Connection.run(...)。 raise_on_* 用于控制缺少 conda 或 probe 失败时,是返回结构化结果还是抛出异常。

encoding: str[源代码]#
run_kwargs: collections.abc.Mapping[str, Any] | None = None[源代码]#
raise_on_conda_missing: bool = False[源代码]#
raise_on_probe_failure: bool = False[源代码]#
merged_run_kwargs() dict[str, Any][源代码]#