Metadata-Version: 2.4
Name: nf-core
Version: 4.0.1
Summary: Helper tools for use with nf-core Nextflow pipelines.
Author-email: Phil Ewels <phil.ewels@scilifelab.se>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nf-core/tools
Project-URL: Documentation, https://nf-co.re/docs/nf-core-tools
Project-URL: Repository, https://github.com/nf-core/tools
Project-URL: Changelog, https://github.com/nf-core/tools/blob/master/CHANGELOG.md
Keywords: nf-core,nextflow,bioinformatics,workflow,pipeline,biology,sequencing,NGS,next generation sequencing
Requires-Python: <4,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click
Requires-Dist: filetype
Requires-Dist: GitPython
Requires-Dist: PyGithub
Requires-Dist: jinja2
Requires-Dist: jsonschema>=4.0
Requires-Dist: markdown>=3.3
Requires-Dist: packaging
Requires-Dist: pillow
Requires-Dist: prek
Requires-Dist: prompt_toolkit<=3.0.52
Requires-Dist: pydantic>=2.2.1
Requires-Dist: pyyaml
Requires-Dist: questionary>=2.0.1
Requires-Dist: refgenie
Requires-Dist: requests
Requires-Dist: requests_cache
Requires-Dist: rich-click==1.9.*
Requires-Dist: rich>=13.3.1
Requires-Dist: rocrate
Requires-Dist: repo2rocrate
Requires-Dist: setuptools<81
Requires-Dist: tabulate
Requires-Dist: textual==8.2.4
Requires-Dist: trogon
Requires-Dist: pdiff
Requires-Dist: ruamel.yaml
Provides-Extra: dev
Requires-Dist: mypy; extra == "dev"
Requires-Dist: myst_parser; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-datafiles; extra == "dev"
Requires-Dist: responses; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: Sphinx; extra == "dev"
Requires-Dist: sphinx-rtd-theme; extra == "dev"
Requires-Dist: textual-dev==1.8.0; extra == "dev"
Requires-Dist: types-PyYAML; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Requires-Dist: types-jsonschema; extra == "dev"
Requires-Dist: types-Markdown; extra == "dev"
Requires-Dist: types-setuptools; extra == "dev"
Requires-Dist: typing_extensions>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: pytest-textual-snapshot==1.1.0; extra == "dev"
Requires-Dist: pytest-workflow>=2.0.0; extra == "dev"
Requires-Dist: pytest-xdist>=3.7.0; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Dynamic: license-file

<h1>
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nf-core/tools/main/docs/images/nfcore-tools_logo_dark.png">
    <img alt="nf-core/tools" src="https://raw.githubusercontent.com/nf-core/tools/main/docs/images/nfcore-tools_logo_light.png">
  </picture>
</h1><!-- omit in toc -->

[![Python tests](https://github.com/nf-core/tools/workflows/Python%20tests/badge.svg?branch=main&event=push)](https://github.com/nf-core/tools/actions?query=workflow%3A%22Python+tests%22+branch%3Amain)
[![codecov](https://codecov.io/gh/nf-core/tools/branch/main/graph/badge.svg)](https://codecov.io/gh/nf-core/tools)
[![code style: prettier](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
[![code style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)

[![install with Bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg)](https://bioconda.github.io/recipes/nf-core/README.html)
[![install with PyPI](https://img.shields.io/badge/install%20with-PyPI-blue.svg)](https://pypi.org/project/nf-core/)
[![Get help on Slack](http://img.shields.io/badge/slack-nf--core%20%23tools-4A154B?logo=slack)](https://nfcore.slack.com/channels/tools)

A python package with helper tools for the nf-core community.

The nf-core tools package is written in Python and can be imported and used within other packages.
For documentation of the internal Python functions, please refer to the [Tools Python API docs](https://nf-co.re/tools/docs/).

## Installation

For full installation instructions, please see the [nf-core documentation](https://nf-co.re/docs/nf-core-tools/cli/installation).
Below is a quick-start for those who know what they're doing:

### Bioconda

Install [from Bioconda](https://bioconda.github.io/recipes/nf-core/README.html):

```bash
conda install nf-core
```

Alternatively, you can create a new environment with both nf-core/tools and nextflow:

```bash
conda create --name nf-core python=3.14 nf-core nextflow
conda activate nf-core
```

### Python Package Index

Install [from PyPI](https://pypi.python.org/pypi/nf-core/):

```bash
pip install nf-core
```

### Development version

```bash
pip install --upgrade --force-reinstall git+https://github.com/nf-core/tools.git@dev
```

If editing, fork and clone the repo, then install as follows:

```bash
uv sync --all-extras

# Activate the virtual environment
source .venv/bin/activate

# Or use uv run to run commands without activating
uv run nf-core --help
```

## Contributions and Support

If you would like to contribute to this package, please see the [contributing guidelines](CONTRIBUTING.md).

For further information or help, don't hesitate to get in touch on the [Slack `#tools` channel](https://nfcore.slack.com/channels/tools) (you can join with [this invite](https://nf-co.re/join/slack)).

## Citation

If you use `nf-core tools` in your work, please cite the `nf-core` publication as follows:

> **The nf-core framework for community-curated bioinformatics pipelines.**
>
> Philip Ewels, Alexander Peltzer, Sven Fillinger, Harshil Patel, Johannes Alneberg, Andreas Wilm, Maxime Ulysse Garcia, Paolo Di Tommaso & Sven Nahnsen.
>
> _Nat Biotechnol._ 2020 Feb 13. doi: [10.1038/s41587-020-0439-x](https://dx.doi.org/10.1038/s41587-020-0439-x).
