---
id: subprocess-run
version: "0.0.8"
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)
license_treatment: permissive
maintenance: abandoned
---

# subprocess.run — The subprocess module extension to run processes.

License: permissive · Maintenance: abandoned · Downloads: 140.0K/mo

## 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 above — 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

pip install subprocess-run
uv add subprocess-run
poetry add subprocess-run

## Installing 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: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 140.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

subprocess wrapper, run shell commands python, capture command output, simple process execution, shell command interface, subprocess shorthand, execute system commands, legacy, obsolete

[View on SkillFed](https://skillfed.io/packages/subprocess-run) · [View on PyPI](https://pypi.org/project/subprocess-run/)