Skip to content

cub unit diff

cub unit diff

Show differences between revisions

Synopsis

Show differences between revisions of a unit, or between two units.

Revision References: - Absolute: 123, 456 - Named: HeadRevisionNum, LiveRevisionNum, LastAppliedRevisionNum, PreviousLiveRevisionNum - Relative: -1, -2, -3 (N revisions back from HeadRevisionNum) - Tag: Tag:release-v1.0 - ChangeSet: ChangeSet:feature-deploy

Output Formats: - Default: Line-numbered format with color - Unified: Use -u for unified diff format (like git diff) - Color: Use -c to enable color in unified diff - Mutations: Use --display-mutations for structured mutation display

Examples: 

  # Basic (defaults: LiveRevisionNum vs HeadRevisionNum)
  cub unit diff my-unit

  # Specific revisions
  cub unit diff my-unit --from=123 --to=456
  cub unit diff my-unit 123 456

  # Named revisions
  cub unit diff my-unit --from=LastAppliedRevisionNum
  cub unit diff my-unit --from=PreviousLiveRevisionNum

  # Relative to head
  cub unit diff my-unit --from=-1
  cub unit diff my-unit --from=-2 --to=-1

  # Unified diff format
  cub unit diff -u my-unit
  cub unit diff -uc my-unit --from=-1

  # Cross-unit diff
  cub unit diff my-unit --with-unit other-unit

  # Show mutations instead of text diff
  cub unit diff my-unit --display-mutations

cub unit diff <unit-slug> [fromRev] [toRev] [flags]

Options

  -c, --color               colorize the unified diff output (default: true for numbered diff)
      --display-mutations   display resource mutations instead of text diff
      --from string         source revision (defaults to LiveRevisionNum) (default "LiveRevisionNum")
  -h, --help                help for diff
      --to string           target revision (defaults to HeadRevisionNum) (default "HeadRevisionNum")
  -u, --unified             output unified diff format
      --with-unit string    second unit for cross-unit diff (slug, space/slug, or UUID)

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output
      --space string     space ID to perform command on

SEE ALSO