extract step

step extract

See also

Package mtrchk-org-momotor-check-zip

Python package containing the checklet implementing this step. The recipe requires version ~=2.0, this document is based on version 2.0.1.

preflight@scheduler option

A preflight check handled by the scheduler. This allows recipes to indicate situations in which the step does not have to be executed.

See Scheduler preflight option for the documentation of this option.

Type:

string

Required:

False

Multiple:

True

All:

True

Value:

%notall pass => skip

secret option

Dynamic secret property value for the result. Momotor LTI will not show steps with a secret property set to true to learners, but will still show that step to reviewers.

The option value can be one of the following:

  • always or true: adds a secret property with value true to the result.

  • false: do not add a secret property to the result.

  • on-fail: adds a secret property with value true to the result if the step fails.

  • on-pass: adds a secret property with value true to the result if the step passed.

  • default: inherits the value from the next provider. If the last provider is ‘default’ no property will be added.

Note that this only adds a secret property with value true, but never one with value false. This ensures that a default defined in a recipe will be used unless the step or config explicitly override it.

The value can contain reference placeholders to inherit the value from another step’s options or properties.

Type:

Any

Required:

False

Multiple:

False

Default:

default

label option

Label for this step. Momotor LTI uses labels as the header of the step in the result view. If a step does not have a label, Momotor LTI will use the step id as the label.

Can contain reference placeholders and task id placeholders.

Type:

Any

Required:

False

Multiple:

False

Default:

No default

feedback-pass option

Feedback to prepend to the report property when this step passes.

Can contain reference placeholders and task id placeholders.

Type:

Any

Required:

False

Multiple:

False

Default:

No default

feedback-fail option

Feedback to prepend to the report property when this step fails.

Can contain reference placeholders and task id placeholders.

Type:

Any

Required:

False

Multiple:

False

Default:

No default

match option

Match rules for the files to check.

Can contain reference placeholders and task id placeholders, and these will be expanded before the match rules are parsed.

Type:

Any

Required:

False

Multiple:

True

All:

False

Value:

No values

accepted-file-class option

Default file class for files matching pass rules if no class is given in the match option.

If empty and the match option also do not supply a class, no file will be added to the result.

Type:

Any

Required:

False

Multiple:

False

Default:

accepted

rejected-file-class option

Default file class for files matching fail rules if no class is given in the match option.

If empty and the match option also do not supply a class, no file will be added to the result.

Type:

Any

Required:

False

Multiple:

False

Default:

rejected

remaining-file-class option

File class for files not matching any rules. Empty to not export these files.

Type:

Any

Required:

False

Multiple:

False

Default:

Empty string

report-title option

Title for the generated report.

Type:

Any

Required:

False

Multiple:

False

Default:

Checking expected files:

report-files option

Add a list of all files in the input ref to the report.

Type:

boolean

Required:

False

Multiple:

False

Default:

True

fail-reason option

Default reason message for the failure if no message is given in the match option.

Type:

Any

Required:

False

Multiple:

False

Default:

File check failed

input-file-ref option

Reference to the zip file(s) to consider. If multiple files are provided, they are treated as a single zip file, i.e. the files inside all of them are considered.

The reference is parsed with find_files(), see that method for details.

Type:

Any

Required:

False

Multiple:

True

All:

False

Value:

@result#check:zip