diff --git a/docs/migrations/26-04.md b/docs/migrations/26-04.md index 0d83048696..be4b0b4b37 100644 --- a/docs/migrations/26-04.md +++ b/docs/migrations/26-04.md @@ -1,12 +1,8 @@ (migrating-26-04-page)= -# Migrating to 26.04 (preview) +# Migrating to 26.04 -This page summarizes the upcoming changes in Nextflow 26.04, which will be released in April 2026. - -:::{note} -This page is a work in progress and will be updated as features are finalized. It should not be considered complete until the 26.04 release. -::: +[Nextflow 26.04](https://github.com/nextflow-io/nextflow/releases/tag/v26.04.0) was released on April 29, 2026. ## New features @@ -164,20 +160,38 @@ Breaking changes from the {ref}`first preview `: - The syntax for process tuple inputs has been updated: - ```nextflow - // 25.10 - input: - (id, fastq_1, fastq_2): Tuple + ```nextflow + // 25.10 + input: + (id, fastq_1, fastq_2): Tuple - // 26.04 - input: - tuple(id: String, fastq_1: Path, fastq_2: Path) - ``` + // 26.04 + input: + tuple(id: String, fastq_1: Path, fastq_2: Path) + ``` - The method signature for the `stageAs` directive was changed from `(filePattern, value)` to `(value, filePattern)`. See {ref}`migrating-static-types` for more information about migrating to static typing. See {ref}`migrating-static-types-operators` for best practices on using operators with static typing. +

Process hints directive

+ +The `hints` process directive allows you to specify executor-specific hints for individual processes. + +For example, the AWS Batch executor uses the `consumableReources` hint for [resource-aware scheduling](https://aws.amazon.com/about-aws/whats-new/2025/02/aws-batch-resource-aware-scheduling/): + +```nextflow +process hello { + hints 'awsbatch/consumableResources': ['my-license': 1] + + // ... +} +``` + +Custom executors can use hints to control scheduling behavior in a fine-grained manner over configuration options. + +See {ref}`process-hints` for details. + ## Enhancements

Strict syntax parser enabled by default

@@ -218,10 +232,6 @@ Nextflow uses the default branch specified by the Git repository when no revisio The `manifest.defaultBranch` config option is no longer needed because of this update. -

Load collection-type params automatically from files

- -When using the `params` block, collection-type parameters such as `List` can be loaded automatically from a CSV, JSON, or YAML file. This feature simplifies the loading of samplesheet inputs and allows a pipeline to support multiple structured data formats. - See {ref}`workflow-typed-params` for details. See {ref}`migrating-static-types` for a migration example.

Print workflow outputs on run completion

@@ -339,6 +349,33 @@ workflow RNASEQ { See the {ref}`cli-lint` command reference for details. +

Apple container support

+ +Nextflow can run containers on macOS using [Apple container](https://github.com/apple/container), a lightweight container runtime for Apple silicon machines: + +```groovy +process.container = 'nextflow/examples:latest' +appleContainer.enabled = true +``` + +See {ref}`container-apple` for details. + +

Seqera filesystem for datasets

+ +Nextflow can download [Seqera Platform datasets](https://docs.seqera.io/platform-cloud/data/datasets) using the `seqera` URI scheme. + +Seqera dataset URIs are specified as `seqera:////datasets/[@version]`. For example: + +```nextflow +params.dataset = 'seqera://seqeralabs/showcase/datasets/sarek_samples' + +workflow { + println file(params.dataset).text +} +``` + +A Platform access token with appropriate permissions is required to download non-public datasets. It can be specified using the `TOWER_ACCESS_TOKEN` environment variable or the `tower.accessToken` config option. + ## Breaking changes - The {ref}`strict syntax parser ` is now enabled by default. The legacy parser can be enabled by setting the `NXF_SYNTAX_PARSER` environment variable to `v1`.