Skip to content

cub space edit

cub space edit

Edit a space in your system's editor

Synopsis

Open a space in the editor named by the EDITOR environment variable, or vi if it is not set, as a document: the fields an update can set, with the entities the space refers to named rather than identified by ID. When the editor exits, the space is updated with what changed: fields left alone keep what the space holds, and fields removed are cleared. If nothing changed, no update is made. If the space changed since it was read, the update is refused; edit it again.

A space with a backing Unit is edited through the Unit: the edit is saved as a Revision of the Unit, the Unit's triggers run, and the space is then updated from the Unit, unless they report validation errors. The edit is refused when the Unit has changes the space has not taken, unless --force is given, which applies them along with the edit.

An edit that cannot be saved is left in a file, whose name is reported.

cub space edit <space> [flags]

Options

      --force           edit the space's backing Unit even though it has changes the space has not taken, and apply them with the edit
  -h, --help            help for edit
  -o, --output string   Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --quiet           No default output.
      --verbose         Detailed output, additive with default output

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output

SEE ALSO