No description
Find a file
Thomas A. Christensen II 0e885a8e09 chore: Update GitHub actions package to v6.0.0
The GitHub actions API changes the underlying type structure to allow
for plugins like the throttling plugin at v6, so update to that version.
2024-01-21 20:57:22 -06:00
.github/workflows feat: Add codecov action to test workflow 2023-10-31 01:42:06 +00:00
docs/images art: Add nf-core logo to README 2023-08-11 12:20:28 -05:00
src make linter happy 2024-01-12 18:02:02 +00:00
test add todo item back 2024-01-12 18:02:02 +00:00
.eslintignore build: Add eslint and prettier 2022-11-17 19:32:25 +00:00
.eslintrc.json style: Add simple-import-sort and run 2022-11-17 19:32:25 +00:00
.gitattributes refactor: Move everything into a src/ dir 2022-11-17 19:32:25 +00:00
.gitignore refactor: Move everything into a src/ dir 2022-11-17 19:32:25 +00:00
.prettierignore build: Add eslint and prettier 2022-11-17 19:32:25 +00:00
.prettierrc.json style: Use double-quotes 2022-11-17 19:32:25 +00:00
action.yml feat: Add max-retries parameter to action inputs 2024-01-21 20:57:22 -06:00
CHANGELOG.md chore: Update CHANGELOG for v1.4.0 2023-10-26 02:45:41 +00:00
LICENSE chore: Update license to MIT and nf-core 2022-11-17 19:32:25 +00:00
package-lock.json chore: Update GitHub actions package to v6.0.0 2024-01-21 20:57:22 -06:00
package.json chore: Update GitHub actions package to v6.0.0 2024-01-21 20:57:22 -06:00
README.md docs: Add codecov badge to README 2023-10-31 01:42:06 +00:00
tsconfig.json build: Setup typescript tests 2022-11-17 19:32:25 +00:00

nf-core/setup-nextflow nf-core/setup-nextflow

Testing codecov MIT License GitHub tag (latest by date) Get from GitHub Actions

An action to install Nextflow into a GitHub Actions workflow and make it available for subsequent steps.

Quick start

name: Example workflow
on: push
jobs:
  example:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: nf-core/setup-nextflow@v1
      - run: nextflow run ${GITHUB_WORKSPACE}

Inputs

All inputs are optional! 😎 By default, this action will install the latest stable release of Nextflow. You can optionally pick a different version, or choose to install all versions.

version

default: latest

A version string to specify the version of Nextflow to install. This version number will try to resolve using npm's semantic versioning, so

  • version: 21
  • version: 21.10
  • version: 21.10.6

will all download Nextflow version 21.10.6 as of 13 June 2022. Since Nextflow does not use true semantic versioning, you should always specify at least the minor version (e.g. version: 21.10).

Edge releases are resolved as pre-release, see https://github.com/npm/node-semver#prerelease-tags for more details. In short, in nearly all cases, passing an -edge release to this action will need to specify the exact edge release targeted.

There are three (technically four) aliases to assist in choosing up-to-date Nextflow versions.

  • version: latest-stable (alias version: latest)

    This will download the latest stable release of Nextflow.

  • version: latest-edge

    This will download the latest edge release of Nextflow. Note that edge releases may be older than the latest stable release. See https://github.com/nextflow-io/nextflow/issues/2467

  • version: latest-everything

    This will download the latest release of Nextflow, regardless of stable/edge status.

all

default: false

A boolean deciding whether to download the "all versions" distribution of Nextflow. May be useful for running tests against multiple versions downstream.

token

default: ${{ secrets.GITHUB_TOKEN }}

⚠️ This really shouldn't be changed. If you think this will fix a workflow problem, triple-check everything else first. ⚠️

This action locates the releases based upon the GitHub API, and requires an access token. The default token provided with all GitHub actions should be sufficient for all use cases on GitHub. Valid reasons to change this:

  • GitHub Enterprise server (and only under some configurations)
  • Testing workflows locally with act

Outputs

There are no outputs from this action.

Why was this action made?

Slack link

You may be asking, why not just a few yaml lines?

- name: Install Nextflow
  env:
    NXF_VER: ${{ matrix.NXF_VER }}
  run: |
    wget -qO- get.nextflow.io | bash
    sudo mv nextflow /usr/local/bin/    

The versioning. From the Nextflow install script you can't get latest-edge or latest-everything for example.