Run and manage background processes

bmwant bmwant Last update: Feb 16, 2024

hapless

Checks PyPI PyPI - Python Version

Code style: black Ruff EditorConfig pre-commit

hapless (adjective) - (especially of a person) unfortunate. A developer who accidentally launched long-running process in the foreground.

Simplest way of running and tracking processes in the background.

asciicast

Installation

$ pip install hapless

# or to make sure proper pip is used for the given python executable
$ python -m pip install hapless

Install into user-specific directory in case of any permissions-related issues.

$ pip install --user hapless
$ python -m pip install --user hapless

Usage

# Run arbitrary script
$ hap run -- python long_running.py

# Show summary table
$ hap

# Display status of the specific process
$ hap status 1

See USAGE.md for the complete list of commands and available parameters.

Contribute

See DEVELOP.md to setup your local development environment and feel free to create a pull request with a new feature.

Releases

See CHANGELOG.md for the new features included within each release.

See also

  • Rich console UI library.
  • Supervisor full-fledged process manager.
  • podmena provides nice emoji icons to commit messages.

Support 🇺🇦 Ukraine in the war!

🇺🇦 Donate to this foundation in case you want to help. Every donation matter!

Subscribe to our newsletter