Tools and Workflows

Manage creation of tools and workflows for workflow tracking.

Command-line tool

Represent a CommandLineToolFactory for tracking workflows.

class renku.core.models.cwl.command_line_tool.CommandLineToolFactory(command_line, explicit_inputs=NOTHING, explicit_outputs=NOTHING, no_input_detection=False, no_output_detection=False, directory='.', working_dir='.', stdin=None, stderr=None, stdout=None, successCodes=NOTHING, annotations=None, messages=None, warnings=None)

Command Line Tool Factory.

add_indirect_inputs()

Read indirect inputs list and add them to explicit inputs.

add_indirect_outputs()

Read indirect outputs list and add them to explicit outputs.

delete_indirect_files_list()

Remove indirect inputs and outputs list.

find_explicit_inputs()

Yield explicit inputs and command line input bindings if any.

generate_process_run(client, commit, path)

Return an instance of ProcessRun.

guess_inputs(*arguments)

Yield command input parameters and command line bindings.

guess_outputs(candidates)

Yield detected output and changed command input parameter.

guess_type(value, ignore_filenames=None)

Return new value and CWL parameter type.

is_existing_path(candidate, ignore=None)

Return a path instance if it exists in current directory.

iter_input_files(basedir)

Yield tuples with input id and path.

read_files_list(files_list)

Read files list where each line is a filepath.

split_command_and_args()

Return tuple with command and args from command line arguments.

validate_command_line(attribute, value)

Check the command line structure.

validate_path(attribute, value)

Path must exists.

watch(client, no_output=False)

Watch a Renku repository for changes to detect outputs.

Annotation

Represent an annotation for a workflow.

class renku.core.models.cwl.annotation.Annotation(*, id, body=None, source=None)

Represents a custom annotation for a research object.

as_jsonld()

Create JSON-LD.

classmethod from_jsonld(data)

Create an instance from JSON-LD data.

class renku.core.models.cwl.annotation.AnnotationSchema(*args, commit=None, client=None, **kwargs)

Annotation schema.

Create an instance.

class Meta

Meta class.

model

alias of Annotation

Parameter

Represent parameters from the Common Workflow Language.

class renku.core.models.cwl.parameter.CommandInputParameter(id=None, streamable=None, type='string', description=None, default=None, inputBinding=None)

An input parameter for a CommandLineTool.

classmethod from_cwl(data)

Create instance from type definition.

to_argv(**kwargs)

Format command input parameter as shell argument.

class renku.core.models.cwl.parameter.CommandLineBinding(position=None, prefix=None, separate: bool = True, itemSeparator=None, valueFrom=None, shellQuote: bool = True)

Define the binding behavior when building the command line.

to_argv(default=None)

Format command line binding as shell argument.

class renku.core.models.cwl.parameter.CommandOutputBinding(glob=None)

Define the binding behavior for outputs.

class renku.core.models.cwl.parameter.CommandOutputParameter(id=None, streamable=None, type='string', description=None, format=None, outputBinding=None)

Define an output parameter for a CommandLineTool.

class renku.core.models.cwl.parameter.InputParameter(id=None, streamable=None, type='string', description=None, default=None, inputBinding=None)

An input parameter.

class renku.core.models.cwl.parameter.OutputParameter(id=None, streamable=None, type='string', description=None, format=None, outputBinding=None)

An output parameter.

class renku.core.models.cwl.parameter.Parameter(streamable=None)

Define an input or output parameter to a process.

class renku.core.models.cwl.parameter.WorkflowOutputParameter(id=None, streamable=None, type='string', description=None, format=None, outputBinding=None, outputSource=None)

Define an output parameter for a Workflow.

renku.core.models.cwl.parameter.convert_default(value)

Convert a default value.

Types

Represent the Common Workflow Language types.

class renku.core.models.cwl.types.Directory(path=None, listing=NOTHING)

Represent a directory.

class renku.core.models.cwl.types.Dirent(entryname=None, entry=None, writable=False)

Define a file or subdirectory.

class renku.core.models.cwl.types.File(path)

Represent a file.

class renku.core.models.cwl.types.PathFormatterMixin

Format path property.

Workflow

Represent workflows from the Common Workflow Language.

class renku.core.models.cwl.workflow.Workflow(steps=NOTHING)

Define a workflow representation.

add_step(**kwargs)

Add a workflow step.

class renku.core.models.cwl.workflow.WorkflowStep(run, id=NOTHING, in_=None, out=None)

Define an executable element of a workflow.

renku.core.models.cwl.workflow.convert_run(value)

Convert value to CWLClass if dict is given.