snowflake-cli-labs 2.3.1__tar.gz → 2.4.0rc0__tar.gz

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/.gitignore

@@ -15,6 +15,8 @@ dist/
 .coverage
 gen_docs/
 /venv/
+.env
+.vscode
 
 ^app.zip
 ^snowflake.yml

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/.pre-commit-config.yaml

@@ -47,7 +47,8 @@ repos:
           ^src/snowflake/cli/templates/.*$|
           ^src/snowflake/cli/api/utils/rendering.py$|
           ^src/snowflake/cli/plugins/spcs/common.py$|
-          ^src/snowflake/cli/plugins/snowpark/venv.py$
+          ^src/snowflake/cli/plugins/snowpark/venv.py$|
+          ^src/snowflake/cli/app/cli_app.py$
       - id: check-app-imports-in-api
         language: pygrep
         name: "No top level cli.app imports in cli.api"

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/CONTRIBUTING.md

@@ -90,6 +90,7 @@ grant create database on account to role <role_name>;
 grant create role on account to role <role_name>;
 grant usage on warehouse xsmall to role <role_name>;
 grant operate on warehouse xsmall to role <role_name>;
+grant create database on account to role <role_name> with grant option;
 ```
 
 ## Remote debugging with PyCharm or IntelliJ

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: snowflake-cli-labs
-Version: 2.3.1
+Version: 2.4.0rc0
 Summary: Snowflake CLI
 Project-URL: Source code, https://github.com/snowflakedb/snowflake-cli
 Project-URL: Bug Tracker, https://github.com/snowflakedb/snowflake-cli/issues
@@ -219,6 +219,7 @@ Classifier: Topic :: Database
 Requires-Python: >=3.8
 Requires-Dist: gitpython==3.1.43
 Requires-Dist: jinja2==3.1.4
+Requires-Dist: packaging
 Requires-Dist: pip
 Requires-Dist: pluggy==1.5.0
 Requires-Dist: pydantic==2.7.1
@@ -228,7 +229,8 @@ Requires-Dist: requirements-parser==0.9.0
 Requires-Dist: rich==13.7.1
 Requires-Dist: setuptools==69.5.1
 Requires-Dist: snowflake-connector-python[secure-local-storage]==3.10.0
-Requires-Dist: tomlkit==0.12.3
+Requires-Dist: snowflake-core==0.8.0; python_version < '3.12'
+Requires-Dist: tomlkit==0.12.5
 Requires-Dist: typer==0.12.3
 Requires-Dist: urllib3<2.3,>=1.21.1
 Provides-Extra: development

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/RELEASE-NOTES.md

@@ -1,12 +1,60 @@
-# v2.3.1
+# Unreleased version
+## Backward incompatibility
+
+## Deprecations
+
+## New additions
+
+## Fixes and improvements
+
+
+# v2.4.0
 ## Backward incompatibility
 
 ## Deprecations
 
 ## New additions
+* Added the `--cascade` option to `snow app teardown` command that drops all application objects owned by the application.
+ * Add external access integration to snow object commands
+ * Add aliases for `snow object list/describe/drop` commands under:
+   * `snow stage` for stages
+   * `snow git` for git repository stages
+   * `snow streamlit` for streamlit apps
+   * `snow snowpark` for procedures and functions
+   * `snow spcs compute-pool` for compute pools
+   * `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.
+ * `snow sql` support executing multiple files. Users can use `-f/--file` flag more than once to execute queries
+      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.
+    * `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.
+    * `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
+* When invoked without command help is displayed by default with list of available commands.
+* Add tab-completion for `snow` command.
 
 ## Fixes and improvements
 * Improved support for quoted identifiers.
+* Fixed creating patches with `snow app version create` when there are 2 or more existing patches on a version
+* Using `--format=json` adds trailing new line to avoid `%` being added by some terminals to signal no new line at the end of output.
+* Fixed `--interactive` flag to be enabled by default in interactive environments and added the `--no-interactive` flag to be able to turn off prompting.
+
+# v2.3.1
+## Backward incompatibility
+
+## Deprecations
+
+## New additions
+
+## Fixes and improvements
 * Fixed bugs in source artifact mapping logic for native applications
 
 # v2.3.0
@@ -31,6 +79,7 @@
 * Added support for fully qualified stage names in stage and git execute commands.
 * Fixed a bug where `snow app run` was not upgrading the application when the local state and remote stage are identical (for example immediately after `snow app deploy`).
 * Fixed handling of stage path separators on Windows
