Skip to main content

An async subprocess manager

Project description

A package for async subprocesses.

Motivation

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.

Logging

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

$ export REEL_LOGGING_LEVEL='INFO'

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.

Files for reel, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size reel-0.0.3-py2.py3-none-any.whl (17.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size reel-0.0.3.tar.gz (13.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page