state-flow.core — nubank/state-flow 5.5.0

as-step-fn clj deprecated

(as-step-fn flow)

DEPRECATED with no replacement.

current-description clj

(current-description)

Returns a flow that returns the description as of the point of execution.

For internal use. Subject to change.

default-stack-trace-exclusions clj

filter-stack-trace clj

(filter-stack-trace)

(filter-stack-trace exclusions)

Returns an error handler which, if the first element in the pair is a failure, returns the pair with the failure's stack-trace filtered, else returns the pair as/is.

exclusions (default default-stack-trace-exclusions) is a sequence of regular expressions used to match class names in stack trace frames. Matching frames are excluded.

flow clj macro

(flow description & flows)

Creates a flow which is a composite of flows.

flow* clj

(flow* {:keys [description caller-meta]} & flows)

For use in macros that create flows. Not private (appropriate for helper libraries, for example), but not intended for use directly in flows.

Creates a flow which is a composite of flows. The calling macro should provide (meta &form) as :caller-meta in order to support accurate line number reporting.

ignore-error clj

(ignore-error pair)

No-op error handler that ignores the error.

log-and-throw-error! clj deprecated

(log-and-throw-error! pair)

DEPRECATED: Use (comp throw-error! log-error) instead.

log-error clj

(log-error pair)

Error handler that logs error and returns pair.

modify-meta clj

(modify-meta f & args)

Returns a monad that will apply vary-meta to the world.

For internal use. Subject to change.

pop-meta clj

(pop-meta)

Returns a flow that will modify the state metadata.

For internal use. Subject to change.

push-meta clj

(push-meta description {:keys [line]})

Returns a flow that will modify the state metadata.

For internal use. Subject to change.

run clj

(run flow)

(run flow initial-state)

Given an initial-state (default {}), runs a flow and returns a tuple of the result of the last step in the flow and the end state.

run! clj deprecated

(run! flow)

(run! flow initial-state)

DEPRECATED. Use run*

run* clj

(run* {:keys [init cleanup runner on-error]
       :or {init (constantly {})
            cleanup identity
            runner run
            on-error (comp throw-error!
                           log-error
                           (filter-stack-trace default-stack-trace-exclusions))}
       :as opts}
      flow)

Runs a flow with specified parameters. Use run unless you need the customizations run* supports.

Supported keys in the first argument are:

:init optional, default (constantly {}), function of no arguments that returns the initial state :cleanup optional, default identity, function of the final state used to perform cleanup, if necessary :runner optional, default run, function of a flow and an initial state which will execute the flow :on-error optional, function of the final result pair to be invoked when the first value in the pair represents an error, default:

              `(comp throw-error!
                     log-error
                     (filter-stack-trace default-strack-trace-exclusions))`

runner clj

(runner)

Creates a flow that returns the runner (function). Useful for helpers that need to access the runner.

throw-error! clj

(throw-error! pair)

Error handler that throws the error.

top-level-description clj

(top-level-description s)

Returns the description passed to the top level flow (or the stringified symbol passed to defflow).