+* Change to `external_access_integrations` in `snowflake.yml` now also triggers function replace
 * The `--info` callback returns info about configured feature flags.
 
 # v2.2.0

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/performance_history_analysis.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import subprocess
 from decimal import Decimal
 from timeit import default_timer as timer

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/pyproject.toml

@@ -14,12 +14,14 @@ dependencies = [
   "jinja2==3.1.4",
   "pluggy==1.5.0",
   "PyYAML==6.0.1",
+  "packaging",
   "rich==13.7.1",
   "requests==2.31.0",
   "requirements-parser==0.9.0",
   "setuptools==69.5.1",
+  'snowflake.core==0.8.0; python_version < "3.12"',
   "snowflake-connector-python[secure-local-storage]==3.10.0",
-  "tomlkit==0.12.3",
+  "tomlkit==0.12.5",
   "typer==0.12.3",
   "urllib3>=1.21.1,<2.3",
   "GitPython==3.1.43",
@@ -96,11 +98,12 @@ template = "integration"
 pre-install-commands = [
   "pip install test_external_plugins/snowpark_hello_single_command",
   "pip install test_external_plugins/multilingual_hello_command_group",
+  "pip install pytest-xdist",
 ]
 features = ["development"]
 
 [tool.hatch.envs.integration.scripts]
-test = ["pytest -m integration --snapshot-warn-unused"]
+test = ["pytest -m integration -n4 --dist=loadfile --snapshot-warn-unused"]
 test-experimental = [
   "pytest -m integration_experimental --snapshot-warn-unused",
 ]
@@ -125,6 +128,7 @@ select = [
   "SLF",    # Accessing private methods
   "F401",   # unused imports
   "F403",   # star imports
+  "FA100",  # Missing from __future__ import annotations
 ]
 
 [tool.pytest.ini_options]

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/snyk/requirements.txt

@@ -1,12 +1,14 @@
 jinja2==3.1.4
 pluggy==1.5.0
 PyYAML==6.0.1
+packaging
 rich==13.7.1
 requests==2.31.0
 requirements-parser==0.9.0
 setuptools==69.5.1
+snowflake.core==0.8.0; python_version < "3.12"
 snowflake-connector-python[secure-local-storage]==3.10.0
-tomlkit==0.12.3
+tomlkit==0.12.5
 typer==0.12.3
 urllib3>=1.21.1,<2.3
 GitPython==3.1.43

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/__about__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-VERSION = "2.3.1"
+VERSION = "2.4.0rc0"

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Optional
 
 from snowflake.cli.api.plugins.plugin_config import PluginConfigProvider

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/cli_global_context.py

@@ -1,9 +1,12 @@
+from __future__ import annotations
+
 import re
 from pathlib import Path
 from typing import Dict, Optional
 
 from snowflake.cli.api.exceptions import InvalidSchemaError
 from snowflake.cli.api.output.formats import OutputFormat
+from snowflake.cli.api.project.schemas.project_definition import ProjectDefinition
 from snowflake.connector import SnowflakeConnection
 
 schema_pattern = re.compile(r".+\..+")
@@ -280,6 +283,10 @@ class _CliGlobalContextAccess:
     def connection(self) -> SnowflakeConnection:
         return self._manager.connection
 
+    @property
+    def connection_context(self) -> _ConnectionContext:
+        return self._manager.connection_context
+
     @property
     def enable_tracebacks(self) -> bool:
         return self._manager.enable_tracebacks
@@ -297,7 +304,7 @@ class _CliGlobalContextAccess:
         return self._manager.experimental
 
     @property
-    def project_definition(self):
+    def project_definition(self) -> ProjectDefinition | None:
         return self._manager.project_definition
 
     @property

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/commands/decorators.py

@@ -29,7 +29,7 @@ from snowflake.cli.api.commands.flags import (
     VerboseOption,
     WarehouseOption,
     experimental_option,
-    project_definition_option,
+    project_type_option,
 )
 from snowflake.cli.api.exceptions import CommandReturnTypeError
 from snowflake.cli.api.output.formats import OutputFormat
@@ -67,7 +67,7 @@ def with_project_definition(project_name: str):
                     "project_definition",
                     inspect.Parameter.KEYWORD_ONLY,
                     annotation=Optional[str],
-                    default=project_definition_option(project_name),
+                    default=project_type_option(project_name),
                 )
             ],
         )

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/commands/flags.py

@@ -12,6 +12,7 @@ import typer
 from click import ClickException
 from snowflake.cli.api.cli_global_context import cli_context_manager
 from snowflake.cli.api.console import cli_console
+from snowflake.cli.api.exceptions import MissingConfiguration
 from snowflake.cli.api.output.formats import OutputFormat
 
 DEFAULT_CONTEXT_SETTINGS = {"help_option_names": ["--help", "-h"]}
