Skip to content

Update nf-schema to 3.0.0 - #163

Merged
maxulysse merged 1 commit into
devfrom
chore/nf-schema-3
Oct 21, 2026
Merged

maxulysse merged 1 commit into
devfrom
chore/nf-schema-3

Conversation

@maxulysse

Copy link
Copy Markdown
Member

PR checklist

  • This comment contains a description of changes (for why/what changed, see CONTRIBUTING.md)
  • Container version(s) are updated/rebuilt and pin changed software (if needed)
  • CHANGELOG.md is updated
  • nextflow_schema.json is updated (if needed)
  • docs/usage.md is updated (if needed)
  • docs/output.md is updated (if needed)
  • assets/ is updated (if needed)
  • Remove all TODO comments
  • Test this locally and/or on CI (particularly with GPU/singularity tests)
  • For modules: nf-core/modules PR along with basic tests on Linux, macOS and Windows
  • For pipelines: template update at nf-core/tools along with basic tests (stub run on all profiles)

Description

Bumps nf-schema from 2.7.2 to 3.0.0 and migrates the four affected call sites.

3.0.0 removes the positional arguments from three plugin functions, so each call moves to the single options map that is now the only parameter:

  • paramsSummaryMap(workflow, parameters_schema: ...) → paramsSummaryMap(parameters_schema: ...) in main.nf and in the utils subworkflow. The workflow object is fetched from the running session internally.
  • paramsSummaryLog(summary_options, workflow) → paramsSummaryLog(summary_options).
  • paramsHelp(help_options, X) → paramsHelp(help_options + [parameter: X]).

No Nextflow floor change is needed: 3.0.0 requires >= 26.04.0, which matches our !>=26.04.0.

Unaffected: samplesheetToList and validateParameters are unchanged in 3.0.0, so datasheet parsing is untouched. The parameter: "" fallback keeps its 2.x behaviour (getShortMessage treats an empty string as falsy and prints all parameters). This pipeline never set the removed validation.help.enabled or the deprecated failUnrecognised* options, so there was nothing to clean up.

Template divergence

Three of the four edits are in the template-owned subworkflows/local/utils_nfcore_references_pipeline/main.nf. The upstream template is still on nf-schema 2.7.3 with the 2.x call shapes, so this branch deliberately diverges from it. These changes need to be upstreamed to the template before the next template sync, otherwise the sync will revert them. Tracking this in the roadmap decisions log; a template PR against nf-core/tools is the follow-up.

Testing

  • nextflow lint clean; the 23 warnings are pre-existing when-section deprecations in nf-core modules and none touch the edited files.
  • nf-test test tests/ --profile=+docker: 26/26 passing (this branch includes the splice_sites fix merged in Merge prepare_genome subworkflows into a single prepare_genome #162).
  • nf-core pipelines lint: 364 passed, 0 failed; 21 warnings, all pre-existing template TODOs. No template-version mismatch flagged.

Generated by OpenCode

Migrate paramsHelp, paramsSummaryLog, and paramsSummaryMap to their
single-options-map signatures; 3.0.0 requires Nextflow >= 26.04.0,
matching our floor.

Generated by OpenCode
@github-actions

Copy link
Copy Markdown

Warning

Newer version of the nf-core template is available.

Your pipeline is using an old version of the nf-core template: 4.1.0.
Please update your pipeline to the latest version.

For more documentation on how to update your pipeline, please see the Synchronisation documentation.

@github-actions

Copy link
Copy Markdown

nf-core pipelines lint overall result: Passed ✅ ⚠️

Posted for pipeline commit 6d31a95

+| ✅ 216 tests passed       |+
#| ❔  12 tests were ignored |#
!| ❗   8 tests had warnings |!
Details

❗ Test warnings:

  • files_exist - File not found: .github/workflows/awsfulltest.yml
  • pipeline_todos - TODO string in main.nf: Optionally add in-text citation tools to this list.
  • pipeline_todos - TODO string in main.nf: Optionally add bibliographic entries to this list.
  • pipeline_todos - TODO string in main.nf: Only uncomment below if logic in toolCitationText/toolBibliographyText has been filled!
  • pipeline_todos - TODO string in methods_description_template.yml: #Update the HTML below to your preferred methods description, e.g. add publication citation for this pipeline
  • pipeline_todos - TODO string in base.config: Check the defaults for all processes
  • pipeline_todos - TODO string in usage.md: Add documentation about anything specific to running your pipeline. For general topics, please point to (and add to) the main nf-core website.
  • pipeline_todos - TODO string in output.md: Write this documentation describing your workflow's output

❔ Tests ignored:

✅ Tests passed:

Run details

  • nf-core/tools version 4.1.0
  • Run at 2026-10-21 18:46:44

@maxulysse
maxulysse merged commit 829a172 into dev Oct 21, 2026
20 checks passed
@maxulysse
maxulysse deleted the chore/nf-schema-3 branch October 23, 2026 13:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant