Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.5%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: woop
- License: apache-2.0
- Language: Python
- Default Branch: master
- Size: 16.6 KB
Statistics
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
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
python
from warp import Warp
Create a WARP object
python
wp = Warp(command="dummy_server.py")
Start the WARP process
python
wp.start()
The process will automatically be killed (cleanly) when the main process exits
Alternatively you may also forcefully stop this background process
python
wp.stop()
Testing
Run the following command from the repo root
bash
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!
Owner
- Name: Willem Pienaar
- Login: woop
- Kind: user
- Location: San Francisco
- Company: Tecton
- Twitter: willpienaar
- Repositories: 4
- Profile: https://github.com/woop
GitHub Events
Total
Last Year
Committers
Last synced: 12 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Willem Pienaar | g****t@w****o | 16 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 12 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 32,640 last-month
- Total docker downloads: 8
- Total dependent packages: 0
- Total dependent repositories: 7
- Total versions: 7
- Total maintainers: 1
pypi.org: warp
WARP: Wrapper around Replicated Processes
- Homepage: https://github.com/woop/warp
- Documentation: https://warp.readthedocs.io/
- License: Apache-2.0
-
Latest release: 1.0.4
published over 4 years ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v2 composite
- actions/setup-node v2 composite
- actions/setup-python v3 composite