Skip to main content

atmos plugin validate

Validate package metadata, supported capabilities, and local JSON schemas without executing plugin code.
Experimental
atmos plugin validate --help
 

Usage​

atmos plugin validate [directory]

Validation is static: it never starts the plugin, so it needs neither Go nor a built binary (use plugin test to run the executable). It checks the manifest, the capabilities against their registered extension schemas, and the local JSON schemas. It also applies the same bundle-path rules that pack and publish enforce: every declared executable path and every entry under schemas/ is rejected if it is hidden (.git, .env, .atmos, ...), looks like a credential, key, or Terraform state file, is not a canonical relative path, or is a symlink. The schemas/ directory may hold only regular .json files. A platform executable that already exists must also be a native binary for that platform; one that has not been built yet is skipped, but its path is still checked.

Successful validation confirms the package name and version, then displays its capabilities and exported names in a table. JSON schema metadata is available in the structured output when requested.

Arguments and flags​

directory
Package directory; defaults to the current directory.
--format
Output format: table (default), json, yaml, csv, or tsv. Also configurable with ATMOS_PLUGIN_FORMAT.

Examples​

atmos plugin validate ./corporate-oidc
atmos plugin validate ./corporate-oidc --format=json