atmos vendor diff

Show the changes between two versions (tags, branches, or commits) of a vendored Git component, without a local checkout — useful for assessing impact before adopting a new version.

atmos vendor diff --help

Usage

atmos vendor diff --component <name> [--from <ref>] [--to <ref>] [--diff-file <path>]

--from defaults to the component's current pinned version and --to defaults to the latest tag. A missing or extra leading v is tolerated, so 2.0.0 resolves a v2.0.0 tag and vice versa.

Examples

# Diff the current pinned version against the latest tag.
atmos vendor diff --component vpc

# Diff two specific versions.
atmos vendor diff -c vpc --from 1.0.0 --to 2.0.0

# Restrict the diff to a single file.
atmos vendor diff -c vpc --from 1.0.0 --to 2.0.0 --diff-file variables.tf

Flags

--component / -c (string, required)

The component to diff.

--from (string)

Starting ref (tag, branch, or commit). Defaults to the current pinned version.

--to (string)

Ending ref. Defaults to the latest tag.

--diff-file (string)

Restrict the diff to a single file path within the component.

--file (string, default ./vendor.yaml)

The vendor manifest to read the component's source from (imports are followed).

note

Git sources only. The command performs a temporary clone (removed afterward); large repositories take proportionally longer. Private repositories are not yet supported.