subprocess.run
The subprocess module extension to run processes.
What it is and what it does
subprocess.run is a wrapper around Python's subprocess module that provides a simpler syntax for running shell commands and accessing their output, status codes, and error streams. It allows you to call external processes with less boilerplate than the standard library subprocess module, returning an object with stdout, stderr, and status attributes.
The package is designed for Python 2.6, 2.7, 3.3, and PyPy2.1. However, it has been abandoned since its latest release on 2013-11-16 and is now obsolete. Installing this package on modern Python versions is not recommended, as the standard library has superseded it.
Use it for:
- Running simple shell commands from Python 2 code when the standard subprocess module felt verbose.
- Capturing command output and exit status in a single, readable call without subprocess.Popen boilerplate.
- Piping shell commands together (e.g., grep into wc) with a minimal syntax.
- Quick scripts that need to execute system utilities and check their results.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides a simplified interface to run shell commands and capture their output, status, and error streams in Python.
No. This package is abandoned (last update 2013-11-16), targets Python 2.6, 2.7, 3.3, and PyPy2.1 which are end-of-life, and has been superseded by built-in functionality. Modern Python users should use the standard library instead. Legacy Python 2 projects might have used it, but no new code should depend on it.
Install
subprocess-run on PyPI
pip
pip install subprocess-runuv
uv add subprocess-runpoetry
poetry add subprocess-runInstalling subprocess.run
Before you install
High install friction: the package is abandoned (last commit 2018-03-14, 4654 days without release), targets obsolete Python versions (2.6, 2.7, 3.3), and no longer receives maintenance or security updates.
License in practice
BSD License (permissive): you may use, modify, and distribute this code freely provided you retain the copyright notice and disclaimer.
Quickstart
pip install subprocess.run
from subprocess import run
result = run('uname -r')
print(result.stdout)
Package targets Python 2.6, 2.7, and 3.3; modern Python versions have subprocess.run built-in, making this package obsolete.
Verify before relying
- Whether this package actually works on modern Python versions despite targeting only 2.6, 2.7, and 3.3.
- Whether the built-in subprocess.run is functionally equivalent or if this wrapper adds unique value.
- Current test coverage and whether the package passes its own test suite on any supported platform.
Package facts
| License | Copyright (c) 2013, Sebastian Pawluś. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are… (full text in the JSON record) (permissive) |
| Python support | not specified |
| Install friction | high — source build required |
| Runtime dependencies | none |
| Maintenance | abandoned — 4,654 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 140,041/month — #11,280 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: subprocess.run-0.0.8.tar.gz
Keywords: subprocess, run, process
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
subprocess-teeA drop-in replacement for subprocess.run that…
permissive · top 5,000 on PyPI
runsRuns multiple subprocess commands from a text…
permissive · top 5,000 on PyPI
bashProvides a Python wrapper for running bash…
copyleft · top 15,000 on PyPI
xonshXonsh is a Python-based shell that merges…
permissive · top 15,000 on PyPI
scripttestscripttest runs command-line applications in…
permissive · top 15,000 on PyPI
subprocess-multiteeMultiplexes subprocess stdout/stderr to…
unclear · top 15,000 on PyPI
fancy-subprocessRuns shell commands with formatted output,…
permissive · top 15,000 on PyPI
shellescapeProvides a `quote()` function that…
permissive · top 5,000 on PyPI
subprocrunnerWraps Python's subprocess module to simplify…
permissive · top 15,000 on PyPI
plumbumPlumbum lets you write shell-script-like…
permissive · top 5,000 on PyPI