Skip to main content

CI DOCS

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:

pip install runem

Optional shell completion (bash/zsh/fish):

pip install "runem[completion]"

Define a task:

`# .runem.yml
 - job:
    command: echo "hello world!"

Run:

runem

Run multiple commands in parallel, see timing, and keep output minimal. Need detail?

runem --verbose

Quick Start Docs

Basic Use

Typical workflows are running all default jobs, filtering and viewing the job manifest & help: Filter runem --help is your radar—instantly mapping out every available task: Help & Job Discovery

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

Default and Custom Reports

runem gives you basic performance metrics by default, and allows custom reporting like code-coverage, or profiling reports: Reports

Troubleshooting

Swift solutions to common issues: Troubleshooting & Known Issues


Contribute & Support

Brought to you by Lursight Ltd. and an open community. CONTRIBUTING.md ❤️ Sponsor

About Run’em

Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our Mission.

Metadata

Release files for runem 0.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for runem 0.15.0
File Size Uploaded Provenance Actions
runem-0.15.0.tar.gz 126.0 kB Without provenance Details for runem-0.15.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for runem 0.15.0
File Interpreter ABI Platform Actions
runem-0.15.0-py3-none-any.whl Python 3 none any Details for runem-0.15.0-py3-none-any.whl

Total release size: 241.8 kB

Release files / runem-0.15.0.tar.gz

Download URL runem-0.15.0.tar.gz
Size 126.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ab70ca20169912332cfa4d72be92411cf621184581aae6862f742f7e6bf8217f
BLAKE2b-256 checksum
How to use checksums
37b5625a9c7ad2ccdc1345151360eb1936083cdbda26673e46fc7e0ac8089cf8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / runem-0.15.0-py3-none-any.whl

Download URL runem-0.15.0-py3-none-any.whl
Size 115.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4a6cf8beeb27145a0f9b680e817db97defccff48caff2ff2f7611079c8780913
BLAKE2b-256 checksum
How to use checksums
cf58e49ce45aae56e7c0e76c9dbb59e0608d6950fad5cbd2cf4a455ac9cb48ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for runem 0.15.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.15.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page