Skip to content

Commit 4ba81ce

Browse files
nf-core-botmashehu
authored andcommitted
[automated] Update nf-core/tools API docs for dev
1 parent 910930c commit 4ba81ce

61 files changed

Lines changed: 199 additions & 211 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

package-lock.json

Lines changed: 0 additions & 21 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

sites/docs/src/content/api_reference/dev/api/nf_core_yml.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Bases: `BaseModel`
4444

4545
#### _`field{:python}`_`bump_version{:python}`_: dict\[str, bool] | None_`{:python}`_= None_
4646

47-
Disable bumping of the version for a module/subworkflow (when repository_type is modules). See <https://nf-co.re/docs/nf-core-tools/modules/bump-versions> for more information.
47+
Disable bumping of the version for a module/subworkflow (when repository\_type is modules). See <https://nf-co.re/docs/nf-core-tools/modules/bump-versions> for more information.
4848

4949
#### _`field{:python}`_`container_registry{:python}`_: list\[str] | None_`{:python}`_= None_`{:python}`_(alias 'container-registry')_
5050

@@ -60,7 +60,7 @@ Version of nf-core/tools used to create/update the pipeline
6060

6161
#### _`field{:python}`_`org_path{:python}`_: str | None_`{:python}`_= None_
6262

63-
Path to the organisation’s modules repository (used for modules repo_type only)
63+
Path to the organisation’s modules repository (used for modules repo\_type only)
6464

6565
#### _`field{:python}`_`repository_type{:python}`_: Literal\['pipeline', 'modules'] | None_`{:python}`_= None_
6666

@@ -72,7 +72,7 @@ Pipeline template configuration
7272

7373
#### _`field{:python}`_`update{:python}`_: dict\[str, str | bool | dict\[str, str | dict\[str, str | bool]]] | None_`{:python}`_= None_
7474

75-
Disable updating specific modules/subworkflows (when repository_type is pipeline). See <https://nf-co.re/docs/nf-core-tools/modules/update> for more information.
75+
Disable updating specific modules/subworkflows (when repository\_type is pipeline). See <https://nf-co.re/docs/nf-core-tools/modules/update> for more information.
7676

7777
### `lint``block ({:python}``NFCoreYamlLintConfig``){:python}`
7878

@@ -254,7 +254,7 @@ Check that every parameter in the schema has a description.
254254

255255
#### _`field{:python}`_`schema_lint{:python}`_: bool | None_`{:python}`_= None_
256256

257-
Lint nextflow_schema.json file
257+
Lint nextflow\_schema.json file
258258

259259
#### _`field{:python}`_`schema_params{:python}`_: bool | None_`{:python}`_= None_
260260

sites/docs/src/content/api_reference/dev/api/pipelines/bump_version.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# nf_core.pipelines.bump_version
1+
# nf\_core.pipelines.bump\_version
22

33
Bumps the version number in all appropriate files for
44
a nf-core pipeline.
@@ -8,18 +8,18 @@ a nf-core pipeline.
88
Bumps the required Nextflow version number of a pipeline.
99

