Metadata-Version: 2.3
Name: snk
Version: 0.31.1
Project-URL: Documentation, https://github.com/wytamma/snk#readme
Project-URL: Issues, https://github.com/wytamma/snk/issues
Project-URL: Source, https://github.com/wytamma/snk
Author-email: Wytamma Wirth <wytamma.wirth@me.com>
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: gitpython~=3.1.0
Requires-Dist: snk-cli>=0.7.1
Description-Content-Type: text/markdown

# Snk

[![PyPI - Version](https://img.shields.io/pypi/v/snk.svg)](https://pypi.org/project/snk)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/snk.svg)](https://pypi.org/project/snk)
[![write-the - docs](https://badgen.net/badge/write-the/docs/blue?icon=https://raw.githubusercontent.com/Wytamma/write-the/master/images/write-the-icon.svg)](https://write-the.wytamma.com/)
[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FWytamma%2Fsnk&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false)](https://github.com/Wytamma/snk)
[![status](https://joss.theoj.org/papers/e0b3241a56503fc2cae712d95c9142d8/status.svg)](https://joss.theoj.org/papers/e0b3241a56503fc2cae712d95c9142d8)

---

**Documentation**: <a href="https://snk.wytamma.com" target="_blank">https://snk.wytamma.com</a>

**Source Code**: <a href="https://github.com/Wytamma/snk" target="_blank">https://github.com/Wytamma/snk</a>

---

Snk (pronounced snek) is a Snakemake workflow management system. Snk allows you to install Snakemake workflows as dynamically generated Command Line Interfaces (via [snk-cli](https://github.com/Wytamma/snk-cli)). Using a workflow as a CLI increases its interoperability and allows complex workflows to be used as modular components in a larger system.

## Installation

From bioconda:
```console
conda create -n snk bioconda::snk
```
From PyPI:
```console
pip install snk
```

## Basic Use

### Install a workflow as a CLI

The snk install command can be use to install Snakemake workflows as CLIs. Snk can install Snakemake workflows from GitHub repos or local paths.

```bash
snk install wytamma/snk-basic-pipeline
```
Successfully installed snk-basic-pipeline (ff034f1b)!

The snk install command is flexible and can be used to install diverse workflows. For example, the [dna-seq-gatk-variant-calling](https://github.com/snakemake-workflows/dna-seq-gatk-variant-calling) workflow (v2.1.1) as `variant-calling` with Snakemake v8.10.8 and Pandas and NumPy dependency. An index of publicly available Snakemake workflows can be found on the [snakemake workflow catalog](https://snakemake.github.io/snakemake-workflow-catalog/).

```
snk install \
  snakemake-workflows/dna-seq-gatk-variant-calling \
  --name variant-calling \
  --snakemake 8.10.8 \
  -d pandas==1.5.3 \
  -d numpy==1.26.4 \
  -t v2.1.1
```
Successfully installed variant-calling (v2.1.1)!

### Manage Installed Workflows

You can list installed workflows with `snk list` and uninstall them with `snk uninstall`.

```bash
snk list
```
| Workflow | Version | 
| --- | --- |
| snk-basic-pipeline | ff034f1b |
| variant-calling | v2.1.1 | 

```bash
snk uninstall snk-basic-pipeline
```
Successfully uninstalled snk-basic-pipeline!

### Inspect the CLI   

Snk will automatically create a fully featured CLI for the Snakemake workflow using [snk-cli](https://github.com/Wytamma/snk-cli). 

>[!note]
>For more details on the CLI created by `snk` read the [snk-cli docs](https://snk.wytamma.com/snk-cli/)

```
variant-calling --help
```
<img width="862" alt="cli help" src="https://github.com/Wytamma/snk/assets/13726005/3e6e4134-efe5-47e1-b6f4-81b60e1c9ea7">


### View run options

Workflow configuration options are automatically generated from the snakemake config file.

```
variant-calling run --help
```
<img width="862" alt="run cli help" src="https://github.com/Wytamma/snk/assets/13726005/ef1dd9ca-1ba2-4a77-921a-4de16dd57631">


### Create a DAG

Here we use the `.test` resources included in the workflow to create the DAG (requires `graphviz`).

```bash
variant-calling run -r .test/config -r .test/data --dag dag.pdf
```
<img width="862" alt="run cli help" src="https://github.com/Wytamma/snk/assets/13726005/0c25886c-0ab1-49ad-9fdd-315827dcaeb8">

### Configure 

Snk will dynamically generate config options for the CLI. For example if the config.yaml file has the option `samples: config/samples.tsv` you can set this option with the `--samples` flag.

```bash
variant-calling run --samples new.tsv
```

You can also configure the workflow using a config file. 

```bash
variant-calling config --pretty # print the config 
variant-calling config > config.yml # save the config 
variant-calling run --config config.yml # run with config 
```

## Documentation

Read the [documentation](https://snk.wytamma.com) for more information.

## License

`snk` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.


## Citation

If you use `snk` in an academic setting then please cite the following article:

- Wirth, Wytamma, Simon Mutch, and Robert Turnbull. “Snk: A Snakemake CLI and Workflow Management System.” *Journal of Open Source Software* 9, no. 103 (2024): 7410. DOI: [10.21105/joss.07410](https://doi.org/10.21105/joss.07410).

In BibTeX format:

```
@article{Wirth2024, 
    doi = {10.21105/joss.07410}, 
    year = {2024}, 
    publisher = {The Open Journal}, 
    volume = {9}, 
    number = {103}, 
    pages = {7410}, 
    author = {Wytamma Wirth and Simon Mutch and Robert Turnbull}, 
    title = {Snk: A Snakemake CLI and Workflow Management System}, 
    journal = {Journal of Open Source Software}
}
```