@@ -416,7 +417,6 @@ VariablesOption = typer.Option(
     "--variable",
     "-D",
     help="Variables for the template. For example: `-D \"<key>=<value>\"`, string values must be in `''`.",
-    hidden=True,
     show_default=False,
 )
 
@@ -469,17 +469,21 @@ def experimental_option(
 
 def identifier_argument(sf_object: str, example: str) -> typer.Argument:
     return typer.Argument(
-        ..., help=f"Identifier of the {sf_object}. For example: {example}"
+        ...,
+        help=f"Identifier of the {sf_object}. For example: {example}",
+        show_default=False,
     )
 
 
 def execution_identifier_argument(sf_object: str, example: str) -> typer.Argument:
     return typer.Argument(
-        ..., help=f"Execution identifier of the {sf_object}. For example: {example}"
+        ...,
+        help=f"Execution identifier of the {sf_object}. For example: {example}",
+        show_default=False,
     )
 
 
-def project_definition_option(project_name: str):
+def project_type_option(project_name: str):
     from snowflake.cli.api.exceptions import NoProjectDefinitionError
     from snowflake.cli.api.project.definition_manager import DefinitionManager
 
@@ -515,6 +519,47 @@ def project_definition_option(project_name: str):
     )
 
 
+def project_definition_option(optional: bool = False):
+    from snowflake.cli.api.project.definition_manager import DefinitionManager
+
+    def _callback(project_path: Optional[str]):
+        try:
+            dm = DefinitionManager(project_path)
+            project_definition = dm.project_definition
+            project_root = dm.project_root
+        except MissingConfiguration:
+            if optional:
+                project_definition = None
+                project_root = None
+            else:
+                raise
+        cli_context_manager.set_project_definition(project_definition)
+        cli_context_manager.set_project_root(project_root)
+        return project_definition
+
+    return typer.Option(
+        None,
+        "-p",
+        "--project",
+        help=f"Path where Snowflake project resides. Defaults to current working directory.",
+        callback=_callback,
+        show_default=False,
+    )
+
+
+def readable_file_option(param_name: str, help_str: str) -> typer.Option:
+    return typer.Option(
+        None,
+        param_name,
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        help=help_str,
+        show_default=False,
+    )
+
+
 def deprecated_flag_callback(msg: str):
     def _warning_callback(ctx: click.Context, param: click.Parameter, value: Any):
         if ctx.get_parameter_source(param.name) != click.core.ParameterSource.DEFAULT:  # type: ignore[attr-defined]

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/commands/snow_typer.py

@@ -22,6 +22,8 @@ class SnowTyper(typer.Typer):
             **kwargs,
             context_settings=DEFAULT_CONTEXT_SETTINGS,
             pretty_exceptions_show_locals=False,
+            no_args_is_help=True,
+            add_completion=True,
         )
 
     @wraps(typer.Typer.command)

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/console/abc.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from abc import ABC, abstractmethod
 from contextlib import contextmanager
 from typing import Callable, Iterator, Optional

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/console/console.py

@@ -57,11 +57,12 @@ class CliConsole(AbstractConsole):
         self._print(self._format_message(enter_message, Output.PHASE))
         self._in_phase = True
 
