snowflake-cli-labs 2.5.0rc2__tar.gz → 2.6.0.dev0__tar.gz

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/.pre-commit-config.yaml

@@ -15,7 +15,7 @@ repos:
     rev: "v0.1.7"
     hooks:
       - id: ruff
-        args: [--fix, --exclude, "**/tests_integration/"]
+        args: [--fix, --exclude, "**/tests_common/,**/tests_integration/"]
   - repo: https://github.com/psf/black
     rev: 22.12.0
     hooks:

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: snowflake-cli-labs
-Version: 2.5.0rc2
+Version: 2.6.0.dev0
 Summary: Snowflake CLI
 Project-URL: Source code, https://github.com/snowflakedb/snowflake-cli
 Project-URL: Bug Tracker, https://github.com/snowflakedb/snowflake-cli/issues
@@ -207,7 +207,7 @@ License:                                  Apache License
            See the License for the specific language governing permissions and
            limitations under the License.
 License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
@@ -222,19 +222,19 @@ Requires-Dist: jinja2==3.1.4
 Requires-Dist: packaging
 Requires-Dist: pip
 Requires-Dist: pluggy==1.5.0
-Requires-Dist: pydantic==2.7.3
+Requires-Dist: pydantic==2.8.0
 Requires-Dist: pyyaml==6.0.1
 Requires-Dist: requests==2.32.3
 Requires-Dist: requirements-parser==0.9.0
 Requires-Dist: rich==13.7.1
-Requires-Dist: setuptools==70.0.0
-Requires-Dist: snowflake-connector-python[secure-local-storage]==3.10.1
+Requires-Dist: setuptools==70.1.1
+Requires-Dist: snowflake-connector-python[secure-local-storage]==3.11.0
 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
+Requires-Dist: urllib3<2.3,>=1.24.3
 Provides-Extra: development
-Requires-Dist: coverage==7.5.3; extra == 'development'
+Requires-Dist: coverage==7.5.4; extra == 'development'
 Requires-Dist: pre-commit>=3.5.0; extra == 'development'
 Requires-Dist: pytest-randomly==3.15.0; extra == 'development'
 Requires-Dist: pytest==8.2.2; extra == 'development'
@@ -270,7 +270,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 at https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index
+**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
+
+Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md
 
 
 ## Install Snowflake CLI
