Changelog and set_client_for

Author: exrhizo

CHANGELOG.md

@@ -7,6 +7,26 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## Dev
 
+## [0.39.0 - 2025-06-25]
+
+### Added
+* Multi-tenant support: `graphistry.client()` and `graphistry.set_client_for()`
+  * Global interface `PyGraphistry` class => Global `PyGraphistryClient` instance
+  * `graphistry.client()` creates an independent `PyGraphistryClient` instance
+* Type annotations added, especially in PlotterBase.py, arrow_uploader.py, and pygraphistry.py
+
+### Changed
+* Refactored Kusto and Spanner plugins:
+  * Renamed `kustograph.py` to `kusto.py` for consistency
+  * Renamed `spannergraph.py` to `spanner.py` for consistency
+  * Improved configuration handling and error messages
+* Enhanced test coverage with new tests for client_session, kusto, and spanner modules
+
+### Breaking 🔥
+* Plugin module renames: `graphistry.plugins.kustograph` → `graphistry.plugins.kusto` and `graphistry.plugins.spannergraph` → `graphistry.plugins.spanner`
+* Configuration for `Spanner` now uses `g.configure_spanner(...)` instead of `g.register(spanner_config={...})`
+* Configuration for `Kusto` now uses `g.configure_kusto(...)` instead of `g.register(kusto_config={...})`
+
 ## [0.38.3 - 2025-06-24]
 
 ### Fixed

demos/demos_databases_apis/spanner/google_spanner_finance_graph.ipynb

@@ -121,8 +121,7 @@
     "                    protocol  = \"https\", \n",
     "                    server    = os.getenv(\"GRAPHISTRY_SERVER\"),\n",
     "                    username  = os.getenv(\"GRAPHISTRY_USERNAME\"),\n",
-    "                    password  = os.getenv(\"GRAPHISTRY_PASSWORD\")\n",
-    "                   )"
+    "                    password  = os.getenv(\"GRAPHISTRY_PASSWORD\"))"
    ]
   },
   {
@@ -135,26 +134,19 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
-   "id": "1297168f",
+   "execution_count": null,
+   "id": "2e051930",
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Insert your Spanner configuration\n",
     "SPANNER_INSTANCE_ID = os.getenv(\"SPANNER_INSTANCE_ID\") or \"finance-graph-instance\"\n",
     "SPANNER_DATABASE_ID = os.getenv(\"SPANNER_DATABASE_ID\") or \"finance-graph-db\"\n",
     "\n",
-    "# Service Account JSON Path -or- Project ID for interactive login\n",
-    "SPANNER_SERVICE_ACCOUNT_JSON_PATH = os.getenv(\"SPANNER_SERVICE_ACCOUNT_JSON_PATH\") or \"path/to/credentials.json\"\n",
-    "SPANNER_PROJECT_ID = os.getenv(\"SPANNER_PROJECT_ID\") or \"finance-graph-project\""
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "bb895e0d-b2a4-474e-aba9-46f791ec9600",
-   "metadata": {},
-   "source": [
-    "#### Google web-based auth below, only required if not using a credentials json file:"
+    "# Option 1: Project ID is required for interactive login\n",
+    "SPANNER_PROJECT_ID = os.getenv(\"SPANNER_PROJECT_ID\") or \"finance-graph-project\"\n",
+    "\n",
+    "# Option 2: use a service account key: \n",
+    "# SPANNER_SERVICE_ACCOUNT_JSON_PATH = os.getenv(\"SPANNER_SERVICE_ACCOUNT_JSON_PATH\") or \"path/to/credentials.json\""
    ]
   },
   {
@@ -165,17 +157,10 @@
    "outputs": [],
    "source": [
     "# Set the google project id for interactive login\n",
-    "# !gcloud config set project {PROJECT_ID}\n",
-    "# %env GOOGLE_CLOUD_PROJECT={PROJECT_ID}"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "f175d952-c1cc-4793-aad5-0cdb5142b6fe",
-   "metadata": {},
-   "outputs": [],
-   "source": [
+    "\n",
+    "# !gcloud config set project {SPANNER_PROJECT_ID}\n",
+    "# %env GOOGLE_CLOUD_PROJECT={SPANNER_PROJECT_ID}\n",
+    "\n",
     "#!gcloud auth application-default login"
    ]
   },
@@ -186,25 +171,22 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Spanner can be configured with a credentials JSON or using gcloud auth application-default login (below)\n",
+    "# Option 1: interactive login using gcloud auth application-default login (below)\n",
+    "graphistry.configure_spanner(\n",
+    "    project_id=SPANNER_PROJECT_ID,\n",
+    "    instance_id=SPANNER_INSTANCE_ID,\n",
+    "    database_id=SPANNER_DATABASE_ID\n",
+    ")\n",
     "\n",
     "\n",
-    "# Option 1: interactive login using gcloud auth application-default login (below)\n",
+    "# Option 2: use a service account key: \n",
     "# graphistry.configure_spanner(\n",
-    "#     project_id=SPANNER_PROJECT_ID,\n",
     "#     instance_id=SPANNER_INSTANCE_ID,\n",
-    "#     database_id=SPANNER_DATABASE_ID\n",
+    "#     database_id=SPANNER_DATABASE_ID,\n",
+    "#     credentials_file=SPANNER_SERVICE_ACCOUNT_JSON_PATH\n",
     "# )\n",
     "\n",
     "\n",
-    "# Option 2: use a service account key: \n",
-    "graphistry.configure_spanner(\n",
-    "    instance_id=SPANNER_INSTANCE_ID,\n",
-    "    database_id=SPANNER_DATABASE_ID,\n",
-    "    credentials_file=SPANNER_SERVICE_ACCOUNT_JSON_PATH\n",
-    ")\n",
-    "\n",
-    "\n",
     "\n",
     "# optional setting to limit the number of records returned\n",
     "LIMIT_CLAUSE = \"\"\n",

docs/source/plugins.rst

@@ -23,7 +23,7 @@ Graph
 * `Gremlin <https://tinkerpop.apache.org>`_ (:class:`graphistry.gremlin.GremlinMixin`)
 * `Memgraph <https://memgraph.com>`_ (:meth:`graphistry.PlotterBase.PlotterBase.cypher`)
 * `Neo4j <https://neo4j.com>`_ (:meth:`graphistry.PlotterBase.PlotterBase.cypher`)
-* `Google Spanner Graph <https://cloud.google.com/spanner/docs/graph/overview>`_ (:meth:`graphistry.PlotterBase.PlotterBase.spanner_gql_to_g`)
+* `Google Spanner Graph <https://cloud.google.com/spanner/docs/graph/overview>`_ (:meth:`graphistry.pygraphistry.PyGraphistry.spanner_gql`)
 * `TigerGraph <https://www.tigergraph.com>`_ (:meth:`graphistry.PlotterBase.PlotterBase.gsql`)
 * `Trovares <https://trovares.com>`_
 

graphistry/__init__.py

@@ -15,7 +15,7 @@
     description,
     bind,
     client,
-    set_client,
+    set_client_for,
     style,
     addStyle,
     edges,

graphistry/pygraphistry.py

@@ -559,8 +559,6 @@ def register(
         :type certificate_validation: Optional[bool]
         :param bolt: Neo4j bolt information. Optional driver or named constructor arguments for instantiating a new one.
         :type bolt: Union[dict, Any]
-        :param spanner_config: Spanner connection information. Named constructor arguments for instantiating a spanner client
-        :type spanner_config: Union[dict, Any]
         :param protocol: Protocol used to contact visualization server, defaults to "https".
         :type protocol: Optional[str]
         :param token_refresh_ms: Ignored for now; JWT token auto-refreshed on plot() calls.
@@ -1753,7 +1751,7 @@ def client(self, inherit: bool = False) -> 'PyGraphistryClient':
             new_client.session = self.session.copy()
         return new_client
 
-    def set_client(self, plotter: Plotter) -> Plotter:
+    def set_client_for(self, plotter: Plotter) -> Plotter:
         """Set the client for a plotter.
 
         :param plotter: Plotter to set the client for
@@ -2497,7 +2495,7 @@ def _handle_api_response(self, response):
 description = PyGraphistry.description
 bind = PyGraphistry.bind
 client = PyGraphistry.client
-set_client = PyGraphistry.set_client
+set_client_for = PyGraphistry.set_client_for
 edges = PyGraphistry.edges
 nodes = PyGraphistry.nodes
 pipe = PyGraphistry.pipe