# subprocess-tee

> subprocess-tee

- **URL**: https://www.freshcrate.ai/projects/subprocess-tee
- **Author**: pypi
- **Category**: Databases
- **Latest version**: `0.4.2` (2026-04-21)
- **License**: MIT
- **Source**: https://github.com/pycontribs/subprocess-tee/releases
- **Homepage**: https://pypi.org/project/subprocess-tee/
- **Language**: Python
- **GitHub**: 62 stars, 15 forks
- **Registry**: pypi (`subprocess-tee`)
- **Tags**: `asyncio`, `pypi`, `subprocess`

## Description

# subprocess-tee

This package provides a drop-in alternative to `subprocess.run` that
captures the output while still printing it in **real-time**, just the way
`tee` does.

Printing output in real-time while still capturing is valuable for
any tool that executes long-running child processes. For those, you do want
to provide instant feedback (progress) related to what is happening.

```python
# from subprocess import run
from subprocess_tee import run

result = run("echo 123")
result.stdout == "123\n"
```

You can add `tee=False` to disable the tee functionality if you want, this
being a much shorter alternative than adding the well known
`stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL`.

Keep in mind that `universal_newlines=True` is implied as we expect text
processing, this being a divergence from the original `subprocess.run`.

You can still use `check=True` in order to make it raise CompletedProcess
exception when the result code is not zero.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `0.4.2` | 2026-04-21 | Low | Imported from PyPI (0.4.2) |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |
| `v0.4.2` | 2024-06-17 | Low | ## Bugfixes  - Use exec mode when passed a list of strings (#101) @KotlinIsland |

## Citation

- HTML: https://www.freshcrate.ai/projects/subprocess-tee
- Markdown: https://www.freshcrate.ai/projects/subprocess-tee.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/subprocess-tee/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._