Metadata-Version: 2.4
Name: kubling-grpc
Version: 1.1.1
Summary: Official generated Python bindings for the Kubling gRPC protocol
Author: Kubling contributors
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/kubling-community/kubling-grpc
Project-URL: Repository, https://github.com/kubling-community/kubling-grpc
Project-URL: Issues, https://github.com/kubling-community/kubling-grpc/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: protobuf<8,>=7.36.1
Requires-Dist: grpcio<2,>=1.84.0
Provides-Extra: status
Requires-Dist: grpcio-status<2,>=1.84.0; extra == "status"
Dynamic: license-file

# Kubling gRPC Python client

Generated messages, gRPC stubs and shared feature constants for the official
Kubling protocol. Requires Python 3.10 or later. This package defines no DB-API,
ORM or framework adapter behavior. Server support must be discovered through
capabilities before using optional protocol features.

Distribution name: `kubling-grpc`. Official releases share the canonical
repository version; availability depends on a completed release to PyPI.

```sh
pip install kubling-grpc==1.1.1
```

```python
from kubling import features
from kubling.v1 import command_pb2, command_pb2_grpc

query = command_pb2_grpc.QueryServiceStub(channel)
```

Install `kubling-grpc[status]` for `grpcio-status` helpers to unpack rich gRPC
status details. `KublingError` itself is always included.

Build from the repository root using Bash, Python 3.10+ and network access:

```sh
python -m pip install -r sdk-python/requirements-build.txt
python -m build sdk-python
python -m twine check sdk-python/dist/*
```

Builds from a checkout regenerate from the canonical protos using the pinned
Buf plugins. Generated code stays out of Git but is included in both the wheel
and sdist. The sdist can produce a wheel without Buf, protoc or a repository
checkout. Installation of either distribution needs no code generation.

The package uses the `kubling` namespace and imports `kubling.v1.*`; applications
must not add `sdk-python/generated` to their path when testing an installed
distribution. See the repository's `docs/releases.md` for publishing.
