bash

What it is and what it does

Bash is a lightweight wrapper around Python's subprocess module that simplifies running shell commands from Python code. It provides a chainable interface where you can call bash() on a result object to pipe commands together, and exposes stdout, stderr, and return codes as attributes. The library is designed to reduce boilerplate when you need to execute bash commands inline rather than spawning separate processes directly.

The package is abandoned and unmaintained since 2016-05-30. It uses shell=True internally, which the documentation explicitly warns makes it unsuitable for untrusted input. Install friction is high because it ships as a source tarball only (bash-0.6.tar.gz).

Use it for:

• Quick prototyping or scripting where you need to run simple shell commands from Python without subprocess boilerplate.
• Chaining multiple bash operations (pipes, redirects) in a single Python statement for readability.
• Accessing command output, error messages, and exit codes in a unified object interface.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python wrapper for running bash commands and piping their output, with a chainable interface for composing shell operations.

No. The package is abandoned (last release 2016-05-30, no commits since 2020-04-13), uses shell=True which is a documented security risk for untrusted input, and high install friction (source-only distribution). Only consider if you have legacy code already depending on it and cannot migrate to modern alternatives.

Install

bash on PyPI

pip install bash

uv add bash

poetry add bash

Installing bash

Before you install

High install friction due to source-only distribution (bash-0.6.tar.gz). Package is abandoned—last release was 2016-05-30, with no commits since 2020-04-13. Not actively maintained.

License in practice

Licensed under LGPL (copyleft). Derivative works or distributions must comply with copyleft obligations; check your project's license compatibility before use.

Quickstart

pip install bash

from bash import bash
b = bash('ls . ')
result = b.bash('grep ".pyc"')
print(b.stdout)

Package uses shell=True under the hood, making it unsuitable for running untrusted or user-supplied commands due to shell injection risk.

Verify before relying

• Actual Python version support on modern interpreters: classifiers list 2.7, 3.4, 3.5, but requires_python is unspecified.
• Whether the source tarball builds successfully on current Python versions or systems.
• Security implications of shell=True beyond the documented injection warning.
• Whether this package or its dependencies have known vulnerabilities not yet catalogued in OSV.

Package facts

Evidence: bash-0.6.tar.gz

Tags

More Python Modules packages