Skip to main content

subx: Datastructure SubprocessResult

Project description

subx: Data structure SubprocessResult - for the Python programming language


This library gives you a data structure called SubprocessResult. It combines stdout, stderr and ret (the exit status).

This is handy if you do “one shut” calling of processes.


If subx fails, you get a meaningful exception message that helps you. You see the first bytes of stdout and stderr. This is the main reason why I wrote this library.

Just replace subprocess.check_call(cmd) with and you get all you want plus a helpful exception messages.

Or replace subprocess.check_output(cmd) with


The method call() returns an instance of SubprocessResult.

result =[‘date’])

Class SubprocessResult

The class SubprocessResult has the following attributes:

  • stdout
  • stderr
  • ret
  • cmd

Additional Features

If available the subprocess32 library gets used. This provides the timeout parameter for Python 2.7.

Not suited for …

This library is not usefull if you want to stream data to or from your subprocess.


Install for usage from pypi:

pip install subx

Development Install on Python2

Install subx for development on Python2:

virtualenv subx-env
cd subx-env
. ./bin/activate
pip install -e git+

Development Install on Python3

Install subx for development on Python3:

python3 -m venv subx-py3env
cd subx-py3env
. ./bin/activate
pip install --upgrade pip
pip install -e git+

Development Testing


pip install -r src/subx/requirements.txt
cd src/subx
pytest # all test ok?
pyCharm src/subx/...
pytest # all test still ok?
.... I am waiting for your pull request :-)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for subx, version 2017.5.0
Filename, size File type Python version Upload date Hashes
Filename, size subx-2017.5.0.tar.gz (3.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page