Imp.ExternalCommand (Imp v0.5.0)

Runs an executable with argv through Imp's shared process-group lifecycle.

The wrapper normalizes exit results and applies bounded redaction. It does not invoke a shell or implement a second process-management path.

Summary

result()

Starts a managed process group and returns after its OS group identity is known.

Synchronously stops a managed process group and verifies that the group is gone.

@type result() :: %{
  exit_status: non_neg_integer() | :timeout,
  output: String.t(),
  duration_ms: non_neg_integer()
}

@spec run(String.t(), [String.t()], keyword()) :: {:ok, result()} | {:error, term()}

@spec start(String.t(), [String.t()], keyword()) ::
  {:ok, Imp.ExternalCommand.Handle.t()} | {:error, term()}

Starts a managed process group and returns after its OS group identity is known.

@spec stop(Imp.ExternalCommand.Handle.t(), timeout()) :: :ok | {:error, term()}

Synchronously stops a managed process group and verifies that the group is gone.