# subprocess

Python API: `hubai_sdk.utils.subprocess`

## 类

### SubprocessResult

subprocess.CompletedProcess 的扩展，还包含峰值内存使用量。

#### 方法

##### init

```python
def __init__(*args, peak_memory: int, total_time: float, **kwargs):
```

使用内存和时间数据初始化子进程结果。

#### 属性

##### peak_memory

##### total_time

## 函数

### subprocess_run

```python
def subprocess_run(cmd: str | list[str], *, silent: bool = False) -> SubprocessResult:
```

subprocess.run 的包装器，用于记录日志、在出错时引发异常，并跟踪峰值 RAM 使用量，而不会在 stdout/stderr 上挂起。

参数

 * `cmd` (`str | list[str]`): 要执行的命令。字符串或参数列表。
 * `silent` (`bool`): 如果为 True，则抑制日志。

返回

 * `SubprocessResult`: 带有 .peak_memory 属性的 SubprocessResult。
