snowflake-cli 3.0.2__tar.gz → 3.1.0__tar.gz

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: snowflake-cli
-Version: 3.0.2
+Version: 3.1.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
@@ -226,7 +226,7 @@ Requires-Dist: pydantic==2.9.2
 Requires-Dist: pyyaml==6.0.2
 Requires-Dist: requests==2.32.3
 Requires-Dist: requirements-parser==0.11.0
-Requires-Dist: rich==13.8.1
+Requires-Dist: rich==13.9.2
 Requires-Dist: setuptools==75.1.0
 Requires-Dist: snowflake-connector-python[secure-local-storage]==3.12.2
 Requires-Dist: snowflake-core==0.12.1; python_version < '3.12'
@@ -235,11 +235,13 @@ Requires-Dist: tomlkit==0.13.2
 Requires-Dist: typer==0.12.5
 Requires-Dist: urllib3<2.3,>=1.24.3
 Provides-Extra: development
-Requires-Dist: coverage==7.6.1; extra == 'development'
+Requires-Dist: coverage==7.6.3; extra == 'development'
+Requires-Dist: factory-boy==3.3.1; extra == 'development'
+Requires-Dist: faker==30.3.0; extra == 'development'
 Requires-Dist: pre-commit>=3.5.0; extra == 'development'
 Requires-Dist: pytest-randomly==3.15.0; extra == 'development'
 Requires-Dist: pytest==8.3.3; extra == 'development'
-Requires-Dist: syrupy==4.7.1; extra == 'development'
+Requires-Dist: syrupy==4.7.2; extra == 'development'
 Provides-Extra: packaging
 Requires-Dist: pyinstaller~=6.10; extra == 'packaging'
 Description-Content-Type: text/markdown
@@ -272,15 +274,13 @@ Snowflake CLI is an open-source command-line tool explicitly designed for develo
 
 With Snowflake CLI, developers can create, manage, update, and view apps running on Snowflake across workloads such as Streamlit in Snowflake, the Snowflake Native App Framework, Snowpark Container Services, and Snowpark. It supports a range of Snowflake features, including user-defined functions, stored procedures, Streamlit in Snowflake, and SQL execution.
 
-
 **Note**: Snowflake CLI is in Public Preview (PuPr).
 
-Docs: https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index.
-
-Quick start: https://quickstarts.snowflake.com/guide/getting-started-with-snowflake-cli
+Docs: <https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index>.
 
-Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md
+Quick start: <https://quickstarts.snowflake.com/guide/getting-started-with-snowflake-cli>
 
+Cheatsheet: <https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md>
 
 ## Install Snowflake CLI
 
