hpcflow.sdk.cli_common#

Click CLI options that are used as decorators in multiple modules.

Module attributes

format_option(f)

Click option decorator: If specified, one of "json" or "yaml".

path_option(f)

Click option decorator: The directory in which the workflow will be generated.

name_option(f)

Click option decorator: The name of the workflow.

name_timestamp_option(f)

name_dir_option(f)

overwrite_option(f)

Click option decorator: If True and the workflow directory (path + name) already exists, the existing directory will be overwritten.

store_option(f)

Click option decorator: The persistent store type to use.

ts_fmt_option(f)

Click option decorator: The datetime format to use for storing datetimes.

ts_name_fmt_option(f)

Click option decorator: The datetime format to use when generating the workflow name, where it includes a timestamp.

variables_option(f)

Click option decorator: Workflow template variable value to be substituted in to the template file or string.

js_parallelism_option(f)

Click option decorator: If True, allow multiple jobscripts to execute simultaneously.

wait_option(f)

Click option decorator: If True, this command will block until the workflow execution is complete.

add_to_known_opt(f)

Click option decorator: If True, add this submission to the known-submissions file.

print_idx_opt(f)

Click option decorator: If True, print the submitted jobscript indices for each submission index.

tasks_opt(f)

Click option decorator: List of comma-separated task indices to include in this submission.

cancel_opt(f)

Click option decorator: Immediately cancel the submission.

submit_status_opt(f)

Click option decorator: If True, display a live status to track submission progress.

submit_quiet_opt(f)

Click option decorator: If True, do not print anything about workflow submission.

wait_quiet_opt(f)

Click option decorator: If True, do not print anything (e.g. when jobscripts have completed).

cancel_quiet_opt(f)

Click option decorator: If True, do not print anything (e.g. which jobscripts where cancelled).

force_arr_opt(f)

Click option decorator: Used to force the use of job arrays, even if the scheduler does not support it.

make_status_opt(f)

Click option decorator: If True, display a live status to track workflow creation progress.

add_sub_opt(f)

zip_path_opt(f)

Click option decorator: Path at which to create the new zipped workflow.

zip_overwrite_opt(f)

Click option decorator: If set, any existing file will be overwritten.

zip_log_opt(f)

Click option decorator: Path to a log file to use during zipping.

zip_include_execute_opt(f)

zip_include_rechunk_backups_opt(f)

unzip_path_opt(f)

Click option decorator: Path at which to create the new unzipped workflow.

unzip_log_opt(f)

Click option decorator: Path to a log file to use during unzipping.

rechunk_backup_opt(f)

Click option decorator: First copy a backup of the array to a directory ending in .bak.

rechunk_chunk_size_opt(f)

Click option decorator: New chunk size (array items per chunk).

rechunk_status_opt(f)

Click option decorator: If True, display a live status to track rechunking progress.

cancel_status_opt(f)

Click option decorator: If True, display a live status to track cancel progress.

list_js_max_js_opt(f)

Click option decorator: Display up to this jobscript only.

list_js_jobscripts_opt(f)

Click option decorator: Comma-separated list of jobscript indices to show.

list_task_js_max_js_opt(f)

Click option decorator: Include jobscripts up to this jobscript only.

list_task_js_task_names_opt(f)

Click option decorator: Comma-separated list of task name sub-strings to show.

list_js_width_opt(f)

Click option decorator: Width in characters of the table to print.

jobscript_std_array_idx_opt(f)

Click option decorator: For array jobs only, the job array index whose standard stream is to be printed.

env_add_replace_opt(f)

Click option decorator: If True, replace an existing environment with the same name and specifiers.

env_add_source_file_opt(f)

Click option decorator: The environment source file to save the environment to, if specified.

env_add_source_file_name_opt(f)

Click option decorator: The file name of the environment source file within the app config directory to save the environment to, if --env-source-file is not provided.

pytest_file_or_dir_opt(f)

Click option decorator: Paths to test files or directories to include in the Pytest run.

Functions

sub_tasks_callback

Parse subtasks.

Classes

BoolOrString

Custom Click parameter type to accepts a bool or a choice of strings.