SNOW-2665953: Make Streamlit Deployment with Versioned Stages as Default in Snow CLI (#2685)

* Make versioned Streamlit deployment the default behavior

## Changes

### CLI Behavior
- `snow streamlit deploy` now uses versioned deployment (FROM syntax) by default
- Added `--legacy` flag to use old ROOT_LOCATION deployment
- `--experimental` flag is now deprecated but still works (shows warning)

### Code Changes
- Added `--legacy` flag to streamlit deploy command
- Inverted deployment logic: `if experimental` → `if not legacy`
- Renamed `_deploy_experimental()` → `_deploy_versioned()`
- Removed `ENABLE_STREAMLIT_VERSIONED_STAGE` feature flag
- Updated `_is_spcs_runtime_v2_mode()` to not require experimental flag
- SPCS runtime v2 (compute pools) only available in versioned mode

### Test Updates
- Added `--legacy` flag to 12 unit tests expecting ROOT_LOCATION behavior
- Removed `--experimental` flag from tests now using default behavior
- Removed `with_feature_flags` wrapper and parametrization
- Updated integration tests to reflect new default

## Breaking Change
The default deployment mode changes from ROOT_LOCATION to versioned deployment.
Users who want the old behavior must use `--legacy` flag.

* Update --legacy flag help text: deployment → stages

* Refactor: Extract legacy deployment logic into _deploy_legacy() method

For consistency with _deploy_versioned(), extracted the else block's
deployment logic into a dedicated _deploy_legacy() method. This improves
code organization and makes the deploy() method cleaner.

* Use positive condition for legacy flag check

Changed from 'if not legacy' to 'if legacy' for better readability.
The positive condition directly maps to the flag name and avoids mental negation.

* Fix lint: Break long lines to comply with 88 char limit

- Split long comment in _deploy_legacy() method
- Break deprecation warning string across multiple lines
- Format long test invocation call
- Fix typo: elswhere → elsewhere

* Fix black formatting

* Add validation to prevent SPCS runtime v2 usage with --legacy flag

* Add documentation for deprecated --experimental flag and parameter naming

* Fix test_artifacts.py tests to use --legacy flag for artifact tests

* Fix integration tests for versioned Streamlit deployment

Update test_streamlit_flow and test_streamlit_deploy_prune_flag to work with
versioned Streamlit deployment (now the default behavior).

Changes:
- test_streamlit_flow: Update stage paths from legacy app_1_stage to versioned
  snow://streamlit/{DB}.{SCHEMA}.app_1/versions/live/
- test_streamlit_deploy_prune_flag: Rewrite to use managed versioned stages
  instead of user-created stages

Files are now uploaded to managed stages at versions/live/ path instead of
user-specified ROOT_LOCATION stages.

* Fix unit tests for versioned Streamlit deployment

- Add mock for describe() method to return versioned stage path
- Update test_deploy to use legacy=True for testing old behavior
- Replace experimental parameter with legacy parameter in SPCS runtime v2 tests
- Fix test_deploy_with_spcs_runtime_v2_and_legacy_flag_raises_error invalid parameters

Changes reflect that versioned deployment is now the default, and the
experimental flag has been replaced with a legacy flag to opt into old behavior.

* Update help message snapshots for streamlit deploy

- Add --legacy flag to streamlit deploy help text
- Remove oauth-token-request-url parameter (deprecated)

These changes reflect the new default versioned deployment behavior.

* Fix help message snapshots - restore oauth-token-request-url for all commands except streamlit

The previous commit incorrectly removed oauth-token-request-url from ALL commands.
This parameter should only be excluded from streamlit.deploy command, but remain
in all other commands' help text.

* Restore oauth-token-request-url to streamlit.deploy help message

This parameter is a standard connection option that applies to all commands
including streamlit. Cannot be removed from just streamlit.deploy.

* Fix test_streamlit_deploy_prune_flag: add --overwrite flag for streamlit stage

Snowflake requires overwrite=true when uploading to streamlit versioned stages.
The test was failing because stage copy needs --overwrite flag when uploading
to snow://streamlit/ managed stages.

* Fix test_streamlit_deploy_prune_flag: test with --legacy flag

Versioned stages are managed by Snowflake's FBE and have different file
lifecycle behavior. The prune flag functionality is primarily for legacy
ROOT_LOCATION stages where the CLI has full control over file management.

Changed the test to use --legacy flag to properly test the prune
functionality on legacy stages instead of versioned stages.

* Address PR review comments: simplify help text, use CliError, and reduce comment bloat

* Fix test_streamlit_deploy_prune_flag database context mismatch

* Fix unit test: update exception type to CliError and mock bundle to avoid file errors

* Update help message snapshot for --legacy flag text change

* Add gitattributes to ensure snapshot files use consistent encoding across platforms

* Fix Unicode smart quotes in snapshot file - replace with ASCII apostrophes

* Address PR review comments: add RELEASE-NOTES entry, move test imports to top, add deployment style change warnings

* Fix integration test: use fully qualified stage name to match deployment database context

* Fix integration test: explicitly set database and schema for streamlit deploy commands

* Fix integration test: remove explicit database/schema flags, rely on test_database fixture env var

* Fix integration test

* Update RELEASE-NOTES to reflect deprecations and new additions for `snow streamlit deploy` and `snow dbt` commands, including versioned deployment and legacy support. Enhance clarity by formatting entries as bullet points.

Author: sfc-gh-svishnu

.gitattributes

@@ -0,0 +1,2 @@
+# Ensure snapshot files are treated as text with LF line endings and UTF-8 encoding
+*.ambr text eol=lf

RELEASE-NOTES.md

@@ -18,10 +18,14 @@
 
 ## Deprecations
 
+* `snow streamlit deploy --experimental` flag is deprecated. Versioned deployment is now the default behavior.
+
 ## New additions
 
-## Fixes and improvements
+* `snow streamlit deploy` now uses versioned stages by default (modern FROM syntax with automatic version management)
+* Added `snow streamlit deploy --legacy` flag to use the legacy ROOT_LOCATION deployment for backward compatibility
 
+## Fixes and improvements
 
 # v3.13.1
 ## Backward incompatibility
@@ -55,33 +59,34 @@
 * Grant privileges defined in `snowflake.yml` after deploying Streamlit
 * Relaxed dbt profiles.yml validation rules; added extra validation for role specified in profiles.yml
 
-
 # v3.12.0
 
 ## Deprecations
 
 ## New additions
+
 * The `!edit` command for external editors was added to REPL
 * Added `--partial` flag to `snow logs` command for partial, case-insensitive object name matching
 
 ## Fixes and improvements
+
 * Fixed crashes with older x86_64 Intel CPUs
 * Improved parsing `!source` with trailing comments
 * `!` commands no longer require trailing `;` for evaluation
 * Bumped to `typer=0.17.3`. Improved displaying help messages.
 * Fixed using `ctx.var` in `snow sql` with Jinja templating.
 * Fixed issues when pasting content with trailing new lines.
-* Improved output handling  with streaming
+* Improved output handling with streaming
 * Bumped `snowflake-connector-python` to 3.17.3
 * Fixed `snow snowpark deploy` failing on duplicated packages
 * Fixed `snow spcs logs` `IndexOutOfRange` error
 
-
 # v3.11.0
 
 ## Deprecations
 
 ## New additions
+
 * Add `snow connection remove` command
 * Added support for `runtime_environment_version` field in notebook entity configuration, allowing specification of runtime environment version for containerized notebooks.
 * Added `snow auth oidc` command group for managing workload identity federation authentication:
@@ -90,24 +95,25 @@
 
 ## Fixes and improvements
 
-
 # v3.10.1
 
 ## Deprecations
 
 ## New additions
 
 ## Fixes and improvements
+
 * Fixed DBT deploy command to properly handle fully qualified names
 * Fixed DBT deploy command to properly handle local directories with dots in names
 
-
 # v3.10.0
 
 ## Deprecations
+
 * Snowpark processor in Native Apps.
 
 ## New additions
+
 * Add support for passing OAuth token via `--token` flag.
 * Added feature to allow suppressing the new version warning message in the Snowflake CLI, configurable via a configuration file or environment variable.
 * Add support for `--format=CSV`.
@@ -120,52 +126,53 @@
 * DBT commands: `deploy`, `execute` and `list` are now available in preview.
 
 ## Fixes and improvements
+
 * Fixed failing snow sql command when snowflake.yml is invalid and query has no templating.
 * Fix JSON serialization for `Decimal`, `time` and `binary`.
 * Added `--format=JSON_EXT` option to return JSON objects as proper JSON structures rather than strings.
 * Refactored Streamlit app deployment (using `FROM <stage>` syntax); removed deprecated Streamlit features
 
-
 # v3.9.1
 
 ## Deprecations
 
 ## New additions
+
 * Added `--private-link` flag to `snow spcs image-registry login` command to login using private link URLs.
 
 ## Fixes and improvements
 
-
 # v3.9.0
 
 ## Deprecations
 
 ## New additions
+
 * Added `--encryption` flag to `snow stage create` command defining the type of encryption for all files on the stage.
 
 ## Fixes and improvements
-* Fix `use` commands error if current database is not set.
 
+* Fix `use` commands error if current database is not set.
 
 # v3.8.3
 
 ## Deprecations
 
 ## New additions
+
 * Added `--private-link` flag to `snow spcs image-registry url` command for retrieving private link URLs.
 
 ## Fixes and improvements
 
-
 # v3.8.2
 
 ## Deprecations
 
 ## New additions
 
 ## Fixes and improvements
-* Fix `enable_release_channels` property in application package definition to default to `None` instead of `False`.
 
+* Fix `enable_release_channels` property in application package definition to default to `None` instead of `False`.
 
 # v3.8.1
 
@@ -174,15 +181,16 @@
 ## New additions
 
 ## Fixes and improvements
+
 * Upgrade message is printed to stderr.
 * Fixed `snowflake.core` import issue on newer Python versions
 
-
 # v3.8.0
 
 ## Deprecations
 
 ## New additions
+
 * Added support for OAuth tokens.
 * Cleaning up the output directory after coping files to the stage for Streamlit, Notebook, SPCS Service and project.
 * Added interactive mode for `snow sql`.
@@ -192,21 +200,21 @@
 * Added `--single-transaction` flag to `snow sql`. Wraps BEGIN/COMMIT around statements to execute them as a single transaction, ensuring all commands complete successfully or no change is applied.
 
 ## Fixes and improvements
+
 * Fix for deploying Snowpark project using `!=` operator in `requirements.txt`.
 * Fix escaping identifiers for `use` commands.
 * Move `enable_release_channels` from global feature flag to project level.
 * Fixed `snow spcs service metrics` command to accept fully qualified service names.
 
-
 # v3.7.2
 
 ## Deprecations
 
 ## New additions
 
 ## Fixes and improvements
-* Fix error appearing on help messages after click BCR update.
 
+* Fix error appearing on help messages after click BCR update.
 
 # v3.7.1
 
@@ -215,32 +223,35 @@
 ## New additions
 
 ## Fixes and improvements
+
 * Fix certificate connection issues.
 * Fix `snow spcs image-registry login` slow query problem.
 
-
 # v3.7.0
 
 ## Deprecations
 
 ## New additions
+
 * Added `--prune` flag to `deploy` commands, which removes files that exist in the stage,
   but not in the local filesystem.
 * Added `snow logs` command for retrieving and streaming logs from the server.
 * Added `snow helper check-snowsql-env-vars` which reports environment variables from SnowSQL with replacements in CLI.
 
 ## Fixes and improvements
-* Updated MacOS postinstall script to update PATH if snow not exist.
 
+* Updated MacOS postinstall script to update PATH if snow not exist.
 
 # v3.6.0
 
 ## Deprecations
 
 ## New additions
+
 * Added support for `!source` command in SQL. This command allows to execute SQL from a local file.
 
 ## Fixes and improvements
+
 * Fix for incompatible options in `snow spcs compute-pool` commands didn't raise error.
 * Change binary builds to embed whole Python environment.
 * Fixed recursive copying to stage for unbalanced directory trees.
@@ -252,6 +263,7 @@
 ## Deprecations
 
 ## New additions
+
 * Extended snowflake.yml support for new entities:
   * SPCS compute pool
   * SPCS service
@@ -262,9 +274,11 @@
 * Added support for creating native applications with manifest version 2.
 
 ## Fixes and improvements
+
 * Fix handling of date types in `snow sql` command when using JSON for output format
 
 # v3.4.1
+
 ## Backward incompatibility
 
 ## Deprecations
@@ -290,10 +304,10 @@
   * Added notebooks to `snow object` commands.
 
 ## Fixes and improvements
+
 * Fixed MFA caching issue in binaries.
 * Fixed auto-completion issue in binaries.
 
-
 # v3.3.0
 
 ## Backward incompatibility
@@ -446,7 +460,7 @@
   * `snow snowpark build` creates a .zip file for each specified artifact that is a directory. Non-Anaconda
     dependencies are packaged once as `dependencies.zip`.
   * `snow snowpark deploy` uploads all artifacts created during build step. Dependencies zip is upload once to
-     every Snowpark stage specified in project definition.
+    every Snowpark stage specified in project definition.
   * The changes are compatible with V1 projects definition though the result state (file layout) is different.
   * `snow snowpark package` commands no longer fallback to Anaconda Channel metadata when fetching available packages info fails.
   * Added `snow streamlit execute app-name` command to run Streamlit apps in a Snowflake environment in headless mode.
@@ -540,7 +554,7 @@
 ## Deprecations
 
 * `snow snowpark init` and `snow streamlit init` are marked as deprecated. The commands are still functional,
-but should be replaced with `snow init`
+  but should be replaced with `snow init`
 
 ## New additions
 
@@ -594,9 +608,9 @@ but should be replaced with `snow init`
   * Overrides `env` variables values when used in templating.
   * Can be referenced in templating through `ctx.env.<key_name>`.
   * Templating will read env vars in this order of priority (highest priority to lowest priority):
-    * vars from `--env` command line argument.
-    * vars from shell environment variables.
-    * vars from `env` section of project definition file.
+    - vars from `--env` command line argument.
+    - vars from shell environment variables.
+    - vars from `env` section of project definition file.
 
 ## Fixes and improvements
 
@@ -666,19 +680,19 @@ but should be replaced with `snow init`
   * `snow spcs image-repository` for image repositories
   * `snow spcs service` for services
 * `snow sql` works now with `snowflake.yml` file. The variables defined in the new `env` section
-       of `snowflake.yml` will be used to expand templates.
+  of `snowflake.yml` will be used to expand templates.
 * `snow sql` support executing multiple files. Users can use `-f/--file` flag more than once to execute queries
-      from many files.
+  from many files.
 * `snow git execute` and `snow stage execute` support passing input variables for SQL execution.
 * Added `snow cortex` commands:
   * `complete` - Given a prompt, the command generates a response using your choice of language model.
-      In the simplest use case, the prompt is a single string. You may also provide a JSON file with conversation history including multiple prompts and responses for interactive chat-style usage.
+    In the simplest use case, the prompt is a single string. You may also provide a JSON file with conversation history including multiple prompts and responses for interactive chat-style usage.
   * `extract-answer` - Extracts an answer to a given question from a text document.
-      The document may be a plain-English document or a string representation of a semi-structured (JSON) data object.
+    The document may be a plain-English document or a string representation of a semi-structured (JSON) data object.
   * `sentiment` - Returns sentiment as a score between -1 to 1 (with -1 being the most negative and 1 the most positive, with values around 0 neutral) for the given English-language input text.
   * `summarize` - Summarizes the given English-language input text.
   * `translate` - Translates text from the indicated or detected source language to a target language.
-  * `search`    - for integration with Cortex Search Service
+  * `search` - for integration with Cortex Search Service
 * When invoked without command help is displayed by default with list of available commands.
 * Add tab-completion for `snow` command.
 
@@ -747,7 +761,7 @@ but should be replaced with `snow init`
   * `--check-anaconda-for-pypi-depts` is deprecated and using it will cause warning, the functionality is replaced by `--ignore-anaconda`
   * `--package-native-libraries` is deprecated and using it will cause warning, the functionality is replaced by `--allow-shared-libraries`
 * `snow object stage` commands are deprecated and using them will cause a warning.
-   Functionality is replaced by `snow stage` commands.
+  Functionality is replaced by `snow stage` commands.
 
 ## New additions
 
@@ -846,6 +860,7 @@ but should be replaced with `snow init`
   The `SNOWFLAKE_CONNECTION_<NAME>_<KEY>` variable takes precedence before the generic flag. For example if
   `SNOWFLAKE_PASSWORD` and `SNOWFLAKE_CONNECTIONS_FOO_PASSWORD` are present and user tries to use connection
   "foo" then the later variable will be used.
+
 * Testing connection using `snow connection test` validates also access to database, schema, role and warehouse
   specified in the connection details.
 * Added `snow connection set-default` command for changing default connection.
@@ -872,10 +887,12 @@ but should be replaced with `snow init`
 * `snow connection test` now outputs all connection details (except for the password), along with connection status
 * `snow sql` requires explicit `-i` flag to read input from stdin: `cat my.sql | snow sql -i`
 * Switched to Python Connector default connection <https://docs.snowflake.com/en/developer-guide/python-connector/python-connector-connect#setting-a-default-connection>
+
   * Default connection name changed from `dev` to `default`
   * Environment variable for default connection name changed from `SNOWFLAKE_OPTIONS_DEFAULT_CONNECTION` to `SNOWFLAKE_DEFAULT_CONNECTION_NAME`
 
 * Snowpark changes
+
   * Removed `procedure` and `function` subgroups.
   * Removed `snow snowpark function package` and `snow snowpark procedure package` in favour of `snow snowpark build`.
   * Removed `snow snowpark function create` and `snow snowpark function update`. Functions can be deployed using `snow snowpark deploy`.
@@ -887,6 +904,7 @@ but should be replaced with `snow init`
   * Coverage commands were removed. To measure coverage of your procedures or functions use coverage locally.
 
 * Snowpark Containers services commands
+
   * `cp` alias for `compute-pool` commands was removed.
   * `services` commands were renamed to `service`
   * `registry` commands were renamed to `image-registry`