snowflake-cli 3.20.0__tar.gz → 3.21.0__tar.gz

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snowflake-cli
-Version: 3.20.0
+Version: 3.21.0
 Summary: Snowflake CLI
 Project-URL: Source code, https://github.com/snowflakedb/snowflake-cli
 Project-URL: Bug Tracker, https://github.com/snowflakedb/snowflake-cli/issues
@@ -227,7 +227,7 @@ Requires-Dist: gitpython==3.1.50
 Requires-Dist: id==1.5.0
 Requires-Dist: jinja2==3.1.6
 Requires-Dist: packaging==25.0
-Requires-Dist: pip==26.1.1
+Requires-Dist: pip==26.1.2
 Requires-Dist: pluggy==1.6.0
 Requires-Dist: prompt-toolkit==3.0.51
 Requires-Dist: protobuf<6,>=5.29.6

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/RELEASE-NOTES.md

@@ -23,6 +23,34 @@
 ## Fixes and improvements
 
 
+# v3.21.0
+
+## Deprecations
+
+## New additions
+* Added `cli.encoding` config section (and matching `SNOWFLAKE_CLI_ENCODING_*` env vars) to control text encoding in three areas: `file_io` for reading and writing project files (e.g. SQL files, `snowflake.yml`), `subprocess` for decoding output of external processes (e.g. Docker, pip), and `stdout` for encoding CLI output written to stdout. Setting all three to `utf-8` ensures correct Unicode handling on Windows systems where the platform default encoding is not UTF-8.
+* Added `--no-prompt-exit-repl` option and configuration setting to skip the exit confirmation prompt in the SQL REPL.
+* Added `--server-session-keep-alive` global connection flag (plus matching `SNOWFLAKE_SERVER_SESSION_KEEP_ALIVE` env var and `server_session_keep_alive` config key) that prevents Snowflake from closing idle sessions. Useful for long-running operations or connections held open between multiple operations.
+
+## Fixes and improvements
+* Fixed REST API object operations (e.g. `snow object create`) crashing with `ModuleNotFoundError: No module named 'snowflake.connector.vendored'` when running against the Snowflake Universal Driver (connector-python v5). HTTP error handling now works on both connector v4.x and the Universal Driver v5.
+* The `snow app setup` `--compute-pool` option and the `build_compute_pool` / `service_compute_pool` fields of a `snowflake-app` entity are now hidden and undocumented (omitted from `--help` and the generated project-definition JSON schema). They remain fully functional: `snow app setup` and `snow app deploy` still honor the `DEFAULT_SNOWFLAKE_APPS_BUILD_COMPUTE_POOL` / `DEFAULT_SNOWFLAKE_APPS_SERVICE_COMPUTE_POOL` account parameters and any compute pools configured in `snowflake.yml`. The `ENABLE_APPLICATION_SERVICE_MANAGED_COMPUTE_POOL` and `ENABLE_APPLICATION_SERVICE_MANAGED_COMPUTE_POOL_FALLBACK` parameter checks (and the related deploy-time warning) have been removed.
+* Fixed `snow app setup` incorrectly treating system-default parameter values as admin-configured values. After running `ALTER ACCOUNT UNSET` on `DEFAULT_SNOWFLAKE_APPS_BUILD_COMPUTE_POOL` or `DEFAULT_SNOWFLAKE_APPS_SERVICE_COMPUTE_POOL`, those fields no longer appear in the generated `snowflake.yml` or `--dry-run` output.
+* Upgraded `pip` from 26.1.1 to 26.1.2.
+* `snow app setup` and `snow app deploy` now default to a workspace (instead of a stage) for app code whenever the resolved destination is a personal database (`USER$<user>`), which do not support stages. An explicitly configured `code_stage` is still honored, with a warning when the destination is a personal database.
+* Fixed `snow app deploy` failing on Windows when uploading app code to a workspace (connector error `253006`, `ER_FILE_NOT_EXISTS`) due to a malformed local file URI.
+* Fixed `snow app deploy` failing with connector error `253006` when an app's files live under directories whose names contain glob metacharacters — for example Next.js dynamic-route directories such as `[id]` or `[...slug]`. The connector expands `PUT` sources as glob patterns, so the unescaped local path matched nothing (`File doesn't exist`) or a same-named sibling directory (`Not a file but a directory`). Local file paths are now escaped before being passed to `PUT`. This affected the workspace upload path used for personal-database destinations.
+* `snow app deploy` now uploads app code to a stage one file at a time (preserving the directory structure) instead of via a recursive `PUT <dir>/*`, and no longer deletes the local bundle during upload. The per-file form also avoids the directory-matching glob behind connector error `253006`.
+* The `build_eai` field of a `snowflake-app` entity can now be specified as a bare string (e.g. `build_eai: MY_EAI`) in addition to the existing `build_eai:\n  name: MY_EAI` object form.
+* `snow app setup` now honors the `--warehouse`, `--database`, and `--schema` connection options as explicit overrides for the generated `snowflake.yml`, taking precedence over account parameters and the connection defaults. This lets users target a warehouse, database, or schema other than the account defaults. When `--database` is specified, `--schema` must also be specified.
+* `snow dcm` commands now use the system temporary folder to bundle project files before uploading, rather than creating the `output` project directory and dropping it afterward
+* `snow dbt` no longer rejects valid `--dbt-version` values (e.g. `2.0.0-preview.175`) that don't match a hard-coded client-side regex. Versions are now validated against the server's supported list, with unsupported versions failing fast and listing the actual supported set.
+* Fixed `snow app` commands (e.g. `snow app deploy`, `snow app validate`) failing on Windows with a `UnicodeDecodeError` when `snowflake.yml` contained non-ASCII characters (e.g. a non-Latin app title or description). The `snow app` command group now defaults to reading and writing `snowflake.yml` as UTF-8 instead of falling back to the platform default code page (cp1252/cp932 on Windows). An explicit `cli.encoding.file_io` setting still takes precedence when configured; UTF-8 is only the default for `snow app` commands. Other commands continue to honor the `cli.encoding.file_io` setting / platform default when reading project files.
+* The `--deploy-only` flag of `snow app deploy` has been renamed to `--promote-only`. The previous `--deploy-only` name continues to work as a hidden alias for now, but this backward compatibility is temporary and will be removed soon.
+* `snow app deploy` now drops and recreates the code stage before uploading (instead of clearing it with `REMOVE`) so each deploy always starts from an empty stage. This prevents stale files from a previous deploy from being mixed into the build, which could produce incorrect or conflicting build artifacts.
+* `snow app deploy` now uploads app code files in parallel (up to 5 at a time) instead of one at a time, reducing upload time for apps with many files. This applies to both the stage and workspace upload paths.
+
+
 # v3.20.0
 
 ## Deprecations

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/docs/contributing/adding-commands.md

@@ -39,6 +39,20 @@ maintainer for review.
 
 ---
 
+## Design principles
+
+**Verbs for commands, nouns for groups.** The group is the entity (`snow git`,
+`snow stage`), the command is the action (`fetch`, `create`, `list`). Avoid dashes in
+command names unless the concept truly cannot be expressed otherwise.
+
+**Find the closest existing command first.** Match its flag names, output
+type, and default behavior. Consistency across groups beats local cleverness.
+
+**Commands are what, flags are how.** Flags are configuration and conditions for a
+command (`--force`, `--delta`, `--if-exists`), not an alternate operation.
+
+---
+
 ## Which case are you in?
 
 **Adding a command to an existing group** — skip to

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/pylock.toml

@@ -417,9 +417,9 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/20/12/38679034af33278
 
 [[packages]]
 name = "pip"
-version = "26.1.1"
-sdist = { url = "https://files.pythonhosted.org/packages/b6/48/cb9b7a682f6fe01a4221e1728941dd4ac3cd9090a17db3779d6ff490b602/pip-26.1.1.tar.gz", upload-time = 2026-05-04T19:02:21Z, size = 1840400, hashes = { sha256 = "d36762751d156a4ee895de8af39aa0abeeeb577f93a2eca6ab62467bbf0f8a78" } }
-wheels = [{ url = "https://files.pythonhosted.org/packages/3a/eb/fea4d1d51c49832120f7f285d07306db3960f423a2612c6057caf3e8196f/pip-26.1.1-py3-none-any.whl", upload-time = 2026-05-04T19:02:18Z, size = 1812777, hashes = { sha256 = "99cb1c2899893b075ff56e4ed0af55669a955b49ad7fb8d8603ecdaf4ed653fb" } }]
+version = "26.1.2"
+sdist = { url = "https://files.pythonhosted.org/packages/01/91/47e7d486260f618783899587af63ccf7980fb60245c3e63dd4571c6b57ad/pip-26.1.2.tar.gz", upload-time = 2026-05-31T17:33:58Z, size = 1840799, hashes = { sha256 = "f49cd134c61cf2fd75e0ce2676db03e4054504a5a4986d00f8299ae632dc4605" } }
+wheels = [{ url = "https://files.pythonhosted.org/packages/5d/95/6b5cb3461ea5673ba0995989746db58eb18b91b54dbf331e72f569540946/pip-26.1.2-py3-none-any.whl", upload-time = 2026-05-31T17:33:56Z, size = 1813144, hashes = { sha256 = "382ff9f685ee3bc25864f820aa50505825f10f5458ffff07e30a6d96e5715cab" } }]
 
 [[packages]]
 name = "platformdirs"

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/pyproject.toml

@@ -32,7 +32,7 @@ dependencies = [
   "id==1.5.0",
   "jinja2==3.1.6",
   "packaging==25.0",
-  "pip==26.1.1",
+  "pip==26.1.2",
   "pluggy==1.6.0",
   "prompt-toolkit==3.0.51",
   "protobuf>=5.29.6,<6",

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/snyk/requirements.txt

@@ -30,7 +30,7 @@ markupsafe==3.0.2
 mdurl==0.1.2
 more-itertools==10.7.0
 packaging==25.0
-pip==26.1.1
+pip==26.1.2
 platformdirs==4.3.8
 pluggy==1.6.0
 prompt-toolkit==3.0.51

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/src/snowflake/cli/__about__.py

@@ -19,22 +19,22 @@ import re
 import subprocess
 from enum import Enum, unique
 
-VERSION = "3.20.0"
+VERSION = "3.21.0"
 
 
 def get_display_version() -> str:
     """Return VERSION with short commit SHA appended for dev builds."""
     if re.search(r"\.dev\d*$", VERSION):
         try:
-            sha = (
-                subprocess.check_output(
-                    ["git", "rev-parse", "--short", "HEAD"],
-                    stderr=subprocess.DEVNULL,
-                    cwd=os.path.dirname(__file__),
-                )
-                .decode()
-                .strip()
-            )
+            sha = subprocess.check_output(
+                ["git", "rev-parse", "--short", "HEAD"],
+                stderr=subprocess.DEVNULL,
+                cwd=os.path.dirname(__file__),
+                # Git SHA is pure ASCII; hardcode utf-8 rather than
+                # routing through get_subprocess_encoding() to keep
+                # __about__ free of config-layer imports.
+                encoding="utf-8",
+            ).strip()
             return f"{VERSION} ({sha})"
         except Exception:
             return VERSION

snowflake_cli-3.21.0/src/snowflake/cli/_app/__main__.py

@@ -0,0 +1,58 @@
+# Copyright (c) 2024 Snowflake Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import codecs
+import io
+import os
+import sys
+
+from snowflake.cli._app.cli_app import CliAppFactory
+
+
+def _apply_stdout_encoding_from_env() -> None:
+    """Apply stdout encoding from env var before config is loaded.
+
+    Config-file encoding is applied later in config_init, but that runs inside
+    the CLI invocation after some output may already have been written. Reading
+    the env var here ensures the very first bytes use the right codec.
+    """
+    enc = os.environ.get("SNOWFLAKE_CLI_ENCODING_STDOUT")
+    if not enc:
+        return
+    try:
+        codecs.lookup(enc)
+    except LookupError:
+        # Silently skip — the invalid value will be caught again by
+        # get_stdout_encoding() → _validate_encoding() during config_init,
+        # which raises a proper ClickException with context.
+        return
+    try:
+        sys.stdout.reconfigure(encoding=enc)  # type: ignore[attr-defined,union-attr]
+    except (AttributeError, io.UnsupportedOperation):
+        pass
+
+
+def main(*args):
+    _apply_stdout_encoding_from_env()
+    app = CliAppFactory().create_or_get_app()
+    app(*args)
+
+
+if __name__ == "__main__":
+    main()
+
+if getattr(sys, "frozen", False):
+    main(sys.argv[1:])

{snowflake_cli-3.20.0 → snowflake_cli-3.21.0}/src/snowflake/cli/_app/snow_connector.py

@@ -90,6 +90,7 @@ SUPPORTED_ENV_OVERRIDES = [
     "oauth_enable_single_use_refresh_tokens",
     "client_store_temporary_credential",
     "secondary_roles",
+    "server_session_keep_alive",
 ]
 
 # mapping of found key -> key to set
@@ -109,6 +110,7 @@ _BOOLEAN_ENV_OVERRIDE_KEYS = frozenset(
         "oauth_enable_refresh_tokens",
         "oauth_enable_single_use_refresh_tokens",
         "client_store_temporary_credential",
+        "server_session_keep_alive",
     }
 )
 
@@ -313,6 +315,15 @@ def _avoid_closing_the_connection_if_it_was_shared(
     using_session_token: bool, using_master_token: bool, connection_parameters: Dict
 ):
     if using_session_token and using_master_token:
+        if (
+            "server_session_keep_alive" in connection_parameters
+            and connection_parameters["server_session_keep_alive"] is False
+        ):
+            log.warning(
+                "Overriding server_session_keep_alive=False to True because "
+                "session/master token authentication requires keep-alive to prevent "
+                "the shared connection from being closed."
+            )
         connection_parameters["server_session_keep_alive"] = True
         connection_parameters["client_session_keep_alive"] = True
         # Workaround: the connector crashes with TypeError when