Skip to main content

An async subprocess manager

Project description

A package for async subprocesses.


This project is a simplified version of Python subprocess control with asynchronous support. It is being developed to support a music streaming package which uses ffmpeg and other shell commands to get music from various sources to various destinations.


reel will log useful messages to a file called reel.log if you configure a log level (e.g. bash):


That’s all you need to set.

Available log levels, ranked by verbosity, with DEBUG the most verbose, are:

  • DEBUG - mostly useless information

  • INFO - mostly useful information

  • WARNING - might be a problem: suitable default for production

  • ERROR - something bad happened

  • CRITICAL - rare, show-stopping malfunction

  • NOTSET - the default: no logging

By default, reel places the log file in $XDG_DATA_HOME. If $XDG_DATA_HOME is not set, reel chooses a suitable default directory. To view the choice, ask reel to print the current configuration (e.g. bash):

$ reel --config | grep LOGGING

For direct control, explicitly set the logging directory with:

$ export REEL_LOGGING_DIR='~/.local/share/reel'

In addition to sending useful information to reel.log, you can reel also logs output produced by subprocesses. A subprocess can generate log files in two ways:

  1. The process might write it’s own log file (e.g. a web server).

    In this case, reel might be able to control where the log file is written if the command is configured in reel.cmd. For example, reel.cmd.icecast will automatically write it’s server log file to $REEL_LOGGING_DIR / icecast.log.

  2. You might decide to log stderr and/or stdout from a subprocess.

    You can decide what to do with any subprocess output, including logging it all to a file…

In general, reel attempts to keep all log files in one directory and will sparingly create subdirectories if needed.

Project details

Download files

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

Source Distribution

reel-0.0.4.tar.gz (13.5 kB view hashes)

Uploaded Source

Built Distribution

reel-0.0.4-py2.py3-none-any.whl (17.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page