CLI: Add REPL support to CLI

[MonkeyCanCode]

This is second time where we got asked to support REPL (https://lists.apache.org/thread/mgfo0vyxjqb47bkp09d2gw8162f3n2kw). This PR adds the REPL support for Polaris CLI.

Sample outputs:

Start REPL session via host/port/client-id/client-secret:

➜  polaris git:(cli_repl) ./polaris --host localhost --port 8181 --client-id root --client-secret s3cr3t repl
Welcome to the Apache Polaris CLI REPL. Type 'help' for commands, 'exit' or Ctrl-D to quit.
Note: global auth flags (--host, --port, --profile, --client-id, --client-secret, ...) are bound at session start and ignored when re-specified inside the REPL.
polaris@localhost:8181>

Start REPL session via profile:

➜  polaris git:(cli_repl) ./polaris --profile dev repl
Welcome to the Apache Polaris CLI REPL. Type 'help' for commands, 'exit' or Ctrl-D to quit.
Note: global auth flags (--host, --port, --profile, --client-id, --client-secret, ...) are bound at session start and ignored when re-specified inside the REPL.
polaris@dev>

Top level help:

polaris@dev> help
Polaris commands:
 catalogs        manage catalogs
 principals      manage principals
 principal-roles manage principal roles
 catalog-roles   manage catalog roles
 privileges      manage privileges for a catalog role
 namespaces      manage namespaces
 profiles        manage profiles
 policies        manage policies
 setup           perform setup
 tables          manage tables
 find            find an identifier
 repl            start an interactive REPL session
REPL built-ins: exit, help, Ctrl-D

Use 'help <command>' or '<command --help>' for command details.

Help command on another command:

polaris@dev> help principals
usage: polaris principals [-h] [options] SUBCOMMAND ...

options:
  -h, --help            show this help message and exit

Subcommands:
  SUBCOMMAND
    create              Create a new principal
    delete              Delete a principal
    get                 Retrieve metadata for a principal
    list                List principals
    rotate-credentials  Rotate credentials for a principal
    update              Update properties of a principal
    access              Retrieve access details for a principal
    reset               Reset credentials for a principal
    summarize           Display a summary for a principal

Help option from command

polaris@dev> principals --help
usage: polaris principals [-h] [options] SUBCOMMAND ...

options:
  -h, --help            show this help message and exit

Subcommands:
  SUBCOMMAND
    create              Create a new principal
    delete              Delete a principal
    get                 Retrieve metadata for a principal
    list                List principals
    rotate-credentials  Rotate credentials for a principal
    update              Update properties of a principal
    access              Retrieve access details for a principal
    reset               Reset credentials for a principal
    summarize           Display a summary for a principal

Create a new principal:

polaris@dev> principals create test_principal
{"clientId": "3e6665fe17715085", "clientSecret": "57ad1ec91382cab04b73f23cd466b00a"}

List all principals:

polaris@dev> principals list
{"name": "root", "clientId": "root", "properties": {}, "createTimestamp": 1778964018874, "lastUpdateTimestamp": 1778964018874, "entityVersion": 1}
{"name": "test_principal", "clientId": "3e6665fe17715085", "properties": {}, "createTimestamp": 1778967344920, "lastUpdateTimestamp": 1778967344920, "entityVersion": 1}

Checklist

• 🛡️ Don't disclose security issues! (contact security@apache.org)
• 🔗 Clearly explained why the changes are needed, or linked related issues: Fixes #
• 🧪 Added/updated tests with good coverage, or manually tested (and explained how)
• 💡 Added comments for complex logic
• 🧾 Updated CHANGELOG.md (if needed)
• 📚 Updated documentation in site/content/in-dev/unreleased (if needed)

[dimas-b]

LGTM 👍 Thanks, @MonkeyCanCode !

I tested it briefly... it works :) but it's a bit awkward .... for example create namespace requires a --catalog option. It would be nicer to be able to start repl --catalog polaris and not have to provide the catalog option inside the REPL 🙂

[flyrain]

Thanks for adding this, @MonkeyCanCode! It's pretty cool after trying. It's great that we don't have to re-typing credentials or profiles.

Overall, I think it is a good start point. It is a one-liner command now. We could add more context later, for example, adding a catalog as a context, as @dimas-b pointed out, similar to a typical sql repl, use catalog to set the current catalog, etc.

[MonkeyCanCode]

LGTM 👍 Thanks, @MonkeyCanCode !

I tested it briefly... it works :) but it's a bit awkward .... for example create namespace requires a --catalog option. It would be nicer to be able to start repl --catalog polaris and not have to provide the catalog option inside the REPL 🙂

Good thinking and better UX as well. I will add this change soon.

[MonkeyCanCode]

Thanks for the review and feed back @dimas-b and @flyrain . I will work on those changes later this week.

[dimas-b]

I meant to approve in my previous review 😅

From my POV it's fine to merge this PR and improve later.

[MonkeyCanCode]

I meant to approve in my previous review 😅

From my POV it's fine to merge this PR and improve later.

All good. All feedbacks are addressed now. Do you mind take another look?

[MonkeyCanCode]

For the record, this is due to windows doesn't support readline (found this while play on my windows. ref: https://stackoverflow.com/questions/51157443/pythons-readline-module-not-available-for-windows). If we need to get this working on Windows, we can add pyreadline3 as suggested in the stackoverflow page as well. @flyrain @dimas-b

[flyrain]

I'm OK to add it later.

[flyrain]

+1. The feature is pretty cool. Thanks a lot for adding it, @MonkeyCanCode .

[flyrain]

I'm OK to add it later.