1010
- **Parameters:**
11-
- **pipeline_obj** ([_nf_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
11+
- **pipeline\_obj** ([_nf\_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
1212
about the pipeline contents and build files.
13-
- **new_version** (_str_) – The new version tag for the required Nextflow version.
13+
- **new\_version** (_str_) – The new version tag for the required Nextflow version.
1414

1515
### `nf_core.pipelines.bump_version.bump_pipeline_version(pipeline_obj:{:python}`[`Pipeline{:python}`](../utils#nf_core.utils.Pipeline)`, new_version: str) → None{:python}`
1616

1717
Bumps a pipeline version number.
1818

1919
- **Parameters:**
20-
- **pipeline_obj** ([_nf_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
20+
- **pipeline\_obj** ([_nf\_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
2121
about the pipeline contents and build files.
22-
- **new_version** (_str_) – The new version tag for the pipeline. Semantic versioning only.
22+
- **new\_version** (_str_) – The new version tag for the pipeline. Semantic versioning only.
2323

2424
### `nf_core.pipelines.bump_version.handle_error(message: str, required: bool){:python}`
2525

@@ -31,12 +31,12 @@ Updates a file with a new version number.
3131

3232
- **Parameters:**
3333
- **filename** (_str_) – The name of the file to update.
34-
- **pipeline_obj** ([_nf_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
34+
- **pipeline\_obj** ([_nf\_core.utils.Pipeline_](../utils#nf_core.utils.Pipeline)) – A Pipeline object that holds information
3535
about the pipeline contents.
3636
- **patterns** (_List_ \*\[\*_Tuple_ \*\[\*_str_ _,_ _str_ _]_ _]_) – A list of tuples containing the regex patterns to
3737
match and the replacement strings.
3838
- **required** (_bool_ _,_ _optional_) – Whether the file is required to exist. Defaults to True.
39-
- **yaml_key** (_List_ \*\[\*_str_ _]_ _|_ _None_ _,_ _optional_) – The YAML key to update. Defaults to None.
39+
- **yaml\_key** (_List_ \*\[\*_str_ _]_ _|_ _None_ _,_ _optional_) – The YAML key to update. Defaults to None.
4040

4141
### `nf_core.pipelines.bump_version.update_text_file(fn: Path, patterns: list[tuple[str, str]], required: bool){:python}`
4242

@@ -56,5 +56,5 @@ Updates a YAML file with a new version number.
5656
- **fn** (_Path_) – The name of the file to update.
5757
- **patterns** (_List_ \*\[\*_Tuple_ \*\[\*_str_ _,_ _str_ _]_ _]_) – A list of tuples containing the regex patterns to
5858
match and the replacement strings.
59-
- **yaml_key** (_List_ \*\[\*_str_ _]_) – The YAML key to update.
59+
- **yaml\_key** (_List_ \*\[\*_str_ _]_) – The YAML key to update.
6060
- **required** (_bool_) – Whether the file is required to exist.

sites/docs/src/content/api_reference/dev/api/pipelines/create.md

Lines changed: 9 additions & 9 deletions
Large diffs are not rendered by default.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
# nf_core.pipelines.download
1+
# nf\_core.pipelines.download
Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# API Reference
22

3-
- [nf_core.pipelines.bump_version](bump_version)
4-
- [nf_core.pipelines.create](create)
5-
- [nf_core.pipelines.download](download)
6-
- [nf_core.pipelines.launch](launch)
7-
- [nf_core.pipelines.lint](lint)
8-
- [nf_core.pipelines.utils](lint_utils)
9-
- [nf_core.pipelines.list](list)
10-
- [nf_core.pipelines.params_file](params-file)
11-
- [nf_core.pipelines.schema](schema)
12-
- [nf_core.pipelines.sync](sync)
3+
- [nf\_core.pipelines.bump\_version](bump_version)
4+
- [nf\_core.pipelines.create](create)
5+
- [nf\_core.pipelines.download](download)
6+
- [nf\_core.pipelines.launch](launch)
7+
- [nf\_core.pipelines.lint](lint)
8+
- [nf\_core.pipelines.utils](lint_utils)
9+
- [nf\_core.pipelines.list](list)
10+
- [nf\_core.pipelines.params\_file](params-file)
11+
- [nf\_core.pipelines.schema](schema)
12+
- [nf\_core.pipelines.sync](sync)

sites/docs/src/content/api_reference/dev/api/pipelines/launch.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# nf_core.pipelines.launch
1+
# nf\_core.pipelines.launch
22

33
Launch a pipeline, interactively collecting params
44

@@ -41,12 +41,12 @@ Take the Nextflow flag schema and merge it with the pipeline schema
4141
Prompt for edits to a group of parameters (subschema in ‘definitions’)
4242

4343
- **Parameters:**
44-
- **group_id** – Parameter ID (string)
45-
- **group_obj** – JSON Schema keys (dict)
44+
- **group\_id** – Parameter ID (string)
45+
- **group\_obj** – JSON Schema keys (dict)
4646
- **Returns:**
4747
val answers
4848
- **Return type:**
49-
Dict of param_id
49+
Dict of param\_id
5050

5151
#### `prompt_param(param_id, param_obj, is_required, answers){:python}`
5252

@@ -68,17 +68,17 @@ Use the functions defined in the cli wizard to convert to the correct types.
6868
#### `set_schema_inputs(){:python}`
6969

7070
Take the loaded schema and set the defaults as the input parameters
71-
If a nf_params.json file is supplied, apply these over the top
71+
If a nf\_params.json file is supplied, apply these over the top
7272

7373
#### `single_param_to_questionary(param_id, param_obj, answers=None, print_help=True){:python}`
7474

7575
Convert a JSONSchema param to a Questionary question
7676

7777
- **Parameters:**
78-
- **param_id** – Parameter ID (string)
79-
- **param_obj** – JSON Schema keys (dict)
78+
- **param\_id** – Parameter ID (string)
79+
- **param\_obj** – JSON Schema keys (dict)
8080
- **answers** – Optional preexisting answers (dict)
81-
- **print_help** – If description and help_text should be printed (bool)
81+
- **print\_help** – If description and help\_text should be printed (bool)
8282
- **Returns:**
8383
Single Questionary dict, to be appended to questions list
8484

sites/docs/src/content/api_reference/dev/api/pipelines/lint.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# nf_core.pipelines.lint
1+
# nf\_core.pipelines.lint
22

33
:::tip
44
See the [Lint Tests]() docs for information about specific linting functions.
@@ -18,10 +18,10 @@ in either release mode or normal mode (default). Returns an object
1818
of type [`PipelineLint`](#nf_core.pipelines.lint.PipelineLint) after finished.
1919

2020
- **Parameters:**
21-
- **pipeline_dir** (_str_) – The path to the Nextflow pipeline root directory
22-
- **release_mode** (_bool_) – Set this to True, if the linting should be run in the release mode.
21+
- **pipeline\_dir** (_str_) – The path to the Nextflow pipeline root directory
22+
- **release\_mode** (_bool_) – Set this to True, if the linting should be run in the release mode.
2323
See [`PipelineLint`](#nf_core.pipelines.lint.PipelineLint) for more information.
24-
- **plain_text** (_bool_) – Print output in plain text without rich formatting
24+
- **plain\_text** (_bool_) – Print output in plain text without rich formatting
2525
- **Returns:**
2626
An object of type [`PipelineLint`](#nf_core.pipelines.lint.PipelineLint) that contains all the linting results.
2727
An object of type `ComponentLint` that contains all the linting results for the modules.
@@ -111,7 +111,7 @@ summarising the linting results.
111111
Function to dump lint results to a JSON file for downstream use
112112

113113
- **Parameters:**
114-
**json_fn** (_str_) – File path to write JSON to.
114+
**json\_fn** (_str_) – File path to write JSON to.
115115

116116
#### `_wrap_quotes(files: list[str] | list[Path] | Path) → str{:python}`
117117

0 commit comments

Comments
 (0)