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

[binarycat0]

• change package name from polaris 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

Fixes: #2699

What changes were proposed in this pull request?

Package name

As discussed in the mailing list thread, the majority agreed that a more suitable and compliant name would be apache-polaris according to the Apache Distribution guide

pip install apache-polaris
polaris --help

Catalogs structure

It would be beneficial to modify the directory structure. The current setup can lead to conflicts after package installation because it doesn't create a parent directory to group all apache-polaris related modules together. Instead, it directly places the cli and polaris directories into the root .../site-packages of the active environment.

/site_packages/
├── cli
├── polaris
│   ├── catalog
└── └── management

In the structure I am proposing, all modules related to the project will be placed in the apache_polaris module and will be available for use in code through import apache_polaris.sdk.catalog, apache_polaris.sdk.management and import apache_polaris.cli respectively.

/site-packages/
├── apache_polaris
│   ├── cli
│   └── sdk
│       ├── catalog
│       └── management

>>> from apache_polaris.sdk import catalog
>>> from apache_polaris.sdk import management

Why are the changes needed?

Initial Issue: #2419
Follow up Issue: #2699

Does this PR introduce any user-facing change?

How was this patch tested?

make client-cleanup
make client-regenerate
make client-lint
make client-integration-test
make client-unit-test

CHANGELOG.md

[binarycat0]

@MonkeyCanCode @HonahX Hello colleagues. Please review. Thx 🙏

[MonkeyCanCode]

Hello, sorry for the delay. I will check this weekend.

@MonkeyCanCode @HonahX Hello colleagues. Please review. Thx 🙏

[MonkeyCanCode]

polaris/catalog/models/__init__.py is now outdated with this PR. Change to apache_polaris/sdk/catalog/models/__init__.py

[MonkeyCanCode]

@binarycat0 mind update here as well?

[binarycat0]

Sure, good catch! I need to double-check all places properly 👍

[MonkeyCanCode]

Path polaris/catalog/models/__init__.py is outdated. Change to apache_polaris/sdk/catalog/models/__init__.py

[MonkeyCanCode]

Hello, sorry for the delay. I will check this weekend.

@MonkeyCanCode @HonahX Hello colleagues. Please review. Thx 🙏

@binarycat0 nice work and thanks for the coordination on the dev ML.

[binarycat0]

Hello @MonkeyCanCode 👋, thank you for the review. I fixed the mentioned NIT comments, thanks.

Also, the mentioned string splitters by () is caused by automatically formatting or by make client-lint command. If the make client-lint command does not contain the black formatting, I would propose implement it there.

In my experience an applying "isort + mypy + black" linting was by default, I would like suggest following the same standard as many python projects.

Hello, sorry for the delay. I will check this weekend.

@MonkeyCanCode @HonahX Hello colleagues. Please review. Thx 🙏

@binarycat0 nice work and thanks for the coordination on the dev ML.

[MonkeyCanCode]

Hello @MonkeyCanCode 👋, thank you for the review. I fixed the mentioned NIT comments, thanks.

Also, the mentioned string splitters by () is caused by automatically formatting or by make client-lint command. If the make client-lint command does not contain the black formatting, I would propose implement it there.

In my experience an applying "isort + mypy + black" linting was by default, I would like suggest following the same standard as many python projects.

Hello, sorry for the delay. I will check this weekend.

@MonkeyCanCode @HonahX Hello colleagues. Please review. Thx 🙏

@binarycat0 nice work and thanks for the coordination on the dev ML.

Thanks for the quick fix. One of the minor comment was not fixed. Other than that, this looks good to me. @eric-maynard @HonahX , do u mind also take a look when u have a chance?

[binarycat0]

@MonkeyCanCode Thank you again. I double-checked all places, now it should be good.