-
Notifications
You must be signed in to change notification settings - Fork 4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Dynamically build methods description from ch_versions #510
Conversation
7a933fa
to
122ef72
Compare
122ef72
to
04c4e70
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks like a neat solution to me. Good to get rid of all the if statements in the toolCitationsText function.
if (toolDetails == null) { | ||
throw new IllegalStateException("Tool: '${tool}' not found in ${references_yaml}") | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this to make sure that each tool we run has an entry in the software_reference.yml
file, even if the values are empty? Should we add this to the contribution doc?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is both to make sure we have an entry, but also because toolDetails[description]
below will error with a less informative "can't get null value" or similar..
Good idea, will add to contribution doc!
This PR adds a
software_references.yml
and uses that together with the tools reported inch_versions
to dynamically write the methods description tools and references, depending on how subworkflows are skipped and params set.This should make the method description easier to maintain when adding or moving around tools and subworkflows. An error will also be produced if a new tool is added without an entry in
software_references.yml
.Closes #508.
PR checklist
nf-core pipelines lint
).nextflow run . -profile test,docker --outdir <OUTDIR>
).nextflow run . -profile debug,test,docker --outdir <OUTDIR>
).docs/usage.md
is updated.docs/output.md
is updated.CHANGELOG.md
is updated.README.md
is updated (including new tool citations and authors/contributors).