@@ -289,7 +295,7 @@ snow --help
 Requires [Homebrew](https://brew.sh/).
 
 ```bash
-brew tap Snowflake-Labs/snowflake-cli
+brew tap snowflakedb/snowflake-cli
 brew install snowflake-cli
 snow --help
 ```

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/README.md

@@ -27,7 +27,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 at https://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index
+**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
+
+Cheatsheet: https://github.com/Snowflake-Labs/sf-cheatsheets/blob/main/snowflake-cli.md
 
 
 ## Install Snowflake CLI
@@ -46,7 +52,7 @@ snow --help
 Requires [Homebrew](https://brew.sh/).
 
 ```bash
-brew tap Snowflake-Labs/snowflake-cli
+brew tap snowflakedb/snowflake-cli
 brew install snowflake-cli
 snow --help
 ```

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/RELEASE-NOTES.md

@@ -24,6 +24,42 @@
 ## Fixes and improvements
 
 
+# v2.6.0
+## Backward incompatibility
+
+## Deprecations
+
+## New additions
+* Add `snow object create` command
+* Added support for `title` field in Streamlit definition in `snowflake.yml` project file.
+* Added `--auto-compress` flag to `snow stage copy` command enabling use of gzip to compress files during upload.
+* Added new `native_app.application.post_deploy` section to `snowflake.yml` schema to execute actions after the application has been deployed via `snow app run`.
+  * Added the `sql_script` hook type to run SQL scripts with template support.
+* Added support for `--env` command line arguments for templating.
+  * Available for commands that make use of the project definition file.
+  * Format of the argument: `--env key1=value1 --env key2=value2`.
+  * 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.
+
+## Fixes and improvements
+* Passing a directory to `snow app deploy` will now deploy any contained file or subfolder specified in the application's artifact rules
+* Fixes markup escaping errors in `snow sql` that may occur when users use unintentionally markup-like escape tags.
+* Fixed case where `snow app teardown` could not tear down orphan applications (those that have had their package dropped)
+* Fixed case where `snow app teardown` could leave behind orphan applications if they were not created by the Snowflake CLI
+* Fixed case where `snow app run` could fail to run an existing application whose package was dropped by prompting to drop and recreate the application
+* Improve terminal output sanitization to avoid ASCII escape codes.
+* The `snow sql` command will show query text before executing it.
+* Improved stage diff output in `snow app` commands
+* Hid the diff from `snow app validate` output since it was redundant
+* Added log into the file with loaded external plugins
+* Warn users if they attempt to use templating with project definition version 1
+* Improved output and format of Pydantic validation errors
+* The `snow app run` command will no longer override debug mode during an application upgrade unless explicitly set in `snowflake.yml`
+
 # v2.5.0
 ## Backward incompatibility
 

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/pyproject.toml

@@ -32,18 +32,18 @@ dependencies = [
   "rich==13.7.1",
   "requests==2.32.3",
   "requirements-parser==0.9.0",
-  "setuptools==70.0.0",
+  "setuptools==70.1.1",
   'snowflake.core==0.8.0; python_version < "3.12"',
-  "snowflake-connector-python[secure-local-storage]==3.10.1",
+  "snowflake-connector-python[secure-local-storage]==3.11.0",
   "tomlkit==0.12.5",
   "typer==0.12.3",
-  "urllib3>=1.21.1,<2.3",
+  "urllib3>=1.24.3,<2.3",
   "GitPython==3.1.43",
   "pip",
-  "pydantic==2.7.3",
+  "pydantic==2.8.0",
 ]
 classifiers = [
-  "Development Status :: 3 - Alpha",
+  "Development Status :: 5 - Production/Stable",
   "Environment :: Console",
   "Intended Audience :: Developers",
   "Intended Audience :: Information Technology",
@@ -56,7 +56,7 @@ classifiers = [
 
 [project.optional-dependencies]
 development = [
-  "coverage==7.5.3",
+  "coverage==7.5.4",
   "pre-commit>=3.5.0",
   "pytest==8.2.2",
   "pytest-randomly==3.15.0",
@@ -86,10 +86,10 @@ packages = ["src/snowflake"]
 features = ["development"]
 
 [tool.hatch.envs.default.scripts]
-test = ["pytest --snapshot-warn-unused tests/"]
+test = ["pytest tests/"]
 test-cov = [
-  "coverage run --source=snowflake.cli --module pytest --snapshot-warn-unused tests/ ",
-  "coverage run --source=snowflake.cli --module pytest -m loaded_modules --snapshot-warn-unused tests/ ",
+  "coverage run --source=snowflake.cli --module pytest tests/ ",
+  "coverage run --source=snowflake.cli --module pytest -m loaded_modules tests/ ",
   "coverage report",
 ]
 
@@ -98,7 +98,8 @@ template = "e2e"
 features = ["development"]
 
 [tool.hatch.envs.e2e.scripts]
-test = ["pytest -m e2e --snapshot-warn-unused --durations=0"]
+test = ["pytest -m e2e --durations=0"]
+cleanup = ["python scripts/cleanup.py"]
 
 [tool.hatch.envs.performance]
 template = "performance"
@@ -117,10 +118,7 @@ pre-install-commands = [
 features = ["development"]
 
 [tool.hatch.envs.integration.scripts]
-test = ["pytest -m integration -n4 --dist=loadfile --snapshot-warn-unused"]
-test-experimental = [
-  "pytest -m integration_experimental --snapshot-warn-unused",
-]
+test = ["pytest -m integration -n4 --dist=loadfile"]
 
 [[tool.hatch.envs.local.matrix]]
 python = ["3.8", "3.9", "3.10", "3.11", "3.12"]
@@ -147,7 +145,7 @@ select = [
 ]
 
 [tool.pytest.ini_options]
-addopts = "-m 'not integration and not performance and not e2e and not spcs and not loaded_modules and not integration_experimental'"
+addopts = "-vv --maxfail=10 -m 'not integration and not performance and not e2e and not spcs and not loaded_modules and not integration_experimental'"
 markers = [
   "integration: mark test as integration test",
   "performance: mark test as performance test",

snowflake_cli_labs-2.6.0.dev0/scripts/cleanup.py

@@ -0,0 +1,78 @@
+# 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 os
+import typing as t
+from datetime import datetime, timedelta
+
+from snowflake.snowpark.session import Session
+
+
+def is_stale(item):
+    return datetime.utcnow() - item.created_on.replace(tzinfo=None) >= timedelta(
+        hours=2
+    )
+
+
+def remove_resource(resource_type: str, item, role: str):
+    msg = f"Deleting {resource_type} {item.name}"
+    try:
+        if is_stale(item):
+            session.sql(
+                f"GRANT OWNERSHIP ON {resource_type} {item.name} TO ROLE {role}"
+            )
+            session.sql(f"drop {resource_type} {item.name}").collect()
+            print("SUCCESS", msg, f"created at {item.created_on}")
+    except Exception as err:
+        print("ERROR", msg)
+        print(str(err)[:200])
+
+
+def remove_resources(single: str, plural: str, known_instances: t.List[str], role: str):
+    items = session.sql(f"show {plural}").collect()
+
+    for item in items:
+        if item.name not in known_instances:
+            remove_resource(resource_type=single, item=item, role=role)
+
+
+if __name__ == "__main__":
+    role = "INTEGRATION_TESTS"
+    session = Session.builder.configs(
+        {
+            "account": os.getenv("SNOWFLAKE_CONNECTIONS_INTEGRATION_ACCOUNT"),
+            "user": os.getenv("SNOWFLAKE_CONNECTIONS_INTEGRATION_USER"),
+            "password": os.getenv("SNOWFLAKE_CONNECTIONS_INTEGRATION_PASSWORD"),
+            "database": "SNOWCLI_DB",
+            "role": role,
+        }
+    ).create()
+
+    session.use_role("INTEGRATION_TESTS")
+
+    known_objects: t.Dict[t.Tuple[str, str], t.List[str]] = {
+        ("database", "databases"): [
+            "cleanup_db",
+            "docs_testing",
+            "external_access_db",
+            "snowcli_db",
+        ],
+        ("compute pool", "compute pools"): [],
+        ("service", "services"): [],
+        ("application", "applications"): [],
+    }
+
+    for (single, plural), known in known_objects.items():
+        remove_resources(single, plural, known, role=role)

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/snyk/requirements.txt

@@ -5,16 +5,16 @@ packaging
 rich==13.7.1
 requests==2.32.3
 requirements-parser==0.9.0
-setuptools==70.0.0
+setuptools==70.1.1
 snowflake.core==0.8.0; python_version < "3.12"
-snowflake-connector-python[secure-local-storage]==3.10.1
+snowflake-connector-python[secure-local-storage]==3.11.0
 tomlkit==0.12.5
 typer==0.12.3
-urllib3>=1.21.1,<2.3
+urllib3>=1.24.3,<2.3
 GitPython==3.1.43
 pip
-pydantic==2.7.3
-coverage==7.5.3
+pydantic==2.8.0
+coverage==7.5.4
 pre-commit>=3.5.0
 pytest==8.2.2
 pytest-randomly==3.15.0

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/src/snowflake/cli/__about__.py

@@ -14,4 +14,4 @@
 
 from __future__ import annotations
 
-VERSION = "2.5.0rc2"
+VERSION = "2.6.0.dev0"

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/src/snowflake/cli/api/cli_global_context.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 import re
 from pathlib import Path
-from typing import Dict, Optional
+from typing import Callable, Optional
 
 from snowflake.cli.api.exceptions import InvalidSchemaError
 from snowflake.cli.api.output.formats import OutputFormat
@@ -226,6 +226,9 @@ class _CliGlobalContextManager:
         self._experimental = False
         self._project_definition = None
         self._project_root = None
+        self._project_path_arg = None
+        self._project_env_overrides_args = {}
+        self._typer_pre_execute_commands = []
         self._template_context = None
         self._silent: bool = False
 
@@ -261,10 +264,10 @@ class _CliGlobalContextManager:
         self._experimental = value
 
     @property
-    def project_definition(self) -> Optional[Dict]:
+    def project_definition(self) -> Optional[ProjectDefinition]:
         return self._project_definition
 
-    def set_project_definition(self, value: Dict):
+    def set_project_definition(self, value: ProjectDefinition):
         self._project_definition = value
 
     @property
@@ -274,6 +277,22 @@ class _CliGlobalContextManager:
     def set_project_root(self, project_root: Path):
         self._project_root = project_root
 
+    @property
+    def project_path_arg(self) -> Optional[str]:
+        return self._project_path_arg
+
+    def set_project_path_arg(self, project_path_arg: str):
+        self._project_path_arg = project_path_arg
+
+    @property
+    def project_env_overrides_args(self) -> dict[str, str]:
+        return self._project_env_overrides_args
+
+    def set_project_env_overrides_args(
+        self, project_env_overrides_args: dict[str, str]
+    ):
+        self._project_env_overrides_args = project_env_overrides_args
+
     @property
     def template_context(self) -> dict:
         return self._template_context
@@ -281,6 +300,15 @@ class _CliGlobalContextManager:
     def set_template_context(self, template_context: dict):
         self._template_context = template_context
 
+    @property
+    def typer_pre_execute_commands(self) -> list[Callable[[], None]]:
+        return self._typer_pre_execute_commands
+
+    def add_typer_pre_execute_commands(
+        self, typer_pre_execute_command: Callable[[], None]
+    ):
+        self._typer_pre_execute_commands.append(typer_pre_execute_command)
+
     @property
     def connection_context(self) -> _ConnectionContext:
         return self._connection_context

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/src/snowflake/cli/api/commands/decorators.py

@@ -43,7 +43,8 @@ from snowflake.cli.api.commands.flags import (
     VerboseOption,
     WarehouseOption,
     experimental_option,
-    project_type_option,
+    project_definition_option,
+    project_env_overrides_option,
 )
 from snowflake.cli.api.exceptions import CommandReturnTypeError
 from snowflake.cli.api.output.formats import OutputFormat
@@ -72,8 +73,11 @@ def global_options_with_connection(func: Callable):
     )
 
 
-def with_project_definition(project_name: str):
+def with_project_definition(
+    project_name: Optional[str] = None, is_optional: bool = False
+):
     def _decorator(func: Callable):
+
         return _options_decorator_factory(
             func,
             additional_options=[
@@ -81,8 +85,14 @@ def with_project_definition(project_name: str):
                     "project_definition",
                     inspect.Parameter.KEYWORD_ONLY,
                     annotation=Optional[str],
-                    default=project_type_option(project_name),
-                )
+                    default=project_definition_option(project_name, is_optional),
+                ),
+                inspect.Parameter(
+                    "env_overrides",
+                    inspect.Parameter.KEYWORD_ONLY,
+                    annotation=List[str],
+                    default=project_env_overrides_option(),
+                ),
             ],
         )
 
@@ -115,7 +125,7 @@ def with_experimental_behaviour(
     return decorator
 
 
-def _execute_before_command_using_global_options():
+def _execute_before_command_using_global_options(**options):
     from snowflake.cli.app.loggers import create_loggers
 
     create_loggers(cli_context.verbose, cli_context.enable_tracebacks)
@@ -136,10 +146,15 @@ def _options_decorator_factory(
     additional_options: List[inspect.Parameter],
     execute_before_command_using_new_options: Optional[Callable] = None,
 ):
+    """
+    execute_before_command_using_new_options executes before command telemetry has been emitted,
+    but after command line options have been populated.
+    """
+
     @wraps(func)
     def wrapper(**options):
         if execute_before_command_using_new_options:
-            execute_before_command_using_new_options()
+            execute_before_command_using_new_options(**options)
         return func(**options)
 
     wrapper.__signature__ = _extend_signature_with_additional_options(func, additional_options)  # type: ignore

{snowflake_cli_labs-2.5.0rc2 → snowflake_cli_labs-2.6.0.dev0}/src/snowflake/cli/api/commands/flags.py

@@ -14,7 +14,6 @@
 
 from __future__ import annotations
 
-import os
 import tempfile
 from dataclasses import dataclass
 from enum import Enum
@@ -26,9 +25,11 @@ import click
 import typer
 from click import ClickException
 from snowflake.cli.api.cli_global_context import cli_context_manager
+from snowflake.cli.api.commands.typer_pre_execute import register_pre_execute_command
 from snowflake.cli.api.console import cli_console
-from snowflake.cli.api.exceptions import MissingConfiguration
+from snowflake.cli.api.exceptions import MissingConfiguration, NoProjectDefinitionError
 from snowflake.cli.api.output.formats import OutputFormat
+from snowflake.cli.api.project.definition_manager import DefinitionManager
 from snowflake.cli.api.utils.rendering import CONTEXT_KEY
 
 DEFAULT_CONTEXT_SETTINGS = {"help_option_names": ["--help", "-h"]}
@@ -499,70 +500,74 @@ def execution_identifier_argument(sf_object: str, example: str) -> typer.Argumen
     )
 
 
-def project_type_option(project_name: str):
-    from snowflake.cli.api.exceptions import NoProjectDefinitionError
-    from snowflake.cli.api.project.definition_manager import DefinitionManager
+def register_project_definition(project_name: Optional[str], is_optional: bool) -> None:
+    project_path = cli_context_manager.project_path_arg
+    env_overrides_args = cli_context_manager.project_env_overrides_args
 
-    def _callback(project_path: Optional[str]):
-        dm = DefinitionManager(project_path)
-        project_definition = getattr(dm.project_definition, project_name, None)
-        project_root = dm.project_root
+    dm = DefinitionManager(project_path, {CONTEXT_KEY: {"env": env_overrides_args}})
+    project_definition = dm.project_definition
+    project_root = dm.project_root
+    template_context = dm.template_context
 
-        if not project_definition:
-            raise NoProjectDefinitionError(
-                project_type=project_name, project_file=project_path
-            )
+    if not dm.has_definition_file and not is_optional:
+        raise MissingConfiguration(
+            "Cannot find project definition (snowflake.yml). Please provide a path to the project or run this command in a valid project directory."
+        )
+
+    if project_name is not None and not getattr(project_definition, project_name, None):
+        raise NoProjectDefinitionError(
+            project_type=project_name, project_file=project_path
+        )
+
+    cli_context_manager.set_project_definition(project_definition)
+    cli_context_manager.set_project_root(project_root)
+    cli_context_manager.set_template_context(template_context)
 
-        cli_context_manager.set_project_definition(project_definition)
-        cli_context_manager.set_project_root(project_root)
-        cli_context_manager.set_template_context(dm.template_context)
-        return project_definition
 
-    if project_name == "native_app":
-        project_name_help = "Snowflake Native App"
-    elif project_name == "streamlit":
-        project_name_help = "Streamlit app"
+def _get_project_long_name(project_short_name: Optional[str]) -> str:
+    if project_short_name is None:
+        return "Snowflake"
+
+    if project_short_name == "native_app":
+        project_long_name = "Snowflake Native App"
+    elif project_short_name == "streamlit":
+        project_long_name = "Streamlit app"
     else:
-        project_name_help = project_name.replace("_", " ").capitalize()
+        project_long_name = project_short_name.replace("_", " ").capitalize()
+
+    return f"the {project_long_name}"
+
+
+def project_definition_option(project_name: Optional[str], is_optional: bool):
+    def project_definition_callback(project_path: str) -> None:
+        cli_context_manager.set_project_path_arg(project_path)
+        register_pre_execute_command(
+            lambda: register_project_definition(project_name, is_optional)
+        )
 
     return typer.Option(
         None,
         "-p",
         "--project",
-        help=f"Path where the {project_name_help} project resides. "
+        help=f"Path where {_get_project_long_name(project_name)} project resides. "
         f"Defaults to current working directory.",
-        callback=_callback,
+        callback=_callback(lambda: project_definition_callback),
         show_default=False,
     )
 
 
-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
-            template_context = dm.template_context
-        except MissingConfiguration:
-            if optional:
-                project_definition = None
-                project_root = None
-                template_context = {CONTEXT_KEY: {"env": os.environ}}
-            else:
-                raise
-        cli_context_manager.set_project_definition(project_definition)
-        cli_context_manager.set_project_root(project_root)
-        cli_context_manager.set_template_context(template_context)
-        return project_definition
+def project_env_overrides_option():
+    def project_env_overrides_callback(env_overrides_args_list: list[str]) -> None:
+        env_overrides_args_map = {
+            v.key: v.value for v in parse_key_value_variables(env_overrides_args_list)
+        }
+        cli_context_manager.set_project_env_overrides_args(env_overrides_args_map)
 
     return typer.Option(
-        None,
-        "-p",
-        "--project",
-        help=f"Path where Snowflake project resides. Defaults to current working directory.",
-        callback=_callback,
+        [],
+        "--env",
+        help="String in format of key=value. Overrides variables from env section used for templating.",
+        callback=_callback(lambda: project_env_overrides_callback),
         show_default=False,
     )
 
@@ -610,9 +615,13 @@ class Variable:
         self.value = value
 
 
-def parse_key_value_variables(variables: List[str]) -> List[Variable]:
+def parse_key_value_variables(variables: Optional[List[str]]) -> List[Variable]:
     """Util for parsing key=value input. Useful for commands accepting multiple input options."""
-    result = []
+    result: List[Variable] = []
+
+    if variables is None:
+        return result
+
     for p in variables:
         if "=" not in p:
             raise ClickException(f"Invalid variable: '{p}'")