---

A bioinformatics workflow engine built on top of the Workflow Description Language (WDL).

Request Feature · Report Bug · ⭐ Consider starring the repo! ⭐

🎨 Features

• sprocket analyzer runs Sprocket as a LSP server, which is useful for IDE integration.
• sprocket check performs static analysis on a document or directory of documents.
• sprocket completions generates shell completions for Sprocket.
• sprocket config prints configuration values.
• sprocket dev subcommand containing developmental and experimental commands.
• sprocket explain explains validation and lint rules supported by Sprocket.
• sprocket format formats a document or directory of documents.
• sprocket inputs writes template input file (JSON or YAML) for a task or workflow.
• sprocket lint performs static analysis on a document or directory of documents with additional linting rules enabled (effectively a shortcut for check --lint).
• sprocket run runs a task or workflow.
• sprocket validate validates a set of inputs read from files or on the command line against a task or workflow.

Guiding Principles

The following are high-level guiding principles of the Sprocket project.

• Provide a high-performance workflow execution engine capable of orchestrating massive bioinformatics workloads (the stated target is 20,000+ concurrent jobs).
• Develop a suite of modern development tools that brings bioinformatics development on par with other modern languages (e.g., wdl-lsp).
• Maintain an community-focused codebase that enables a diverse set of contributors from academic, non-profit, and commercial organizations.
• Build on an open, domain-tailored standard to ensure the toolset remains singularly focused on unencumbered innovation within bioinformatics.
• Retain a simple and accessible user experience when complexity isn't warranted.

📚 Getting Started

Installation

Check the GitHub releases page to see if Sprocket is available for your platform.

Note that the prebuilt Sprocket for Linux may not work on every distribution due to library dependencies.

If Sprocket is not available for your platform or architecture, you may install it with cargo from a Rust toolchain.

We recommend using rustup to install a Rust toolchain.

Once Rust is installed, you can install the latest version of Sprocket by running the following command:

cargo install sprocket --locked

Homebrew

Sprocket is also available on Homebrew for both MacOS and Linux. Once Homebrew is installed, you can install Sprocket with the following command.

brew install sprocket

Docker

Sprocket is available as a Docker image.

docker pull ghcr.io/stjude-rust-labs/sprocket:v0.18.0

🖥️ Development

To bootstrap a development environment, please use the following commands.

# Clone the repository
git clone [email protected]:stjude-rust-labs/sprocket.git
cd sprocket

# Initialize and update vendored submodules
git submodule update --init --recursive

# Build the crate in release mode
cargo build --release

# Run the `sprocket` command line tool
cargo run --release

🚧️ Tests

Before submitting any pull requests, please make sure the code passes the following checks (from the root directory).

# Run the project's tests.
cargo test --all-features

# Run the tests for the examples.
cargo test --examples --all-features

# Ensure the project doesn't have any linting warnings.
cargo clippy --all-features

# Ensure the project passes `cargo fmt`.
cargo fmt --check

# Ensure the docs build.
cargo doc

🤝 Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page.

Most of the work for this binary happens over at [the wdl crates]https://github.com/stjude-rust-labs/sprocket/tree/main/crates). For more information about our contributor policies, please read the contributing guide.

📝 License and Legal

This project is licensed as either Apache 2.0 or MIT at your discretion. Additionally, please see the disclaimer that applies to all crates and command line tools made available by St. Jude Rust Labs.

Copyright © 2023-Present St. Jude Children's Research Hospital.