Hi Yufei, I personally think "apache_polaris" as a module name aligns well with "apache-polaris" as a package name. IIRC, the use of the underscore is necessary due to language syntax requirements.
TBH, I was initially confused with the vote thread [1] as I thought it was related to the CLI (shell) command name. That said, if we want to rename the module back to "polaris", I would not mind. [1] https://lists.apache.org/thread/rck38gl3g1x8m3tmtf24cvyn7tk0mn92 Cheers, Dmitri. On Tue, Nov 18, 2025 at 3:43 PM Yufei Gu <[email protected]> wrote: > Hi folks, > > I’d like to clarify the naming decisions for the Python CLI after reviewing > the recent changes. > > The PyPI package name change to apache-polaris is correct and fully aligned > with the Apache distribution guidelines. Thanks Artur for making it happen. > > PR #2812 also changed the Python module/directory name to apache_polaris, > which is not aligned with our community decision. As discussed[2] and > voted[1] on in the dev mailing list, we agreed to keep the module name as > polaris to ensure import stability and compatibility with existing > integrations. > > To summarize: > > - PyPI package name: *apache-polaris* (correct and intended), > configured in pyproject.toml > - Python module name: should remain *polaris* (per mailing list vote[1]) > - PR #2812: unintentionally renamed the module to *apache_polaris*, > which we should revert or adjust. > > Thanks everyone for the thoughtful discussion. Happy to help coordinate the > follow-up fix. > > 1. https://lists.apache.org/thread/rck38gl3g1x8m3tmtf24cvyn7tk0mn92 > 2. https://lists.apache.org/thread/1hys0h3r83nnxsbfszrjgnnkfjpdf2k7 > > Yufei >
