Skip to main content

Pipe Fail (trypipe)

Laurence MorganAbout 1 minBuiltin CommandsError Handling

Pipe Fail (trypipe)

Checks for non-zero exits of each function in a pipeline

Description

trypipe checks the state of each function and exits the block if any of them fail. Where trypipe differs from regular try blocks is trypipe will check every process along the pipeline as well as the terminating function (which try only validates against). The downside to this is that piped functions can no longer run in parallel.

Usage

trypipe { code-block } -> <stdout>

<stdin> -> trypipe { -> code-block } -> <stdout>

Examples

trypipe {
    out "Hello, World!" -> grep: "non-existent string" -> cat
    out "This command will be ignored"
}

Formated pager (less) where the pager isn't called if the formatter (pretty) fails (eg input isn't valid JSON):

func pless {
    -> trypipe { -> pretty -> less }
}

Detail

A failure is determined by:

  • Any process that returns a non-zero exit number

You can see which run mode your functions are executing under via the fid-list command.

See Also


This document was generated from builtins/core/structs/try_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan,Laurence Morgan,Laurence,Olivier Refalo