snow helpers check-version¶

Reports the installed Snowflake CLI version alongside the latest published version and whether an upgrade is available. This command is the on-demand equivalent of the automatic upgrade banner shown after commands, and always reports its result regardless of the ignore_new_version_warning setting.

Syntax¶

snow helpers check-version
  --refresh
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes
  --decimal-precision <decimal_precision>

Arguments¶

None

Options¶

--refresh: Query PyPI and Homebrew for the latest version instead of using the local cache. Default: False.
--format [TABLE|JSON|JSON_EXT|CSV]: Specifies the output format. Default: TABLE.
--verbose, -v: Displays log entries for log levels info and higher. Default: False.
--debug: Displays log entries for log levels debug and higher; debug logs contain additional information. Default: False.
--silent: Turns off intermediate output to console. Default: False.
--enhanced-exit-codes: Differentiate exit error codes based on failure type. Default: False.
--decimal-precision INTEGER: Number of decimal places to display for decimal values. Uses Python’s default precision if not specified. [env var: SNOWFLAKE_DECIMAL_PRECISION].

--help: Displays the help text for this command.

Usage notes¶

snow helpers check-version doesn’t require a Snowflake connection. It checks locally cached version information by default. Use --refresh to query PyPI and Homebrew directly, bypassing the cache.

Examples¶

Check whether a newer version is available using the local cache:
```
snow helpers check-version
```
Query PyPI and Homebrew directly for the latest version:
```
snow helpers check-version --refresh
```