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

snowflake/cli/_plugins/nativeapp/sf_facade_exceptions.py

@@ -11,12 +11,83 @@
 # 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
+
 from typing import NoReturn
 
 from click import ClickException
 from snowflake.cli._plugins.nativeapp.sf_facade_constants import UseObjectType
+from snowflake.cli.api.errno import (
+    APPLICATION_FILE_NOT_FOUND_ON_STAGE,
+    APPLICATION_INSTANCE_EMPTY_SETUP_SCRIPT,
+    APPLICATION_INSTANCE_FAILED_TO_RUN_SETUP_SCRIPT,
+    APPLICATION_INSTANCE_NO_ACTIVE_WAREHOUSE_FOR_CREATE_OR_UPGRADE,
+    APPLICATION_NO_LONGER_AVAILABLE,
+    APPLICATION_PACKAGE_CANNOT_SET_EXTERNAL_DISTRIBUTION_WITH_SPCS,
+    APPLICATION_PACKAGE_MANIFEST_CONTAINER_IMAGE_URL_BAD_VALUE,
+    APPLICATION_PACKAGE_MANIFEST_SPECIFIED_FILE_NOT_FOUND,
+    APPLICATION_PACKAGE_PATCH_DOES_NOT_EXIST,
+    CANNOT_GRANT_NON_MANIFEST_PRIVILEGE,
+    CANNOT_GRANT_OBJECT_NOT_IN_APP_PACKAGE,
+    CANNOT_GRANT_RESTRICTED_PRIVILEGE_TO_APP_PACKAGE_SHARE,
+    CANNOT_UPGRADE_FROM_LOOSE_FILES_TO_VERSION,
+    CANNOT_UPGRADE_FROM_VERSION_TO_LOOSE_FILES,
+    NATIVE_APPLICATION_MANIFEST_GENERIC_JSON_ERROR,
+    NATIVE_APPLICATION_MANIFEST_INVALID_SYNTAX,
+    NATIVE_APPLICATION_MANIFEST_UNEXPECTED_VALUE_FOR_PROPERTY,
+    NATIVE_APPLICATION_MANIFEST_UNRECOGNIZED_FIELD,
+    NO_REFERENCE_SET_FOR_DEFINITION,
+    NO_VERSIONS_AVAILABLE_FOR_ACCOUNT,
+    NOT_SUPPORTED_ON_DEV_MODE_APPLICATIONS,
+    ONLY_SUPPORTED_ON_DEV_MODE_APPLICATIONS,
+    ROLE_NOT_ASSIGNED,
+    SNOWSERVICES_IMAGE_MANIFEST_NOT_FOUND,
+    SNOWSERVICES_IMAGE_REPOSITORY_FAILS_TO_RETRIEVE_IMAGE_HASH_NEW,
+    SNOWSERVICES_IMAGE_REPOSITORY_IMAGE_IMPORT_TO_NATIVE_APP_FAIL,
+    VIEW_EXPANSION_FAILED,
+)
 from snowflake.connector import DatabaseError, Error, ProgrammingError
 
+# Reasons why an `alter application ... upgrade` might fail
+UPGRADE_RESTRICTION_CODES = {
+    CANNOT_UPGRADE_FROM_LOOSE_FILES_TO_VERSION,
+    CANNOT_UPGRADE_FROM_VERSION_TO_LOOSE_FILES,
+    ONLY_SUPPORTED_ON_DEV_MODE_APPLICATIONS,
+    NOT_SUPPORTED_ON_DEV_MODE_APPLICATIONS,
+    APPLICATION_NO_LONGER_AVAILABLE,
+}
+
+CREATE_OR_UPGRADE_APPLICATION_EXPECTED_USER_ERROR_CODES = {
+    APPLICATION_INSTANCE_FAILED_TO_RUN_SETUP_SCRIPT,
+    NATIVE_APPLICATION_MANIFEST_GENERIC_JSON_ERROR,
+    APPLICATION_INSTANCE_NO_ACTIVE_WAREHOUSE_FOR_CREATE_OR_UPGRADE,
+    # when setup script/manifest/readme isn't on the stage
+    APPLICATION_FILE_NOT_FOUND_ON_STAGE,
+    NATIVE_APPLICATION_MANIFEST_UNRECOGNIZED_FIELD,
+    SNOWSERVICES_IMAGE_MANIFEST_NOT_FOUND,
+    # user tried to clone tables and it failed
+    VIEW_EXPANSION_FAILED,
+    # user tried to do something with a role that wasn't assigned to them
+    ROLE_NOT_ASSIGNED,
+    APPLICATION_PACKAGE_MANIFEST_SPECIFIED_FILE_NOT_FOUND,
+    SNOWSERVICES_IMAGE_REPOSITORY_IMAGE_IMPORT_TO_NATIVE_APP_FAIL,
+    APPLICATION_PACKAGE_PATCH_DOES_NOT_EXIST,
+    APPLICATION_PACKAGE_MANIFEST_CONTAINER_IMAGE_URL_BAD_VALUE,
+    SNOWSERVICES_IMAGE_REPOSITORY_FAILS_TO_RETRIEVE_IMAGE_HASH_NEW,
+    NATIVE_APPLICATION_MANIFEST_UNEXPECTED_VALUE_FOR_PROPERTY,
+    CANNOT_GRANT_NON_MANIFEST_PRIVILEGE,
+    NO_REFERENCE_SET_FOR_DEFINITION,
+    NATIVE_APPLICATION_MANIFEST_INVALID_SYNTAX,
+    CANNOT_GRANT_OBJECT_NOT_IN_APP_PACKAGE,
+    APPLICATION_PACKAGE_MANIFEST_SPECIFIED_FILE_NOT_FOUND,
+    # user tried installing from release directive and there are none available
+    NO_VERSIONS_AVAILABLE_FOR_ACCOUNT,
+    APPLICATION_PACKAGE_MANIFEST_CONTAINER_IMAGE_URL_BAD_VALUE,
+    APPLICATION_INSTANCE_EMPTY_SETUP_SCRIPT,
+    APPLICATION_PACKAGE_CANNOT_SET_EXTERNAL_DISTRIBUTION_WITH_SPCS,
+    CANNOT_GRANT_RESTRICTED_PRIVILEGE_TO_APP_PACKAGE_SHARE,
+}
+
 
 def handle_unclassified_error(err: Error | Exception, context: str) -> NoReturn:
     """
@@ -115,3 +186,12 @@ class InsufficientPrivilegesError(ClickException):
         if role:
             message += f" using role: {role}"
         super().__init__(message)
+
+
+class UpgradeApplicationRestrictionError(UserInputError):
+    """
+    Raised when an alter application ... upgrade fails due to user error.
+    Must be caught and handled by the caller of an upgrade_application
+    """
+
+    pass