chore(enhancement): rename python package to apache-polaris

- reorganize python package catalogs
- union all submodules (cli, polaris) under apache_polaris module
- put polaris generated context into apache_polaris/sdk
- make apache_polaris as a main module

Author: binarycat0

.gitignore

@@ -30,7 +30,7 @@ client/python/poetry.lock
 /pyproject.toml
 client/python/.openapi-generator/
 client/python/docs/
-client/python/polaris/
+client/python/apache_polaris/sdk/
 client/python/test/
 !client/python/test/test_cli_parsing.py
 

client/python/polaris/.keep renamed to client/python/apache_polaris/.keep

@@ -0,0 +1,19 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you 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.
+#
+

client/python/apache_polaris/__init__.py

@@ -22,7 +22,7 @@
 from functools import cached_property
 from typing import Optional, Dict
 
-from cli.constants import (
+from apache_polaris.cli.constants import (
   CONFIG_FILE,
   CLIENT_PROFILE_ENV,
   CLIENT_ID_ENV,
@@ -33,8 +33,8 @@
   DEFAULT_HOSTNAME,
   DEFAULT_PORT
 )
-from cli.options.option_tree import Argument
-from polaris.management import ApiClient, Configuration
+from apache_polaris.cli.options.option_tree import Argument
+from apache_polaris.sdk.management import ApiClient, Configuration
 
 
 def _load_profiles() -> Dict[str, str]:

client/python/cli/__init__.py renamed to client/python/apache_polaris/cli/__init__.py

@@ -19,9 +19,9 @@
 import argparse
 from abc import ABC
 
-from cli.constants import Commands, Arguments
-from cli.options.parser import Parser
-from polaris.management import PolarisDefaultApi
+from apache_polaris.cli.constants import Commands, Arguments
+from apache_polaris.cli.options.parser import Parser
+from apache_polaris.sdk.management import PolarisDefaultApi
 
 
 class Command(ABC):
@@ -44,7 +44,7 @@ def options_get(key, f=lambda x: x):
 
         command = None
         if options.command == Commands.CATALOGS:
-            from cli.command.catalogs import CatalogsCommand
+            from apache_polaris.cli.command.catalogs import CatalogsCommand
 
             command = CatalogsCommand(
                 options_get(f"{Commands.CATALOGS}_subcommand"),
@@ -87,7 +87,7 @@ def options_get(key, f=lambda x: x):
                 catalog_signing_name=options_get(Arguments.CATALOG_SIGNING_NAME)
             )
         elif options.command == Commands.PRINCIPALS:
-            from cli.command.principals import PrincipalsCommand
+            from apache_polaris.cli.command.principals import PrincipalsCommand
 
             command = PrincipalsCommand(
                 options_get(f"{Commands.PRINCIPALS}_subcommand"),
@@ -104,7 +104,7 @@ def options_get(key, f=lambda x: x):
                 new_client_secret=options_get(Arguments.NEW_CLIENT_SECRET),
             )
         elif options.command == Commands.PRINCIPAL_ROLES:
-            from cli.command.principal_roles import PrincipalRolesCommand
+            from apache_polaris.cli.command.principal_roles import PrincipalRolesCommand
 
             command = PrincipalRolesCommand(
                 options_get(f"{Commands.PRINCIPAL_ROLES}_subcommand"),
@@ -119,7 +119,7 @@ def options_get(key, f=lambda x: x):
                 else remove_properties,
             )
         elif options.command == Commands.CATALOG_ROLES:
-            from cli.command.catalog_roles import CatalogRolesCommand
+            from apache_polaris.cli.command.catalog_roles import CatalogRolesCommand
 
             command = CatalogRolesCommand(
                 options_get(f"{Commands.CATALOG_ROLES}_subcommand"),
@@ -133,7 +133,7 @@ def options_get(key, f=lambda x: x):
                 else remove_properties,
             )
         elif options.command == Commands.PRIVILEGES:
-            from cli.command.privileges import PrivilegesCommand
+            from apache_polaris.cli.command.privileges import PrivilegesCommand
 
             subcommand = options_get(f"{Commands.PRIVILEGES}_subcommand")
             command = PrivilegesCommand(
@@ -150,7 +150,7 @@ def options_get(key, f=lambda x: x):
                 cascade=options_get(Arguments.CASCADE),
             )
         elif options.command == Commands.NAMESPACES:
-            from cli.command.namespaces import NamespacesCommand
+            from apache_polaris.cli.command.namespaces import NamespacesCommand
 
             subcommand = options_get(f"{Commands.NAMESPACES}_subcommand")
             command = NamespacesCommand(
@@ -164,14 +164,14 @@ def options_get(key, f=lambda x: x):
                 properties=properties,
             )
         elif options.command == Commands.PROFILES:
-            from cli.command.profiles import ProfilesCommand
+            from apache_polaris.cli.command.profiles import ProfilesCommand
 
             subcommand = options_get(f"{Commands.PROFILES}_subcommand")
             command = ProfilesCommand(
                 subcommand, profile_name=options_get(Arguments.PROFILE)
             )
         elif options.command == Commands.POLICIES:
-            from cli.command.policies import PoliciesCommand
+            from apache_polaris.cli.command.policies import PoliciesCommand
 
             subcommand = options_get(f"{Commands.POLICIES}_subcommand")
             command = PoliciesCommand(

client/python/cli/api_client_builder.py renamed to client/python/apache_polaris/cli/api_client_builder.py

@@ -21,10 +21,10 @@
 
 from pydantic import StrictStr
 
-from cli.command import Command
-from cli.constants import Subcommands, Arguments
-from cli.options.option_tree import Argument
-from polaris.management import (
+from apache_polaris.cli.command import Command
+from apache_polaris.cli.constants import Subcommands, Arguments
+from apache_polaris.cli.options.option_tree import Argument
+from apache_polaris.sdk.management import (
     PolarisDefaultApi,
     CreateCatalogRoleRequest,
     CatalogRole,

client/python/cli/command/__init__.py renamed to client/python/apache_polaris/cli/command/__init__.py

@@ -16,20 +16,27 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-from dataclasses import dataclass
-from typing import Dict, List
 
+from apache_polaris.cli.command import Command
+from apache_polaris.cli.constants import StorageType, CatalogType, \
+  CatalogConnectionType, Subcommands, Arguments, AuthenticationType, \
+  ServiceIdentityType
+from apache_polaris.cli.options.option_tree import Argument
+
+from dataclasses import dataclass
 from pydantic import StrictStr, SecretStr
+from typing import Dict, List
 
-from cli.command import Command
-from cli.constants import StorageType, CatalogType, CatalogConnectionType, Subcommands, Arguments, AuthenticationType, \
-    ServiceIdentityType
-from cli.options.option_tree import Argument
-from polaris.management import PolarisDefaultApi, CreateCatalogRequest, UpdateCatalogRequest, \
-    StorageConfigInfo, ExternalCatalog, AwsStorageConfigInfo, AzureStorageConfigInfo, GcpStorageConfigInfo, \
-    PolarisCatalog, CatalogProperties, BearerAuthenticationParameters, ImplicitAuthenticationParameters, \
-    OAuthClientCredentialsParameters, SigV4AuthenticationParameters, HadoopConnectionConfigInfo, \
-    IcebergRestConnectionConfigInfo, AwsIamServiceIdentityInfo
+from apache_polaris.sdk.management import PolarisDefaultApi, \
+  CreateCatalogRequest, \
+  UpdateCatalogRequest, \
+  StorageConfigInfo, ExternalCatalog, AwsStorageConfigInfo, \
+  AzureStorageConfigInfo, GcpStorageConfigInfo, \
+  PolarisCatalog, CatalogProperties, BearerAuthenticationParameters, \
+  ImplicitAuthenticationParameters, \
+  OAuthClientCredentialsParameters, SigV4AuthenticationParameters, \
+  HadoopConnectionConfigInfo, \
+  IcebergRestConnectionConfigInfo, AwsIamServiceIdentityInfo
 
 
 @dataclass

client/python/cli/command/catalog_roles.py renamed to client/python/apache_polaris/cli/command/catalog_roles.py

@@ -18,16 +18,15 @@
 #
 import json
 from dataclasses import dataclass
-from typing import Dict, Optional, List
-
 from pydantic import StrictStr
+from typing import Dict, Optional, List
 
-from cli.command import Command
-from cli.command.utils import get_catalog_api_client
-from cli.constants import Subcommands, Arguments, UNIT_SEPARATOR
-from cli.options.option_tree import Argument
-from polaris.catalog import IcebergCatalogAPI, CreateNamespaceRequest
-from polaris.management import PolarisDefaultApi
+from apache_polaris.cli.command import Command
+from apache_polaris.cli.command.utils import get_catalog_api_client
+from apache_polaris.cli.constants import Subcommands, Arguments, UNIT_SEPARATOR
+from apache_polaris.cli.options.option_tree import Argument
+from apache_polaris.sdk.catalog import IcebergCatalogAPI, CreateNamespaceRequest
+from apache_polaris.sdk.management import PolarisDefaultApi
 
 
 @dataclass

client/python/cli/command/catalogs.py renamed to client/python/apache_polaris/cli/command/catalogs.py

@@ -16,22 +16,29 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-import os
+
 import json
+
+import os
 from dataclasses import dataclass
 from typing import Optional, Dict
-from cli.command import Command
-from cli.command.utils import get_catalog_api_client
-from cli.constants import Subcommands, Arguments, UNIT_SEPARATOR
-from cli.options.option_tree import Argument
-from polaris.management import PolarisDefaultApi
-from polaris.catalog.api.policy_api import PolicyAPI
-from polaris.catalog.models.create_policy_request import CreatePolicyRequest
-from polaris.catalog.models.update_policy_request import UpdatePolicyRequest
-from polaris.catalog.models.policy_attachment_target import PolicyAttachmentTarget
-from polaris.catalog.models.attach_policy_request import AttachPolicyRequest
-from polaris.catalog.models.detach_policy_request import DetachPolicyRequest
 
+from apache_polaris.cli.command import Command
+from apache_polaris.cli.command.utils import get_catalog_api_client
+from apache_polaris.cli.constants import Subcommands, Arguments, UNIT_SEPARATOR
+from apache_polaris.cli.options.option_tree import Argument
+from apache_polaris.sdk.catalog.api.policy_api import PolicyAPI
+from apache_polaris.sdk.catalog.models.attach_policy_request import \
+  AttachPolicyRequest
+from apache_polaris.sdk.catalog.models.create_policy_request import \
+  CreatePolicyRequest
+from apache_polaris.sdk.catalog.models.detach_policy_request import \
+  DetachPolicyRequest
+from apache_polaris.sdk.catalog.models.policy_attachment_target import \
+  PolicyAttachmentTarget
+from apache_polaris.sdk.catalog.models.update_policy_request import \
+  UpdatePolicyRequest
+from apache_polaris.sdk.management import PolarisDefaultApi
 
 
 @dataclass