flow_options: flow options used to initialize or update an eddy

Description Usage Arguments Details Value

Description

flow options used to initialize or update an eddy

default flow options used to initialize or update an eddy.

Usage

1
2
3
4
5
6
7
8
9
default_flow_options(excluded_arg = character(),
  split_bare_list = TRUE, split_dataframe = FALSE, split_fn = NULL)

set_flow_options(excluded_arg = NULL, split_bare_list = NULL,
  split_dataframe = NULL, split_fn = NULL, eddy = get_current_eddy())

get_flow_options(excluded_arg = NULL, eval_arg_fn = NULL,
  split_bare_list = NULL, split_dataframe = NULL, split_fn = NULL,
  eddy = get_current_eddy())

Arguments

excluded_arg

A vector of argument names to be excluded when computing the input hash. Best used to exclude certain arguments that depend on the running state, e.g. a Shiny session, a parallel cluster, etc. Excluded arguments must have a default value to permit lazy computations. The default is not to exclude any arguments from the input hash.

split_bare_list

If the function output is a bare list (rlang::is_bare_list), determines whether to calculate the hash of each list element and create corresponding flow elements.

split_dataframe

If the function output is a data.frame or tibble, determines whether to calculate the hash of each column and create corresponding flow elements.

split_fn

Custom function to generate a list of elements from the output of the flow-ed function. Useful only if the output is not a list but a flow elements are still desired. Consider returning a list as output before using this option. If an split_fn is provided, split_bare_list and split_dataframe will be ignored.

eddy

Eddy to apply / retrieve options to / from.

eval_arg_fn

Custom function to parse the input arguments and create a list of evaluated arguments to be hashed. This function should have the exact same arguments as the original function. Try to use excluded_arg or flow source before creating a custom function. Because each custom function is flow specific, it is not possible to set this option at the eddy level using set_flow_options.

Details

If used in set_flow_options, these options will be stored in eddy and retrieved by each flow subsequently executed. E.g. if not careful, it is possible to force all following flows to use a custom split_fn function, which is not recommended.

Sets a list of default options.

set_flow_options does not overwrite the current options when the argument is NULL.

Value

For default_flow_options, a list of options.

For set_flow_options, NULL.

For get_flow_options, a list of options including the eddy.


numeract/rflow documentation built on May 28, 2019, 3:39 p.m.