<!-- [](https://codecov.io/gh/lursight/runem) -->
[](https://github.com/lursight/runem/actions/workflows/main.yml)
[](https://lursight.github.io/runem/)
# Run’em
**Describe your devops-tools, run them fast**
Run’em runs a project's dev-ops tasks, in parallel, and gives you a blueprint of what those tasks are. Commands are instantly discoverable, run in parallel, and easily extensible.
## Why Run’em?
- **Jobs Manifest** - discover tasks & onboard smoothly
- **Parallel** - get results quicker
- **Simple** - define task easily
- **Extensible** - add tasks, & reports quickly
- **Filters** - powerful task selection
- **Visibility** - see what you're running, & discover improvements.
- **Beautiful** - get graphs & metrics out of the box, then build custom reports.
## Highlights
### Jobs Manifest
The Jobs manifest (available via `runem --help`) gives you an overview and insights into all job and tasks for a project. A single source of truth for all tasks.
This allows faster on-boarding, easier discovery, and better team communication. It makes access and visibility of tasks easier and better.
### Parallel Execution:
Save time by running dev-ops tasks in parallel, and by getting metrics on those
runtimes.
Runem tries to run all tasks as quickly as possible, looking at resources, with
dependencies.
NOTE: It is not yet a full resource analyser or dependency-execution graph, but by version
1.0.0 it will be.
### Filtering:
Use powerful and flexible filtering. Select or excluded tasks by `tags`, `name` and
`phase`. Chose the task to be run based on your needs, right now.
You can also customise filtering by adding your own command `options`.
See `--tags`, `--not-tags`, `--jobs`, `--not-jobs`, `--phases` and `--not-phases`.
### Powerful Insights
Understand what ran, how fast, and what failed.
**Quiet by Default:** Focus on what matters, and reveal detail only when needed.
## Quick Start
**Install:**
```bash
pip install runem
```
**Define a task:**
```yaml
`# .runem.yml
- job:
command: echo "hello world!"
```
**Run:**
```bash
runem
```
Run multiple commands in parallel, see timing, and keep output minimal. Need detail?
```bash
runem --verbose
```
[Quick Start Docs](https://lursight.github.io/runem/quick_start/)
## Basic Use
Typical workflows are running all default jobs, filtering and viewing the job manifest & help:
[Filter](https://lursight.github.io/runem/filtering/)
`runem --help` is your radar—instantly mapping out every available task:
[Help & Job Discovery](https://lursight.github.io/runem/help/)
## Configuration File
How and why to configure your projects `.runem.yml` file. How to scale up with multi-phase configs, how to apply filters and how to configure runtime options:
[Configuration](https://lursight.github.io/runem/configuration/)
## Default and Custom Reports
`runem` gives you basic performance metrics by default, and allows custom reporting like code-coverage, or profiling reports:
[Reports](https://lursight.github.io/runem/reports/)
## Troubleshooting
Swift solutions to common issues:
[Troubleshooting & Known Issues](https://lursight.github.io/runem/troubleshooting/)
---
## Contribute & Support
Brought to you by [Lursight Ltd.](https://lursight.com) and an open community.
[CONTRIBUTING.md](CONTRIBUTING.md)
[❤️ Sponsor](https://github.com/sponsors/lursight/)
## About Run’em
Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our [Mission](https://lursight.github.io/runem/mission/).
Raw data
{
"_id": null,
"home_page": null,
"name": "runem",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "example, runem",
"author": "lursight",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/29/10/23b81e977d85d7e47575d5135e7862d7b3540736319351f2c6ce81612062/runem-0.8.0.tar.gz",
"platform": null,
"description": "<!-- [](https://codecov.io/gh/lursight/runem) -->\n[](https://github.com/lursight/runem/actions/workflows/main.yml)\n[](https://lursight.github.io/runem/)\n\n# Run\u2019em\n\n**Describe your devops-tools, run them fast**\n\nRun\u2019em runs a project's dev-ops tasks, in parallel, and gives you a blueprint of what those tasks are. Commands are instantly discoverable, run in parallel, and easily extensible.\n\n## Why Run\u2019em?\n\n- **Jobs Manifest** - discover tasks & onboard smoothly\n- **Parallel** - get results quicker\n- **Simple** - define task easily\n- **Extensible** - add tasks, & reports quickly\n- **Filters** - powerful task selection\n- **Visibility** - see what you're running, & discover improvements.\n- **Beautiful** - get graphs & metrics out of the box, then build custom reports.\n\n## Highlights\n### Jobs Manifest\nThe Jobs manifest (available via `runem --help`) gives you an overview and insights into all job and tasks for a project. A single source of truth for all tasks.\n\nThis allows faster on-boarding, easier discovery, and better team communication. It makes access and visibility of tasks easier and better.\n\n### Parallel Execution:\nSave time by running dev-ops tasks in parallel, and by getting metrics on those\nruntimes.\n\nRunem tries to run all tasks as quickly as possible, looking at resources, with\ndependencies. \n\nNOTE: It is not yet a full resource analyser or dependency-execution graph, but by version\n1.0.0 it will be.\n\n### Filtering:\nUse powerful and flexible filtering. Select or excluded tasks by `tags`, `name` and\n`phase`. Chose the task to be run based on your needs, right now.\n\nYou can also customise filtering by adding your own command `options`.\n\nSee `--tags`, `--not-tags`, `--jobs`, `--not-jobs`, `--phases` and `--not-phases`.\n\n### Powerful Insights\nUnderstand what ran, how fast, and what failed.\n\n**Quiet by Default:** Focus on what matters, and reveal detail only when needed.\n\n## Quick Start\n**Install:**\n```bash\npip install runem\n```\n**Define a task:**\n\n```yaml\n`# .runem.yml\n - job:\n command: echo \"hello world!\"\n```\n\n**Run:**\n\n```bash\nrunem\n```\n\nRun multiple commands in parallel, see timing, and keep output minimal. Need detail?\n\n```bash\nrunem --verbose\n```\n\n[Quick Start Docs](https://lursight.github.io/runem/quick_start/)\n\n## Basic Use\n\nTypical workflows are running all default jobs, filtering and viewing the job manifest & help:\n[Filter](https://lursight.github.io/runem/filtering/)\n`runem --help` is your radar\u2014instantly mapping out every available task:\n[Help & Job Discovery](https://lursight.github.io/runem/help/)\n\n## Configuration File\n\nHow and why to configure your projects `.runem.yml` file. How to scale up with multi-phase configs, how to apply filters and how to configure runtime options:\n[Configuration](https://lursight.github.io/runem/configuration/)\n\n## Default and Custom Reports\n\n`runem` gives you basic performance metrics by default, and allows custom reporting like code-coverage, or profiling reports:\n[Reports](https://lursight.github.io/runem/reports/)\n\n## Troubleshooting\n\nSwift solutions to common issues:\n[Troubleshooting & Known Issues](https://lursight.github.io/runem/troubleshooting/)\n\n---\n\n## Contribute & Support\n\nBrought to you by [Lursight Ltd.](https://lursight.com) and an open community.\n[CONTRIBUTING.md](CONTRIBUTING.md)\n[\u2764\ufe0f Sponsor](https://github.com/sponsors/lursight/)\n\n## About Run\u2019em\n\nRun\u2019em exists to accelerate your team\u2019s delivery and reduce complexity. Learn about our [Mission](https://lursight.github.io/runem/mission/).\n\n",
"bugtrack_url": null,
"license": "Specify your license here",
"summary": "Awesome runem created by lursight",
"version": "0.8.0",
"project_urls": {
"Homepage": "https://github.com/lursight/runem/"
},
"split_keywords": [
"example",
" runem"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b4977f752325c5a3745dfdd3cf567812381a28153ed851dbcdf09ce5e2817eb9",
"md5": "1e7fb5d6f7926ad304525acfff998ce3",
"sha256": "62fd14d720d09c4480b9fcd57d34092d552a974ac35145524300d637ad2e2d6b"
},
"downloads": -1,
"filename": "runem-0.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1e7fb5d6f7926ad304525acfff998ce3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 61765,
"upload_time": "2025-08-13T11:44:09",
"upload_time_iso_8601": "2025-08-13T11:44:09.444714Z",
"url": "https://files.pythonhosted.org/packages/b4/97/7f752325c5a3745dfdd3cf567812381a28153ed851dbcdf09ce5e2817eb9/runem-0.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "291023b81e977d85d7e47575d5135e7862d7b3540736319351f2c6ce81612062",
"md5": "456cfcceba150083940bd5e841f20925",
"sha256": "6eecf0843e9818493744d7cb29026c8b6ceb53bfe80633295abf0aa61d6647bb"
},
"downloads": -1,
"filename": "runem-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "456cfcceba150083940bd5e841f20925",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 96148,
"upload_time": "2025-08-13T11:44:10",
"upload_time_iso_8601": "2025-08-13T11:44:10.648592Z",
"url": "https://files.pythonhosted.org/packages/29/10/23b81e977d85d7e47575d5135e7862d7b3540736319351f2c6ce81612062/runem-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 11:44:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lursight",
"github_project": "runem",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "runem"
}
JSON
