>_ comrun

comrun (shorthand for command runner) is a configurable wrapper for subprocess.Popen, focused on making it easy to run external commands from Python scripts.

Features

• Simple runner interface to execute commands.
• Configure and reuse runners to minimize boilerplate when running multiple commands.
• Access captured stdout/stderr and exit code for further processing.
• Use output hooks to handle command output line-by-line as it arrives.

Installation

Install using your preferred package manager:

uvpoetrypip

uv add comrun

poetry add comrun

pip install comrun

Getting started

Explore the docs to learn how to use comrun:

• Run your first command and read results: Usage → General
• Stream output with custom hooks: Usage → Advanced
• Examples of common runner configurations: Usage → Cookbook
• Return types and behaviors: Reference
• See Alternatives to compare with other command-running libraries.