subprocess
最后更新
modelconverter.utils.subprocess转换使用的外部命令的执行。转换通过命令行工具驱动供应商工具链。这里的辅助函数运行此类命令,将其输出流式传输到日志(删除 ANSI 转义序列),并记录整个进程树的峰值内存使用量和挂钟运行时间。类
SubprocessHandle
方法
init
Python
1def __init__(cmd: str | Sequence[PathType], *, silent: bool = False, timeout: float | None = None):cmd(str | Sequence[PathType]): 要执行的命令。如果给定字符串,它将按空格分割。如果给定列表,每个元素将转换为字符串。silent(bool): 如果为True,则抑制来自命令的所有输出。timeout(float | None): 如果给定,则为允许进程运行的最大时间(秒)。超时超出时会引发subprocess.TimeoutExpired-- 从真值测试(也会终止进程)或从wait(使其继续运行)。
is_suspended
Python
1def is_suspended(self) -> bool:poll
Python
1def poll(self) -> int | None:int | None: 返回码,如果进程仍在运行则为None。
result
Python
1def result(self) -> SubprocessResult:SubprocessResult: 命令的结果,包含其捕获的输出、峰值内存使用量和总运行时间。
subprocess.SubprocessError: 如果命令以非零返回码完成。
resume
Python
1def resume(self):suspend
Python
1def suspend(self):wait
Python
1def wait(timeout: float | None = None) -> int:timeout(float | None): 最大等待时间(秒)。如果创建句柄时已给定超时,则忽略此参数。
int: 进程的返回码。
subprocess.TimeoutExpired: 如果进程未在超时时间内完成。与真值测试不同,这会使进程继续运行。
属性
proc
subprocess.Popen 对象。引发RuntimeError: 如果进程尚未启动。
ps_proc
psutil.Process。引发RuntimeError: 如果进程尚未启动。
SubprocessResult
subprocess.CompletedProcess 的扩展,也包含峰值内存使用量。方法
init
Python
1def __init__(*args, peak_memory: int, total_time: float, **kwargs):*args: 传递给subprocess.CompletedProcess的位置参数。peak_memory(int): 进程及其子进程的峰值内存使用量,以字节为单位。total_time(float): 进程的挂钟运行时间,以秒为单位。**kwargs: 传递给subprocess.CompletedProcess的关键字参数。
属性
peak_memory
total_time
函数
strip_ansi
Python
1def strip_ansi(s: str) -> str:示例
Pycon
1>>> strip_ansi("\x1b[31mred\x1b[0m")
2'red's(str): 要剥离的字符串。
str: 不带 ANSI 转义序列的字符串。
subprocess_run
Python
1def subprocess_run(cmd: str | Sequence[PathType], *, silent: bool = False, timeout: float | None = None) -> SubprocessResult:cmd(str | Sequence[PathType]): 要执行的命令。如果给定字符串,它将按空格分割。如果给定列表,每个元素将转换为字符串。silent(bool): 如果为True,则抑制来自命令的所有输出。timeout(float | None): 如果给定,则为允许进程运行的最大时间(秒)。如果超时超出,进程将被终止并引发subprocess.TimeoutExpired。
SubprocessResult: 命令的结果。