connectrpc

0.10.0 verified Sat May 09 auth: no python

Server and client runtime library for Connect RPC. Current version: 0.10.0. Requires Python >=3.10. Released on PyPI as connectrpc since v0.9.0 (previously connect-python). Monthly releases.

pip install connectrpc

Common errors

error ModuleNotFoundError: No module named 'connectrpc' ↓

cause Package not installed or installed under old name 'connect-python'.

fix

pip install connectrpc

error TypeError: create_connect_client() got an unexpected keyword argument 'proto_json' ↓

cause proto_json=True removed in v0.10.0.

fix

Use codec=proto_json_codec() instead.

error AttributeError: module 'connectrpc' has no attribute 'server' ↓

cause Incorrect import path. Package structure uses submodules like connectrpc.server.

fix

Use 'from connectrpc.server import create_connect_server'

Warnings

breaking PyPI package renamed from 'connect-python' to 'connectrpc' in v0.9.0. Update your dependencies to 'connectrpc'. ↓

fix pip uninstall connect-python && pip install connectrpc

breaking proto_json=True removed in v0.10.0. Use codec=proto_json_codec() instead. ↓

fix from connectrpc.codec import proto_json_codec; client = create_connect_client('...', codec=proto_json_codec())

gotcha Default transport changed from httpx to pyqwest (v0.8.0+). For custom HTTP settings, use transport parameter. ↓

fix from connectrpc.transport import PyqwestTransport; create_connect_client('...', transport=PyqwestTransport(...))

deprecated The 'connect-python' package on PyPI is deprecated. All future releases are under 'connectrpc'. ↓

fix See rename warning.

Imports

create_connect_server

wrong

from connect_rpc.server import create_connect_server

correct

from connectrpc.server import create_connect_server

Package renamed to connectrpc

ConnectServer

wrong

from connect.server import ConnectServer

correct

from connectrpc.server import ConnectServer

Incorrect module name

create_connect_client

wrong

from connect_rpc.client import create_connect_client

correct

from connectrpc.client import create_connect_client

Package renamed

proto_json_codec

wrong

from connectrpc.converter import proto_json_codec

correct

from connectrpc.codec import proto_json_codec

Moved to codec module

ConnectException

wrong

from connectrpc.errors import ConnectException

correct

from connectrpc.exceptions import ConnectException

Exception class in exceptions module

Quickstart

Minimal JSON client calling a Connect RPC service.

import asyncio
from connectrpc.client import create_connect_client
from connectrpc.codec import proto_json_codec

async def main():
    client = create_connect_client(
        "http://localhost:8080",
        codec=proto_json_codec(),
    )
    request = {"name": "World"}
    response = await client.call("greet.GreetService/Greet", request)
    print(response)

asyncio.run(main())