snowflake-cli 3.2.2__py3-none-any.whl → 3.3.0__py3-none-any.whl

snowflake/cli/_plugins/nativeapp/commands.py

@@ -22,6 +22,7 @@ from textwrap import dedent
 from typing import Generator, Iterable, List, Optional, cast
 
 import typer
+from snowflake.cli._plugins.nativeapp.artifacts import VersionInfo
 from snowflake.cli._plugins.nativeapp.common_flags import (
     ForceOption,
     InteractiveOption,
@@ -31,6 +32,13 @@ from snowflake.cli._plugins.nativeapp.entities.application import ApplicationEnt
 from snowflake.cli._plugins.nativeapp.entities.application_package import (
     ApplicationPackageEntityModel,
 )
+from snowflake.cli._plugins.nativeapp.release_channel.commands import (
+    app as release_channels_app,
+)
+from snowflake.cli._plugins.nativeapp.release_directive.commands import (
+    app as release_directives_app,
+)
+from snowflake.cli._plugins.nativeapp.sf_facade import get_snowflake_facade
 from snowflake.cli._plugins.nativeapp.v2_conversions.compat import (
     find_entity,
     force_project_definition_v2,
@@ -66,6 +74,8 @@ app = SnowTyperFactory(
     help="Manages a Snowflake Native App",
 )
 app.add_typer(versions_app)
+app.add_typer(release_directives_app)
+app.add_typer(release_channels_app)
 
 log = logging.getLogger(__name__)
 
@@ -146,6 +156,12 @@ def app_run(
         The command fails if no release directive exists for your Snowflake account for a given application package, which is determined from the project definition file. Default: unset.""",
         is_flag=True,
     ),
+    channel: str = typer.Option(
+        None,
+        show_default=False,
+        help=f"""The name of the release channel to use when creating or upgrading an application instance from a release directive.
+        Requires the `--from-release-directive` flag to be set. If unset, the default channel will be used.""",
+    ),
     interactive: bool = InteractiveOption,
     force: Optional[bool] = ForceOption,
     validate: bool = ValidateOption,
@@ -174,6 +190,7 @@ def app_run(
         paths=[],
         interactive=interactive,
         force=force,
+        release_channel=channel,
     )
     app = ws.get_entity(app_id)
     return MessageResult(
@@ -198,7 +215,7 @@ def app_open(
     )
     app_id = options["app_entity_id"]
     app = ws.get_entity(app_id)
-    if app.get_existing_app_info():
+    if get_snowflake_facade().get_existing_app_info(app.name, app.role):
         typer.launch(app.get_snowsight_url())
         return MessageResult(f"Snowflake Native App opened in browser.")
     else:
@@ -357,7 +374,10 @@ def app_validate(
     if cli_context.output_format == OutputFormat.JSON:
         return ObjectResult(
             package.get_validation_result(
-                use_scratch_stage=True, interactive=False, force=True
+                action_ctx=ws.action_ctx,
+                use_scratch_stage=True,
+                interactive=False,
+                force=True,
             )
         )
 
@@ -513,3 +533,73 @@ class EventResult(ObjectResult, MessageResult):
     @property
     def result(self):
         return self._element
+
+
+@app.command("publish", requires_connection=True)
+@with_project_definition()
+@force_project_definition_v2()
+def app_publish(
+    version: Optional[str] = typer.Option(
+        default=None,
+        show_default=False,
+        help="The version to publish to the provided release channel and release directive. Version is required to exist unless `--create-version` flag is used.",
+    ),
+    patch: Optional[int] = typer.Option(
+        default=None,
+        show_default=False,
+        help="The patch number under the given version. This will be used when setting the release directive. Patch is required to exist unless `--create-version` flag is used.",
+    ),
+    channel: Optional[str] = typer.Option(
+        "DEFAULT",
+        help="The name of the release channel to publish to. If not provided, the default release channel is used.",
+    ),
+    directive: Optional[str] = typer.Option(
+        "DEFAULT",
+        help="The name of the release directive to update with the specified version and patch. If not provided, the default release directive is used.",
+    ),
+    interactive: bool = InteractiveOption,
+    force: Optional[bool] = ForceOption,
+    create_version: bool = typer.Option(
+        False,
+        "--create-version",
+        help="Create a new version or patch based on the provided `--version` and `--patch` values. Fallback to the manifest values if not provided.",
+        is_flag=True,
+    ),
+    from_stage: bool = typer.Option(
+        False,
+        "--from-stage",
+        help="When enabled, the Snowflake CLI creates a version from the current application package stage without syncing to the stage first. Can only be used with `--create-version` flag.",
+        is_flag=True,
+    ),
+    label: Optional[str] = typer.Option(
+        None,
+        "--label",
+        help="A label for the version that is displayed to consumers. Can only be used with `--create-version` flag.",
+    ),
+    **options,
+) -> CommandResult:
+    """
+    Adds the version to the release channel and updates the release directive with the new version and patch.
+    """
+    cli_context = get_cli_context()
+    ws = WorkspaceManager(
+        project_definition=cli_context.project_definition,
+        project_root=cli_context.project_root,
+    )
+    package_id = options["package_entity_id"]
+    version_info: VersionInfo = ws.perform_action(
+        package_id,
+        EntityActions.PUBLISH,
+        version=version,
+        patch=patch,
+        release_channel=channel,
+        release_directive=directive,
+        interactive=interactive,
+        force=force,
+        create_version=create_version,
+        from_stage=from_stage,
+        label=label,
+    )
+    return MessageResult(
+        f"Version {version_info.version_name} and patch {version_info.patch_number} published to release directive {directive} of release channel {channel}."
+    )

snowflake/cli/_plugins/nativeapp/constants.py

@@ -22,7 +22,12 @@ COMMENT_COL = "comment"
 OWNER_COL = "owner"
 VERSION_COL = "version"
 PATCH_COL = "patch"
+CHANNEL_COL = "release_channel_name"
 AUTHORIZE_TELEMETRY_COL = "authorize_telemetry_event_sharing"
 
 INTERNAL_DISTRIBUTION = "internal"
 EXTERNAL_DISTRIBUTION = "external"
+
+DEFAULT_CHANNEL = "DEFAULT"
+DEFAULT_DIRECTIVE = "DEFAULT"
+MAX_VERSIONS_IN_RELEASE_CHANNEL = 2