feat: add additional_catalogs parameter to Client

Author: fvaleye

src/altertable_flightsql/client.py

@@ -108,6 +108,7 @@ def __init__(
         *,
         catalog: Optional[str] = "altertable",
         schema: Optional[str] = "main",
+        additional_catalogs: Optional[Sequence[str]] = None,
         host: str = "flight.altertable.ai",
         port: int = 443,
         tls: bool = True,
@@ -121,6 +122,11 @@ def __init__(
             password: Altertable password (required).
             catalog: Default catalog name (default: "altertable").
             schema: Default schema name (default: "main").
+            additional_catalogs: Server-side catalog names to make visible
+                in this session in addition to ``catalog`` (default: None).
+                Each name must be a catalog the authenticated user already
+                has access to; read-only vs read-write is determined by the
+                catalog's server-side configuration.
             host: Altertable server hostname (default: "flight.altertable.ai").
             port: Server port (default: 443).
             tls: Whether to use TLS/SSL (default: True).
@@ -156,6 +162,13 @@ def __init__(
         if schema:
             options["schema"] = sql_pb2.SessionOptionValue(string_value=schema)
 
+        if additional_catalogs:
+            options["additional_catalogs"] = sql_pb2.SessionOptionValue(
+                string_list_value=sql_pb2.SessionOptionValue.StringListValue(
+                    values=list(additional_catalogs),
+                ),
+            )
+
         if options:
             self._set_options(options)