-        yield self.step
-
-        self._in_phase = False
-        if exit_message:
-            self._print(self._format_message(exit_message, Output.PHASE))
+        try:
+            yield self.step
+        finally:
+            self._in_phase = False
+            if exit_message:
+                self._print(self._format_message(exit_message, Output.PHASE))
 
     def step(self, message: str):
         """Displays a message to output.

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/constants.py

@@ -23,6 +23,11 @@ class ObjectType(Enum):
     DATABASE = ObjectNames("database", "database", "databases")
     FUNCTION = ObjectNames("function", "function", "functions")
     INTEGRATION = ObjectNames("integration", "integration", "integrations")
+    EXTERNAL_ACCESS_INTEGRATION = ObjectNames(
+        "external-access-integration",
+        "external access integration",
+        "external access integrations",
+    )
     # JOB = ObjectNames("job", "job", "jobs")
     NETWORK_RULE = ObjectNames("network-rule", "network rule", "network rules")
     PROCEDURE = ObjectNames("procedure", "procedure", "procedures")

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/exceptions.py

@@ -128,3 +128,15 @@ class SchemaNotProvidedError(ClickException):
         super().__init__(
             "Schema not specified. Please update connection to add `schema` parameter, or re-run command using `--schema` option. Use `snow connection list` to list existing connections."
         )
+
+
+class FQNNameError(ClickException):
+    def __init__(self, name: str):
+        super().__init__(f"Specified name '{name}' is not valid name.")
+
+
+class FQNInconsistencyError(ClickException):
+    def __init__(self, part: str, name: str):
+        super().__init__(
+            f"{part.capitalize()} provided but name '{name}' is fully qualified name."
+        )

snowflake_cli_labs-2.4.0rc0/src/snowflake/cli/api/identifiers.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import re
+
+from click import ClickException
+from snowflake.cli.api.cli_global_context import cli_context
+from snowflake.cli.api.exceptions import FQNInconsistencyError, FQNNameError
+from snowflake.cli.api.project.schemas.identifier_model import ObjectIdentifierBaseModel
+from snowflake.cli.api.project.util import VALID_IDENTIFIER_REGEX, unquote_identifier
+
+
+class FQN:
+    """
+    Class representing an identifier and supporting fully qualified names.
+
+    The instance supports builder pattern that allows updating the identifier with database and
+    schema from different sources. For example:
+
+    fqn = FQN.from_string("my_schema.object").using_connection(conn)
+    fqn = FQN.from_identifier_model(cli_context.project_definition.streamlit).using_context()
+    fqn = FQN.from_string("my_name").set_database("db").set_schema("foo")
+    """
+
+    def __init__(self, database: str | None, schema: str | None, name: str):
+        self._database = database
+        self._schema = schema
+        self._name = name
+
+    @property
+    def database(self) -> str | None:
+        return self._database
+
+    @property
+    def schema(self) -> str | None:
+        return self._schema
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def identifier(self) -> str:
+        if self.database:
+            return f"{self.database}.{self.schema if self.schema else 'PUBLIC'}.{self.name}"
+        if self.schema:
+            return f"{self.schema}.{self.name}"
+        return self.name
+
+    @property
+    def url_identifier(self) -> str:
+        return ".".join(unquote_identifier(part) for part in self.identifier.split("."))
+
+    def __str__(self):
+        return self.identifier
+
+    def __eq__(self, other):
+        return self.identifier == other.identifier
+
+    @classmethod
+    def from_string(cls, identifier: str) -> "FQN":
+        """
+        Takes in an object name in the form [[database.]schema.]name. Returns a FQN instance.
+        """
+        qualifier_pattern = rf"(?:(?P<first_qualifier>{VALID_IDENTIFIER_REGEX})\.)?(?:(?P<second_qualifier>{VALID_IDENTIFIER_REGEX})\.)?(?P<name>{VALID_IDENTIFIER_REGEX})(?P<signature>\(.*\))?"
+        result = re.fullmatch(qualifier_pattern, identifier)
+
+        if result is None:
+            raise FQNNameError(identifier)
+
+        unqualified_name = result.group("name")
+        if result.group("second_qualifier") is not None:
+            database = result.group("first_qualifier")
+            schema = result.group("second_qualifier")
+        else:
+            database = None
+            schema = result.group("first_qualifier")
+        if signature := result.group("signature"):
+            unqualified_name = unqualified_name + signature
+        return cls(name=unqualified_name, schema=schema, database=database)
+
+    @classmethod
+    def from_identifier_model(cls, model: ObjectIdentifierBaseModel) -> "FQN":
+        """Create an instance from object model."""
+        if not isinstance(model, ObjectIdentifierBaseModel):
+            raise ClickException(
+                f"Expected {type(ObjectIdentifierBaseModel)}, got {model}."
+            )
+
+        fqn = cls.from_string(model.name)
+
+        if fqn.database and model.database:
+            raise FQNInconsistencyError("database", model.name)
+        if fqn.schema and model.schema_name:
+            raise FQNInconsistencyError("schema", model.name)
+
+        return fqn.set_database(model.database).set_schema(model.schema_name)
+
+    def set_database(self, database: str | None) -> "FQN":
+        if database:
+            self._database = database
+        return self
+
+    def set_schema(self, schema: str | None) -> "FQN":
+        if schema:
+            self._schema = schema
+        return self
+
+    def set_name(self, name: str) -> "FQN":
+        self._name = name
+        return self
+
+    def using_connection(self, conn) -> "FQN":
+        """Update the instance with database and schema from connection."""
+        # Update the identifier only it if wasn't already a qualified name
+        if conn.database and not self.database:
+            self.set_database(conn.database)
+        if conn.schema and not self.schema:
+            self.set_schema(conn.schema)
+        return self
+
+    def using_context(self) -> "FQN":
+        """Update the instance with database and schema from connection in current cli context."""
+        return self.using_connection(cli_context.connection)

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/plugins/command/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from dataclasses import dataclass
 from enum import Enum
 from functools import cached_property

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/plugins/plugin_config.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from dataclasses import dataclass
 from typing import Any, Dict, List
 

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/project/definition.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from pathlib import Path
 from typing import List
 

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/project/errors.py

@@ -6,14 +6,14 @@ from pydantic import ValidationError
 class SchemaValidationError(Exception):
     generic_message = "For field {loc} you provided '{loc}'. This caused: {msg}"
     message_templates = {
-        "string_type": "{msg} for field '{loc}', you provided '{input}'",
-        "extra_forbidden": "{msg}. You provided field '{loc}' with value '{input}' that is not present in the schema",
+        "string_type": "{msg} for field '{loc}', you provided '{input}'.",
+        "extra_forbidden": "{msg}. You provided field '{loc}' with value '{input}' that is not supported in given version.",
         "missing": "Your project definition is missing following fields: {loc}",
     }
 
     def __init__(self, error: ValidationError):
         errors = error.errors()
-        message = f"During evaluation of {error.title} schema following errors were encountered:\n"
+        message = f"During evaluation of {error.title} in project definition following errors were encountered:\n"
         message += "\n".join(
             [
                 self.message_templates.get(e["type"], self.generic_message).format(**e)

snowflake_cli_labs-2.4.0rc0/src/snowflake/cli/api/project/schemas/identifier_model.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from typing import Optional, cast
+
+from pydantic import Field
+from snowflake.cli.api.project.schemas.updatable_model import IdentifierField
+
+
+class ObjectIdentifierBaseModel:
+    """
+    Type representing a base class defining object that can be identified by fully qualified name (db.schema.name).
+    This is not a Pydantic model and the purpose of this class is to provide typing support to Pydantic models
+    generated using a factory class ObjectIdentifierModel.
+    """
+
+    name: str
+    database: Optional[str]
+    schema_name: Optional[str]
+
+
+def ObjectIdentifierModel(object_name: str) -> ObjectIdentifierBaseModel:  # noqa: N802
+    """Generates ObjectIdentifierBaseModel but with object specific descriptions."""
+
+    class _ObjectIdentifierModel(ObjectIdentifierBaseModel):
+        name: str = Field(title=f"{object_name} name")
+        database: Optional[str] = IdentifierField(
+            title=f"Name of the database for the {object_name}", default=None
+        )
+        schema_name: Optional[str] = IdentifierField(
+            title=f"Name of the schema for the {object_name}",
+            default=None,
+            alias="schema",
+        )
+
+    return cast(ObjectIdentifierBaseModel, _ObjectIdentifierModel)

{snowflake_cli_labs-2.3.1 → snowflake_cli_labs-2.4.0rc0}/src/snowflake/cli/api/project/schemas/native_app/native_app.py

@@ -24,6 +24,10 @@ class NativeApp(UpdatableModel):
         title="Folder at the root of your project where the build step copies the artifacts.",
         default="output/deploy/",
     )
+    generated_root: Optional[str] = Field(
+        title="Subdirectory of the deploy root where files generated by the Snowflake CLI will be written.",
+        default="__generated/",
+    )
     source_stage: Optional[str] = Field(
         title="Identifier of the stage that stores the application artifacts.",
         default="app_src.stage",

snowflake_cli_labs-2.4.0rc0/src/snowflake/cli/api/project/schemas/native_app/path_mapping.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Union
+
+from pydantic import Field, field_validator
+from snowflake.cli.api.project.schemas.updatable_model import UpdatableModel
+
+
+class ProcessorMapping(UpdatableModel):
+    name: str = Field(
+        title="Name of a processor to invoke on a collection of artifacts."
+    )
+    properties: Optional[Dict[str, Any]] = Field(
+        title="A set of key-value pairs used to configure the output of the processor. Consult a specific processor's documentation for more details on the supported properties.",
+        default=None,
+    )
+
+
+class PathMapping(UpdatableModel):
+    src: str
+    dest: Optional[str] = None
+    processors: Optional[List[Union[str, ProcessorMapping]]] = []
+
+    @field_validator("processors")
+    @classmethod
+    def transform_processors(
+        cls, input_values: Optional[List[Union[str, Dict, ProcessorMapping]]]
+    ):
+        if input_values is None:
+            return []
+
+        transformed_processors: List[ProcessorMapping] = []
+        for input_processor in input_values:
+            if isinstance(input_processor, str):
+                transformed_processors.append(ProcessorMapping(name=input_processor))
+            elif isinstance(input_processor, Dict):
+                transformed_processors.append(ProcessorMapping(**input_processor))
+            else:
+                transformed_processors.append(input_processor)
+        return transformed_processors