Metadata-Version: 2.4
Name: googlesql
Version: 0.1.0
Summary: GoogleSQL protobuf schemas and generated local-service clients
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: protobuf>=5.29.6
Requires-Dist: grpcio>=1.71.0 ; extra == "grpc"
Provides-Extra: grpc

# googlesql

This package contains the GoogleSQL protobuf schemas and generated Python
bindings for the local service.

Install the protobuf-only package with:

```bash
uv add googlesql
```

Install the generated gRPC client bindings with:

```bash
uv add 'googlesql[grpc]'
```

The generated modules are available under `googlesql.local_service`. For
example:

```python
import grpc

from googlesql.local_service import local_service_pb2
from googlesql.local_service import local_service_pb2_grpc

channel = grpc.insecure_channel("127.0.0.1:50051")
client = local_service_pb2_grpc.GoogleSqlLocalServiceStub(channel)
response = client.GetAnalyzerOptions(
    local_service_pb2.AnalyzerOptionsRequest()
)
```

The package follows the current checkout's `local_service.proto` API. It does
not include the GoogleSQL service implementation.

## Regenerating bindings

From the repository root, update the copied proto closure and generated files
with:

```bash
uv run --project py/googlesql python tools/update_python_client.py
```

To verify that committed files are up to date without changing the worktree:

```bash
uv run --project py/googlesql python tools/update_python_client.py --check
```

The updater uses the repository's Python template generators and Buf. Bazel is
not required for Python client generation.

