GitHub - bmwant/hapless: Run and manage background processes

hapless

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.

Installation

• Install using uv

• Install using pipx

• Install using pip

pip install hapless

# 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

• Install using brew

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

Changes made in each release can be found on the Releases page.

Python versions compatibility:

• 0.11.1 is the last version to support Python 3.7
• 0.15.1 is the last version to support Python 3.8

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!