Metadata-Version: 2.1
Name: snakemake-executor-plugin-pcluster-slurm
Version: 0.0.4
Summary: A Snakemake executor plugin for submitting jobs to an AWS Parallel Cluster (pcluster) SLURM cluster.
Home-page: https://github.com/Daylily-Informatics/snakemake-executor-plugin-pcluster-slurm
License: MIT
Keywords: snakemake,plugin,executor,cluster,slurm,pcluster,aws,parallel-compute,parallel-cluster
Author: John Major
Author-email: john@daylilyinformatics.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: snakemake-executor-plugin-slurm-jobstep (>=0.2.0,<0.3.0)
Requires-Dist: snakemake-interface-common (>=1.13.0,<2.0.0)
Requires-Dist: snakemake-interface-executor-plugins (>=9.1.1,<10.0.0)
Requires-Dist: throttler (>=1.2.2,<2.0.0)
Project-URL: Documentation, https://snakemake.github.io/snakemake-plugin-catalog/plugins/executor/pcluster-slurm.NOTWRITTENYET.html
Project-URL: Repository, https://github.com/Daylily-Informatics/snakemake-executor-plugin-pcluster-slurm
Description-Content-Type: text/markdown

# Snakemake executor plugin: pcluster-slurm v_0.0.4_

# Snakemake Executor Plugins (generally)
[Snakemake plugin catalog docs](https://snakemake.github.io/snakemake-plugin-catalog/plugins/executor).

## `pcluster-slurm` plugin
### AWS Parallel Cluster, `pcluster` `slurm`
[AWS Parallel Cluster](https://aws.amazon.com/hpc/parallelcluster/) is a framework to deploy and manage dynamically scalable HPC clusters on AWS, running SLURM as the batch system, and `pcluster` manages all of the creating, configuring, and deleting of the cluster compute nodes. Nodes may be spot or dedicated.  **note**, the `AWS Parallel Cluster` port of slurm has a few small, but critical differences from the standard slurm distribution.  This plugin enables using slurm from pcluster head and compute nodes via snakemake `>=v8.*`.


# Pre-requisites
## Snakemake >=8.*
### Conda
```bash
conda create -n snakemake -c conda-forge -c bioconda snakemake==8.20.6
conda activate snakemake
```

# Installation (pip)
_from an environment with snakemake and pip installed_
```bash
pip install snakemake-executor-plugin-pcluster-slurm
```

# More Documentation Pending For:
## How slurm uses `--comment` to tag resources created by the autoscaling cluster to tracke and mnage budgets.
