Skip to main content

WARP: Wrapper around Replicated Processes

Project description

WARP: Wrapper around Replicated Processes

WARP is a light-weight manager for background processes.

Functionality

  • Easily spawn any process as a managed subprocess
  • Automatic recover from failed process
  • Runs completely async
  • Cleanly exits in a safe order (subprocess, WARP manager, then main process)

Overview

So you need to run a subprocess in the background of your Python application. How do you do it?

  • If you simply start the process in an async way, how can you ensure that the process can is restarted if it exits?
  • If you start the process in a synchronous way, how do you ensure that the rest of your program continues to execute?
  • If you use supervisord, how do you ensure that all your users have supervisord installed ahead of time?
  • If you use celery or some kind of heavy weight solution, you now need standalone infra and need to manage a lot of complexity

WARP makes it very simple to manage a background process in a self-healing way. The subprocess runs in a background thread that continually monitors the health of the subprocess. WARP is also able to intelligently support interrupt signals.

Installation

pip install warp

Usage

Import WARP

from warp import Warp

Create a WARP object

wp = Warp(command="dummy_server.py")

Start the WARP process

wp.start()

The process will automatically be killed (cleanly) when the main process exits

Alternatively you may also forcefully stop this background process

wp.stop()

Testing

Run the following command from the repo root

pytest

Python Compatibility

WARP only supports the following Python versions

  • 3.7
  • 3.8
  • 3.9

Contributing

WARP is a community project. Feel free to submit a PR and/or an issue if you are looking for more functionality or found a bug!

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

warp-1.0.4.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

warp-1.0.4-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file warp-1.0.4.tar.gz.

File metadata

  • Download URL: warp-1.0.4.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.12

File hashes

Hashes for warp-1.0.4.tar.gz
Algorithm Hash digest
SHA256 bab40b58d5e82fcb549390b4793205b65792fa68a5dbfed7602dd76c7390533e
MD5 d677d8d6fbf4ae91d94e9138fb5da5df
BLAKE2b-256 5bd83b6a858a3509390034fbc228858ced7dacfd3610aae5a73cba36bd0240c0

See more details on using hashes here.

File details

Details for the file warp-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: warp-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.12

File hashes

Hashes for warp-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6b56c39727bea5ecc5dd3088753ddea24e79fb18529ac08ac591ce03519b3226
MD5 37aaaafc132e656a7504067b0595d6e5
BLAKE2b-256 75ca22c0b316e96e7e929f6dbb48f2af6e11baffe2efcb6cd96ee71af3268186

See more details on using hashes here.

Supported by

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