Definitively.Domain.GhAction (definitively v0.3.0)

Pure gh argv builders and result parsers for GitHub CLI nodes.

Summary

argv()

Builds argv for a gh node.

Builds gh argv for the given action and options.

Extracts run id from gh run list JSON output.

Parses gh JSON stdout into signals and data.

@type argv() :: [String.t()]

@spec argv_for(Definitively.Domain.NodeDefinition.t()) ::
  {:ok, argv() | {:multi, [argv()]} | {:resolve_then_watch, argv()}}
  | {:error, term()}

Builds argv for a gh node.

@spec build_argv(atom(), map() | nil) ::
  {:ok, argv() | {:multi, [argv()]} | {:resolve_then_watch, argv()}}
  | {:error, term()}

Builds gh argv for the given action and options.

@spec extract_run_id(String.t()) :: {:ok, String.t()} | {:error, :no_run_found}

Extracts run id from gh run list JSON output.

@spec parse_result(atom(), non_neg_integer(), String.t()) :: {map(), map() | nil}

Parses gh JSON stdout into signals and data.