Skip to main content

A Sphinx extension for Snakemake

Project description

https://smutch.github.io/snakedoc/_images/snakedoc-logo.svg

A Sphinx extension for Snakemake workflows.

tests status coverage statistic pre-commit.ci status git3moji Formatted with black Imports formatted with isort

Snakemake workflows can be complicated and difficult to follow, especially for new users. Having good documentation explaining what each rule is doing, what assumptions are being made, and what parts can be configured are important for understandable and reusable workflows. Snakedoc aims to help with this by:

  1. encouraging developers to write contextual and useful docstrings, inline with their rules; and

  2. providing a way to automatically scrape those docstrings and present them in Sphinx documentation where they can be further augmented as needed.

Where to go from here

  • See the installation page how to install Snakedoc.

  • To get started, check out the guide.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

snakedoc-0.1.0.tar.gz (18.9 kB view details)

Uploaded Source

Built Distribution

snakedoc-0.1.0-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file snakedoc-0.1.0.tar.gz.

File metadata

  • Download URL: snakedoc-0.1.0.tar.gz
  • Upload date:
  • Size: 18.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.23.1

File hashes

Hashes for snakedoc-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0a100e2526161b995cd2332dcc987264df17b677e492c1de0030af1339e600fa
MD5 bd8032694174c220406aec7a9236b10e
BLAKE2b-256 8eadc32fcd1782e5e25cc55272d6d5b2231eb9469279a8e1b84e9533592d4a97

See more details on using hashes here.

File details

Details for the file snakedoc-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: snakedoc-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.23.1

File hashes

Hashes for snakedoc-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0c46494bfa61fb14b630581bd45a5aae2946421c6abe5926a3133d3cbbb4eb34
MD5 7f69651d205683c0fc7861cc83c91320
BLAKE2b-256 69884315dae6dbddefd4fa1453d89e1b384e782e36d471c77fb2478b2260d726

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page