@@ -289,7 +289,7 @@ Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake
 We recommend installing Snowflake CLI in isolated environment using [pipx](https://pipx.pypa.io/stable/). Requires Python >= 3.10
 
 ```bash
-pipx install snowflake-cli-labs
+pipx install snowflake-cli
 snow --help
 ```
 
@@ -322,4 +322,4 @@ You should now be able to run `snow` and get the CLI message.
 ## Get involved
 
 Have a feature idea? Running into a bug? Want to contribute? We'd love to hear from you!
-Please open or review issues, open pull requests, or reach out to us on developers@snowflake.com
+Please open or review issues, open pull requests, or reach out to us on <developers@snowflake.com>

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/README.md

@@ -26,15 +26,13 @@ Snowflake CLI is an open-source command-line tool explicitly designed for develo
 
 With Snowflake CLI, developers can create, manage, update, and view apps running on Snowflake across workloads such as Streamlit in Snowflake, the Snowflake Native App Framework, Snowpark Container Services, and Snowpark. It supports a range of Snowflake features, including user-defined functions, stored procedures, Streamlit in Snowflake, and SQL execution.
 
-
 **Note**: Snowflake CLI is in Public Preview (PuPr).
 
-Docs: https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index.
-
-Quick start: https://quickstarts.snowflake.com/guide/getting-started-with-snowflake-cli
+Docs: <https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index>.
 
-Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md
+Quick start: <https://quickstarts.snowflake.com/guide/getting-started-with-snowflake-cli>
 
+Cheatsheet: <https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md>
 
 ## Install Snowflake CLI
 
@@ -43,7 +41,7 @@ Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake
 We recommend installing Snowflake CLI in isolated environment using [pipx](https://pipx.pypa.io/stable/). Requires Python >= 3.10
 
 ```bash
-pipx install snowflake-cli-labs
+pipx install snowflake-cli
 snow --help
 ```
 
@@ -76,4 +74,4 @@ You should now be able to run `snow` and get the CLI message.
 ## Get involved
 
 Have a feature idea? Running into a bug? Want to contribute? We'd love to hear from you!
-Please open or review issues, open pull requests, or reach out to us on developers@snowflake.com
+Please open or review issues, open pull requests, or reach out to us on <developers@snowflake.com>

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/RELEASE-NOTES.md

@@ -13,17 +13,30 @@
  See the License for the specific language governing permissions and
  limitations under the License.
  -->
-# Unreleased version
+# v3.1.0
 ## Backward incompatibility
 
 ## Deprecations
+* Added deprecation warning in the description of `snow spcs service status` and `snow spcs image-repository list-tags`.
+* Completely removed the `snow app init` as it was replaced with `snow init` in Snowflake CLI 3.0
 
 ## New additions
+* Added `snow connection generate-jwt` command to generate JWT token for Snowflake connection.
+* Added `snow spcs service list-instances`, `snow spcs service list-containers` and `snow spcs service list-roles` commands, which support fetching information about all instances/containers/service roles in a service.
+* `snow spcs service set` now supports `--eai-name` to update external access integrations for a service.
 
 ## Fixes and improvements
-
+* Fixed a bug that would cause the `deploy_root`, `bundle_root`, and `generated_root` directories to be created in the current working directory instead of the project root when invoking commands with the `--project` flag from a different directory.
+* Align variables for `snow stage|git execute`. For Python files variables are stripped of leading and trailing quotes.
+* `snow spcs image-repository list-images` now displays image tag and digest.
+* Fix `snow stage list-files` for paths with directories.
+* `snow --info` callback returns information about `SNOWFLAKE_HOME` variable.
+* Removed requirement of existence of any `requirements.txt` file for Python code execution via `snow git execute` command.
+  Before the fix the file (even empty) was required to make the execution working.
+* Fix for list fields in mixins applied twice
 
 # v3.0.2
+
 ## Backward incompatibility
 
 ## Deprecations
@@ -31,9 +44,10 @@
 ## New additions
 
 ## Fixes and improvements
-* Fix handling empty default values for strings by `snow snowpark deploy`.
-* Log error details in case pip command fails.
 
+* Fixed the handling empty default values for strings by `snow snowpark deploy`.
+* Added log error details if the `pip` command fails.
+* Fix `snow git execute` support for Python files.
 
 # v3.0.1
 

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/pyproject.toml

@@ -29,7 +29,7 @@ dependencies = [
   "pluggy==1.5.0",
   "PyYAML==6.0.2",
   "packaging",
-  "rich==13.8.1",
+  "rich==13.9.2",
   "requests==2.32.3",
   "requirements-parser==0.11.0",
   "setuptools==75.1.0",
@@ -57,11 +57,13 @@ classifiers = [
 
 [project.optional-dependencies]
 development = [
-  "coverage==7.6.1",
+  "coverage==7.6.3",
   "pre-commit>=3.5.0",
   "pytest==8.3.3",
   "pytest-randomly==3.15.0",
-  "syrupy==4.7.1",
+  "syrupy==4.7.2",
+  "factory-boy==3.3.1",
+  "Faker==30.3.0",
 ]
 packaging = ["pyinstaller~=6.10"]
 
@@ -138,13 +140,13 @@ features = ["development"]
 
 [tool.hatch.envs.integration.scripts]
 test = [
-  "pytest -m integration -n6 --dist=worksteal --deflake-test-type=integration --ignore=tests_integration/spcs",
+  "pytest -m integration -n6 --dist=worksteal --deflake-test-type=integration --ignore=tests_integration/spcs tests_integration/",
 ]
 test-spcs = [
   "pytest -m integration -n6 --dist=worksteal --deflake-test-type=integration tests_integration/spcs",
 ]
 test_qa = [
-  "pytest -m 'integration and not no_qa' -n6 --dist=worksteal --deflake-test-type=integration",
+  "pytest -m 'integration and not no_qa' -n6 --dist=worksteal --deflake-test-type=integration tests_integration/",
 ]
 
 [[tool.hatch.envs.local.matrix]]

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/snyk/requirements.txt

@@ -2,7 +2,7 @@ jinja2==3.1.4
 pluggy==1.5.0
 PyYAML==6.0.2
 packaging
-rich==13.8.1
+rich==13.9.2
 requests==2.32.3
 requirements-parser==0.11.0
 setuptools==75.1.0
@@ -15,8 +15,10 @@ urllib3>=1.24.3,<2.3
 GitPython==3.1.43
 pip
 pydantic==2.9.2
-coverage==7.6.1
+coverage==7.6.3
 pre-commit>=3.5.0
 pytest==8.3.3
 pytest-randomly==3.15.0
-syrupy==4.7.1
+syrupy==4.7.2
+factory-boy==3.3.1
+Faker==30.3.0

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/__about__.py

@@ -14,4 +14,4 @@
 
 from __future__ import annotations
 
-VERSION = "3.0.2"
+VERSION = "3.1.0"

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_app/cli_app.py

@@ -15,6 +15,7 @@
 from __future__ import annotations
 
 import logging
+import os
 import platform
 import sys
 from dataclasses import dataclass
@@ -141,6 +142,7 @@ def _info_callback(value: bool):
                 {"key": "python_version", "value": sys.version},
                 {"key": "system_info", "value": platform.platform()},
                 {"key": "feature_flags", "value": get_feature_flags_section()},
+                {"key": "SNOWFLAKE_HOME", "value": os.getenv("SNOWFLAKE_HOME")},
             ],
         )
         print_result(result, output_format=OutputFormat.JSON)
@@ -155,6 +157,7 @@ def app_factory() -> SnowCliMainTyper:
         invoke_without_command=True,
         epilog=new_version_msg,
         result_callback=show_new_version_banner_callback(new_version_msg),
+        help=f"Snowflake CLI tool for developers [v{__about__.VERSION}]",
     )
     def default(
         ctx: typer.Context,

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_app/dev/docs/templates/overview.rst.jinja2

@@ -5,5 +5,5 @@ Global options
 ===============================================================================
 {% for param in options if not param.hidden %}
 :samp:`{% for p in param.opts %}{{ p }}{{ ", " if not loop.last }}{% endfor %}{% if not param.is_flag %} {{ '{' }}{{ param.name }}{{ '}' }}{% endif %}`
-{% if param.help %}{{ "  " + param.help | replace("`", "``") }}{% if param.help[-1] != '.' %}.{% endif %}{% else %}  TBD{% endif %}
+{% if param.help %}{{ "  " + param.help}}{% if param.help[-1] != '.' %}.{% endif %}{% else %}  TBD{% endif %}
 {% endfor %}

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_app/dev/docs/templates/usage.rst.jinja2

@@ -26,7 +26,7 @@ Arguments
         {{ param.make_metavar().replace("[", "").replace("]", "").lower() }}
     {%- endif -%}
     {{ '}' }}`
-{% if param.help %}{{ "  " + param.help | replace("`", "``") | replace("\n", " ") }}{% if param.help[-1] != '.' %}.{% endif %}{% if param.default %} Default: {{ param.default }}.{% endif %}{% else %}  TBD{% endif %}
+{% if param.help %}{{ "  " + param.help | replace("\n", " ") }}{% if param.help[-1] != '.' %}.{% endif %}{% if param.default %} Default: {{ param.default }}.{% endif %}{% else %}  TBD{% endif %}
 {% endfor %}
 {% else %}
 
@@ -48,7 +48,7 @@ Options
         {%- if param.type.name != "choice" %}{{ ' {' }}{% else %} {% endif %}{{ param.make_metavar() }}{% if param.type.name != "choice" %}{{ '}' }}
         {%- endif %}
     {%- endif %}`
-{% if param.help %}{{ "  " + param.help | replace("`", "``") | replace("\n", " ") }}{% if param.help[-1] != '.' %}.{% endif %}{% if param.default is not none %} Default: {{ param.default }}.{% endif %}{% else %}  TBD{% endif %}
+{% if param.help %}{{ "  " + param.help | replace("\n", " ") }}{% if param.help[-1] != '.' %}.{% endif %}{% if param.default is not none %} Default: {{ param.default }}.{% endif %}{% else %}  TBD{% endif %}
 {% endfor -%}
 {% else %}
 

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_app/telemetry.py

@@ -14,12 +14,14 @@
 
 from __future__ import annotations
 
+import os
 import platform
 import sys
 from enum import Enum, unique
 from typing import Any, Dict, Union
 
 import click
+import typer
 from snowflake.cli.__about__ import VERSION
 from snowflake.cli._app.constants import PARAM_APPLICATION_NAME
 from snowflake.cli.api.cli_global_context import (
@@ -30,6 +32,7 @@ from snowflake.cli.api.commands.execution_metadata import ExecutionMetadata
 from snowflake.cli.api.config import get_feature_flags_section
 from snowflake.cli.api.output.formats import OutputFormat
 from snowflake.cli.api.utils.error_handling import ignore_exceptions
+from snowflake.connector import ProgrammingError
 from snowflake.connector.telemetry import (
     TelemetryData,
     TelemetryField,
@@ -59,6 +62,7 @@ class CLITelemetryField(Enum):
     COMMAND_RESULT_STATUS = "command_result_status"
     COMMAND_OUTPUT_TYPE = "command_output_type"
     COMMAND_EXECUTION_TIME = "command_execution_time"
+    COMMAND_CI_ENVIRONMENT = "command_ci_environment"
     # Configuration
     CONFIG_FEATURE_FLAGS = "config_feature_flags"
     # Metrics
@@ -67,6 +71,9 @@ class CLITelemetryField(Enum):
     EVENT = "event"
     ERROR_MSG = "error_msg"
     ERROR_TYPE = "error_type"
+    ERROR_CODE = "error_code"
+    ERROR_CAUSE = "error_cause"
+    SQL_STATE = "sql_state"
     IS_CLI_EXCEPTION = "is_cli_exception"
     # Project context
     PROJECT_DEFINITION_VERSION = "project_definition_version"
@@ -81,6 +88,43 @@ class TelemetryEvent(Enum):
 TelemetryDict = Dict[Union[CLITelemetryField, TelemetryField], Any]
 
 
+def _is_cli_exception(exception: Exception) -> bool:
+    return isinstance(
+        exception,
+        (
+            click.ClickException,
+            typer.Exit,
+            typer.Abort,
+            BrokenPipeError,
+            KeyboardInterrupt,
+        ),
+    )
+
+
+def _get_additional_exception_information(exception: Exception) -> TelemetryDict:
+    """
+    Attach the errno and sqlstate if the exception or the
+    cause of the exception is a ProgrammingError
+    """
+    additional_info = {}
+
+    if isinstance(exception, ProgrammingError):
+        additional_info[CLITelemetryField.ERROR_CODE] = exception.errno
+        additional_info[CLITelemetryField.SQL_STATE] = exception.sqlstate
+
+    if exception.__cause__:
+        cause = exception.__cause__
+        additional_info[CLITelemetryField.ERROR_CAUSE] = type(cause).__name__
+
+        if isinstance(cause, ProgrammingError):
+            if not additional_info.get(CLITelemetryField.ERROR_CODE):
+                additional_info[CLITelemetryField.ERROR_CODE] = cause.errno
+            if not additional_info.get(CLITelemetryField.SQL_STATE):
+                additional_info[CLITelemetryField.SQL_STATE] = cause.sqlstate
+
+    return additional_info
+
+
 def _get_command_metrics() -> TelemetryDict:
     cli_context = get_cli_context()
 
@@ -110,9 +154,14 @@ def _find_command_info() -> TelemetryDict:
 
 
 def _get_definition_version() -> str | None:
-    cli_context = get_cli_context()
-    if cli_context.project_definition:
-        return cli_context.project_definition.definition_version
+    try:
+        cli_context = get_cli_context()
+        if cli_context.project_definition:
+            return cli_context.project_definition.definition_version
+    except Exception:
+        # Don't let an invalid project definition file break telemetry
+        # (especially for commands that don't normally load it)
+        pass
     return None
 
 
@@ -122,6 +171,20 @@ def _get_installation_source() -> CLIInstallationSource:
     return CLIInstallationSource.PYPI
 
 
+def _get_ci_environment_type() -> str:
+    if "GITHUB_ACTIONS" in os.environ:
+        return "GITHUB_ACTIONS"
+    if "GITLAB_CI" in os.environ:
+        return "GITLAB_CI"
+    if "CIRCLECI" in os.environ:
+        return "CIRCLECI"
+    if "JENKINS_URL" in os.environ or "HUDSON_URL" in os.environ:
+        return "JENKINS"
+    if "TF_BUILD" in os.environ:
+        return "AZURE_DEVOPS"
+    return "UNKNOWN"
+
+
 def command_info() -> str:
     info = _find_command_info()
     command = ".".join(info[CLITelemetryField.COMMAND])
@@ -148,6 +211,7 @@ class CLITelemetryClient:
             CLITelemetryField.VERSION_CLI: VERSION,
             CLITelemetryField.VERSION_OS: platform.platform(),
             CLITelemetryField.VERSION_PYTHON: python_version(),
+            CLITelemetryField.COMMAND_CI_ENVIRONMENT: _get_ci_environment_type(),
             CLITelemetryField.CONFIG_FEATURE_FLAGS: {
                 k: str(v) for k, v in get_feature_flags_section().items()
             },
@@ -202,7 +266,7 @@ def log_command_result(execution: ExecutionMetadata):
 @ignore_exceptions()
 def log_command_execution_error(exception: Exception, execution: ExecutionMetadata):
     exception_type: str = type(exception).__name__
-    is_cli_exception: bool = issubclass(exception.__class__, click.ClickException)
+    is_cli_exception: bool = _is_cli_exception(exception)
     _telemetry.send(
         {
             TelemetryField.KEY_TYPE: TelemetryEvent.CMD_EXECUTION_ERROR.value,
@@ -210,6 +274,7 @@ def log_command_execution_error(exception: Exception, execution: ExecutionMetada
             CLITelemetryField.ERROR_TYPE: exception_type,
             CLITelemetryField.IS_CLI_EXCEPTION: is_cli_exception,
             CLITelemetryField.COMMAND_EXECUTION_TIME: execution.get_duration(),
+            **_get_additional_exception_information(exception),
             **_get_command_metrics(),
         }
     )

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/connection/commands.py

@@ -18,9 +18,10 @@ import logging
 import os.path
 
 import typer
-from click import ClickException, Context, Parameter  # type: ignore
+from click import ClickException, Context, Parameter, UsageError  # type: ignore
 from click.core import ParameterSource  # type: ignore
 from click.types import StringParamType
+from snowflake import connector
 from snowflake.cli._plugins.connection.util import (
     strip_and_check_if_exists,
     strip_if_value_present,
@@ -342,7 +343,7 @@ def test(
 @app.command(requires_connection=False)
 def set_default(
     name: str = typer.Argument(
-        help="Name of the connection, as defined in your `config.toml`",
+        help="Name of the connection, as defined in your `config.toml` file",
         show_default=False,
     ),
     **options,
@@ -351,3 +352,40 @@ def set_default(
     get_connection_dict(connection_name=name)
     set_config_value(section=None, key="default_connection_name", value=name)
     return MessageResult(f"Default connection set to: {name}")
+
+
+@app.command(requires_connection=True)
+def generate_jwt(
+    **options,
+) -> CommandResult:
+    """Generate and display a JWT token."""
+    connection_details = get_cli_context().connection_context.update_from_config()
+
+    msq_template = (
+        "{} is not set in the connection context, but required for JWT generation."
+    )
+    if not connection_details.user:
+        raise UsageError(msq_template.format("User"))
+    if not connection_details.account:
+        raise UsageError(msq_template.format("Account"))
+    if not connection_details.private_key_file:
+        raise UsageError(msq_template.format("Private key file"))
+    passphrase = os.getenv("PRIVATE_KEY_PASSPHRASE", None)
+    if not passphrase:
+        passphrase = typer.prompt(
+            "Enter private key file password (Press enter if none)",
+            hide_input=True,
+            type=str,
+            default="",
+        )
+
+    try:
+        token = connector.auth.get_token_from_private_key(
+            user=connection_details.user,
+            account=connection_details.account,
+            privatekey_path=connection_details.private_key_file,
+            key_password=passphrase,
+        )
+        return MessageResult(token)
+    except ValueError as err:
+        raise ClickException(str(err))

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/git/commands.py

@@ -333,12 +333,15 @@ def execute(
     **options,
 ):
     """
-    Execute immediate all files from the repository path. Files can be filtered with glob like pattern,
+    Execute immediate all files from the repository path. Files can be filtered with a glob-like pattern,
     e.g. `@my_repo/branches/main/*.sql`, `@my_repo/branches/main/dev/*`. Only files with `.sql`
-    extension will be executed.
+    or `.py` extension will be executed.
     """
     results = GitManager().execute(
-        stage_path=repository_path, on_error=on_error, variables=variables
+        stage_path_str=repository_path,
+        on_error=on_error,
+        variables=variables,
+        requires_temporary_stage=True,
     )
     return CollectionResult(results)
 

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/git/manager.py

@@ -26,6 +26,7 @@ from snowflake.cli._plugins.stage.manager import (
     UserStagePathParts,
 )
 from snowflake.cli.api.identifiers import FQN
+from snowflake.cli.api.stage_path import StagePath
 from snowflake.connector.cursor import SnowflakeCursor
 
 # Replace magic numbers with constants
@@ -78,6 +79,10 @@ class GitStagePathParts(StagePathParts):
 
 
 class GitManager(StageManager):
+    @staticmethod
+    def build_path(stage_path: str) -> StagePathParts:
+        return StagePath.from_git_str(stage_path)
+
     def show_branches(self, repo_name: str, like: str) -> SnowflakeCursor:
         return self._execute_query(f"show git branches like '{like}' in {repo_name}")
 

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/nativeapp/artifacts.py

@@ -225,9 +225,7 @@ class _ArtifactPathMap:
 
         current_is_dir = self._dest_is_dir.get(dest, None)
         if current_is_dir is not None and current_is_dir != is_dir:
-            raise ArtifactError(
-                "Conflicting type for destination path: {canonical_dest}"
-            )
+            raise ArtifactError(f"Conflicting type for destination path: {dest}")
 
         parent = dest.parent
         if parent != dest:
@@ -240,9 +238,21 @@ class BundleMap:
     """
     Computes the mapping between project directory artifacts (aka source artifacts) to their deploy root location
     (aka destination artifact). This information is primarily used when bundling a native applications project.
+
+    :param project_root: The root directory of the project and base for all relative paths. Must be an absolute path.
+    :param deploy_root: The directory where artifacts should be copied to. Must be an absolute path.
     """
 
     def __init__(self, *, project_root: Path, deploy_root: Path):
+        # If a relative path ends up here, it's a bug in the app and can lead to other
+        # subtle bugs as paths would be resolved relative to the current working directory.
+        assert (
+            project_root.is_absolute()
+        ), f"Project root {project_root} must be an absolute path."
+        assert (
+            deploy_root.is_absolute()
+        ), f"Deploy root {deploy_root} must be an absolute path."
+
         self._project_root: Path = resolve_without_follow(project_root)
         self._deploy_root: Path = resolve_without_follow(deploy_root)
         self._artifact_map = _ArtifactPathMap(project_root=self._project_root)

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/nativeapp/codegen/artifact_processor.py

@@ -36,7 +36,7 @@ class UnsupportedArtifactProcessorError(ClickException):
 
 
 def is_python_file_artifact(src: Path, _: Path):
-    """Determines whether the provided source path is an existing python file."""
+    """Determines whether the provided source path is an existing Python file."""
     return src.is_file() and src.suffix == ".py"
 
 

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/nativeapp/codegen/compiler.py

@@ -65,10 +65,17 @@ class NativeAppCompiler:
         self,
         bundle_ctx: BundleContext,
     ):
+        self._assert_absolute_paths(bundle_ctx)
         self._bundle_ctx = bundle_ctx
         # dictionary of all processors created and shared between different artifact objects.
         self.cached_processors: Dict[str, ArtifactProcessor] = {}
 
+    @staticmethod
+    def _assert_absolute_paths(bundle_ctx: BundleContext):
+        for name in ["Project", "Deploy", "Bundle", "Generated"]:
+            path = getattr(bundle_ctx, f"{name.lower()}_root")
+            assert path.is_absolute(), f"{name} root {path} must be an absolute path."
+
     def compile_artifacts(self):
         """
         Go through every artifact object in the project definition of a native app, and execute processors in order of specification for each of the artifact object.

{snowflake_cli-3.0.2 → snowflake_cli-3.1.0}/src/snowflake/cli/_plugins/nativeapp/codegen/sandbox.py

@@ -29,10 +29,10 @@ EnvVars = Mapping[str, str]  # Only support str -> str for cross-platform compat
 
 
 class SandboxExecutionError(ClickException):
-    """An error occurred while executing a python script."""
+    """An error occurred while executing a Python script."""
 
     def __init__(self, error: str):
-        super().__init__(f"Failed to execute python script. {error}")
+        super().__init__(f"Failed to execute Python script. {error}")
 
 
 def _get_active_venv_dir() -> Optional[str]:
@@ -63,7 +63,7 @@ def _execute_python_interpreter(
     env_vars: Optional[EnvVars],
 ) -> subprocess.CompletedProcess:
     if not python_executable:
-        raise SandboxExecutionError("No python executable found")
+        raise SandboxExecutionError("No Python executable found")
 
     if isinstance(python_executable, str) or isinstance(python_executable, Path):
         args = [python_executable]
@@ -106,7 +106,7 @@ def _execute_in_venv(
             f"venv path must be an existing directory: {resolved_venv_path}"
         )
 
-    # find the python interpreter for this environment. There is no need to activate environment prior to invoking the
+    # find the Python interpreter for this environment. There is no need to activate environment prior to invoking the
     # interpreter, as venv maintains the invariant that invoking any of the scripts will set up the virtual environment
     # correctly. activation scripts are only used for convenience in interactive shells.
     if _is_ms_windows():
@@ -116,7 +116,7 @@ def _execute_in_venv(
 
     if not python_executable.is_file():
         raise SandboxExecutionError(
-            f"No venv python executable found: {resolved_venv_path}"
+            f"No venv Python executable found: {resolved_venv_path}"
         )
 
     return _execute_python_interpreter(
@@ -189,14 +189,14 @@ def execute_script_in_sandbox(
     **kwargs,
 ) -> subprocess.CompletedProcess:
     """
-    Executes a python script in a sandboxed environment, and returns its output. The script is executed in a different
+    Executes a Python script in a sandboxed environment, and returns its output. The script is executed in a different
     process. The execution environment is determined by the `env_type` argument. By default, the logic will attempt
     to auto-detect the correct environment by looking for an active venv or conda environment. If none can be found, it
-    will use the system's default python executable, as determined by the user's path. As a last resort, the current
-    python execution environment will be used (still in a subprocess).
+    will use the system's default Python executable, as determined by the user's path. As a last resort, the current
+    Python execution environment will be used (still in a subprocess).
 
     Parameters:
-        script_source (str): The python script to be executed, as a string.
+        script_source (str): The Python script to be executed, as a string.
         env_type: The type of execution environment to use (default: ExecutionEnvironmentType.AUTO_DETECT).
         cwd (Optional[Union[str, Path]]): An optional path to use as the current directory when executing the script.
         timeout (Optional[int]): An optional timeout in seconds when executing the script. Defaults to no timeout.
@@ -248,7 +248,7 @@ def execute_script_in_sandbox(
 class SandboxEnvBuilder(EnvBuilder):
     """
     A virtual environment builder that can be used to build an environment suitable for
-    executing user-provided python scripts in an isolated sandbox.
+    executing user-provided Python scripts in an isolated sandbox.
     """
 
     def __init__(self, path: Path, **kwargs) -> None: