Files
Google Team Member 28618a8dcb feat: Add Spanner Admin Toolset
This change introduces a new `SpannerAdminToolset` with tools for managing Google Cloud Spanner resources. The toolset includes functions to list and get details of Spanner instances and instance configurations, and to create, list databases. The new toolset is marked as experimental. Unit tests for the new admin tools are also added

PiperOrigin-RevId: 885116111
2026-03-17 11:14:37 -07:00

92 lines
2.9 KiB
Python

# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from __future__ import annotations
from google.adk.tools.google_tool import GoogleTool
from google.adk.tools.spanner.admin_toolset import SpannerAdminToolset
from google.adk.tools.spanner.settings import SpannerToolSettings
from google.adk.tools.spanner.spanner_credentials import SpannerCredentialsConfig
import pytest
@pytest.mark.asyncio
async def test_spanner_toolset_tools_default():
"""Test Admin Spanner toolset.
This test verifies the behavior of the Spanner admin toolset when no filter is
specified.
"""
credentials_config = SpannerCredentialsConfig(
client_id="abc", client_secret="def"
)
toolset = SpannerAdminToolset(credentials_config=credentials_config)
assert isinstance(toolset._tool_settings, SpannerToolSettings) # pylint: disable=protected-access
assert toolset._tool_settings.__dict__ == SpannerToolSettings().__dict__ # pylint: disable=protected-access
tools = await toolset.get_tools()
assert tools is not None
assert len(tools) == 7
assert all([isinstance(tool, GoogleTool) for tool in tools])
expected_tool_names = set([
"list_instances",
"get_instance",
"list_databases",
"create_instance",
"create_database",
"list_instance_configs",
"get_instance_config",
])
actual_tool_names = set([tool.name for tool in tools])
assert actual_tool_names == expected_tool_names
@pytest.mark.parametrize(
"selected_tools",
[
pytest.param(
["list_instances"],
id="list-instances",
)
],
)
@pytest.mark.asyncio
async def test_spanner_admin_toolset_selective(selected_tools):
"""Test selective Admin Spanner toolset.
This test verifies the behavior of the Spanner admin toolset when a filter is
specified.
Args:
selected_tools: A list of tool names to filter.
"""
credentials_config = SpannerCredentialsConfig(
client_id="abc", client_secret="def"
)
toolset = SpannerAdminToolset(
credentials_config=credentials_config,
tool_filter=selected_tools,
spanner_tool_settings=SpannerToolSettings(),
)
tools = await toolset.get_tools()
assert tools is not None
assert len(tools) == len(selected_tools)
assert all([isinstance(tool, GoogleTool) for tool in tools])
expected_tool_names = set(selected_tools)
actual_tool_names = set([tool.name for tool in tools])
assert actual_tool_names == expected_tool_names