Metadata-Version: 2.4
Name: engagequeue
Version: 0.1.1
Summary: Durable local job execution for Python applications and the command line
Author: Daniel Blankenberg
License: MIT
Project-URL: Source, https://github.com/BlankenbergLab/engagequeue
Project-URL: Documentation, https://github.com/BlankenbergLab/engagequeue/blob/main/README.md
Project-URL: Issues, https://github.com/BlankenbergLab/engagequeue/issues
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: psutil>=5.9
Requires-Dist: PyYAML>=6
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build>=1; extra == "dev"
Requires-Dist: setuptools>=69; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: tomli>=2; python_version < "3.11" and extra == "dev"
Dynamic: license-file

# EngageQueue

<img src="https://raw.githubusercontent.com/BlankenbergLab/engagequeue/main/docs/assets/engagequeue-logo.svg" alt="EngageQueue pointing-hand logo" width="256">

**Local jobs. Make it so.**

EngageQueue provides durable, single-host job execution through a Python
library and a command-line interface. Python applications, CLI clients, Galaxy,
and Pulsar can share persistent execution pools without owning the lifetime
of accepted jobs.

The scheduler and job supervisors run independently of application clients.
Closing a Python handle leaves both running jobs and queue admission active.
Local execution supports Linux and macOS. Linux native supervision tracks
daemonized descendants; macOS local execution supports foreground commands and
their process groups. Both run without systemd. An optional Linux systemd
backend uses user services and cgroups.

For Linux supervision on a Mac, use managed Docker execution through
`DockerExecutor` or the CLI's `--execution-mode docker`. EngageQueue manages an
owned Linux runtime container, persistent state, and declared workspace mounts.
Docker Desktop must remain running while that runtime executes work.

See [installation](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/installation.md),
[the API and CLI](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/api.md),
[operations](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/operations.md),
and [integrations](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/integrations.md).

See [validation](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/validation.md)
for local checks and optional live-runtime tests.

See [branding](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/branding.md)
for the project logo, downloads, and usage guidance, and
[releasing](https://github.com/BlankenbergLab/engagequeue/blob/main/docs/releasing.md)
for PyPI publishing.
