v0.9.0

BREAKING CHANGE: PyPI package renamed to connectrpc

This is the last version published as the connect-python package - we have migrated to connectrpc as part of this release to match the same code you write with it and will only publish future versions to connectrpc. Make sure to update your dependency specifications to connectrpc to continue to receive updates. Sorry for the churn as we get closer to a stable state.

---

This release includes a significant rework to compression handling - now, it is possible to implement custom compression methods or configure defaults with custom parameters. This release also allows configuring the supported compression methods for a server rather than automatically inspecting from application dependencies. Defaults now match other Connect implementations, only enabling gzip by default.

We have also added some other small enhancements like gRPC-Web support and improved debugging.

☢️ Breaking changes

Pass compressions rather than strings when configuring the client

Before:

GreeterClient("http://localhost", accept_compressions=["zstd", "br", "gzip"])

After:

from connectrpc.compression.brotli import BrotliCompression
from connectrpc.compression.gzip import GzipCompression
from connectrpc.compression.zstd import ZstdCompression

GreeterClient("http://localhost", accept_compressions=[
    ZstdCompression(), BrotliCompression(), GzipCompression()
])

To configure a client to use gRPC protocol, pass protocol=ProtocolType.GRPC instead of grpc=True

Before:

GreeterClient("http://localhost", grpc=True)

After:

from connectrpc.protocol import ProtocolType

GreeterClient("http://localhost", protocol=ProtocolType.GRPC)

Metadata interceptors now accept Error | None in on_end

Before:

class MyInterceptor:
    def on_end(self, token, ctx):
        ...

After:

class MyInterceptor:
    def on_end(self, token, ctx, error):
        ...

📈 Enhancements

• Allow setting supported compressions in server by @anuraaga in #98
• Make Compression protocol public and default to gzip-only by @anuraaga in #103
• Mark codegen plugin as supporting edition 2024 by @stefanvanburen in #125
• Add support for debug in error details by @stefanvanburen in #147
• Add exception to metadata interceptors on_end by @anuraaga in #149
• Add support for gRPC-web by @anuraaga in #161

🛠️ Bug fixes

• Process GET params for empty request messages by @Zaczero in #121
• • Fix server streaming handler not cancelled on client disconnect by @stefanvanburen in #175

New Contributors

• @Zaczero made their first contribution in #121

Full Changelog: v0.8.1...v0.9.0

v0.8.1

This hotfix fixes the default compression level used with gzip, which previously was set too high causing performance issues.

🛠️ Bug fixes

• Align compression levels with Envoy by @anuraaga in #97

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas

@Zaczero

Full Changelog: v0.8.0...v0.8.1

v0.8.0

This is a big release - the client now supports bidirectional streaming and the gRPC protocol. With this, connect-python is now a full-featured Connect implementation!

This is enabled by switching our HTTP client transport to pyqwest, a Python interface to the Rust HTTP client reqwest. This client supports all features of HTTP, allowing us to also support bidirectional streaming and gRPC (via HTTP trailers) in turn.

Keep in mind though that this is a very new project, built specifically to push connect-python forward. The underlying reqwest library has been in use for some time and should be battle-tested, but the Python wrapper is new - let us know if you run into any issues so we can fix them.

☢️ Breaking changes

• The HTTP transport for clients has been changed to pyqwest. If you created connect clients with default parameters, this will not need any further changes, but if passing a custom session, you will now need to pass a pyqwest client.

Before:

ctx = ssl.create_default_context(cafile="ca.path")
async with (
  httpx.AsyncClient(verify=ctx, http2=True) as session,
  GreeterClient("http://localhost", session=session) as client:
)

After:

async with (
  pyqwest.HTTPTransport(
    tls_ca_cert=Path("ca.path").read(), 
    http_version=pyqwest.HTTPVersion.HTTP2
  ) as transport,
  GreeterClient("http://localhost", http_client=pyqwest.Client(transport)
)

If you have unit tests using httpx.ASGITransport / httpx.WSGITransport, you also will need to migrate to pyqwest.testing.ASGITransport / pyqwest.testing.WSGITransport.

📈 Enhancements

• Add support for gRPC client protocol by @anuraaga in #80
• Migrate to pyqwest by @anuraaga in #88

🛠️ Bug fixes

• Avoid yielding messages on GeneratorExit in sync server by @anuraaga in #90
• Drain request body in all error cases in WSGI by @anuraaga in #94

Full Changelog: v0.7.1...v0.8.0

v0.7.1

This release fixes a conflict preventing using this library along with grpc-python, possibly from dependencies.

🛠️ Bug fixes

• Use custom package for grpc status.proto by @anuraaga in #76

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas

@gibsondan

Full Changelog: v0.7.0...v0.7.1

v0.7.0

This release includes initial support for the gRPC protocol in connect-python. It is currently only supported on the server side and requires using pyvoy for its support for HTTP/2 trailers.

📈 Enhancements

• Implement server side gRPC protocol by @anuraaga in #68

🛠️ Bug fixes

• Set default accept-encoding to compression algorithms supported by the client by @achille-roussel in #71

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and pull requests

@achille-roussel

Full Changelog: v0.6.0...v0.7.0

v0.6.0

Since the first release of the current codebase, we have been focused on fleshing out docs and our conformance testing suite. We hope to have the new docs out on connectrpc.com soon so it's even easier to get started. Feature-wise, we have integration with ASGI lifespan to allow declaring async initialization logic and some improvement to the WSGI implementation.

📈 Enhancements

• Add support for ASGI lifespan by @anuraaga in #46

🛠️ Bug fixes

• Do multiple reads for WSGI even with content length by @anuraaga in #37

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas

@maaft
@rockwotj

Full Changelog: v0.5.0...v0.6.0

v0.5.0

What's Changed

• Fix: Add workdir to goreleaser action for protoc-gen-connect-python build by @i2y in #3
• Switch to "real" dev dependencies by @stefanvanburen in #4
• Fix: Update GitHub environment name to pypi-release in release workflow by @i2y in #5
• Fix badge links and code-workspace filename by @anuraaga in #6

New Contributors

• @i2y made their first contribution in #3
• @stefanvanburen made their first contribution in #4
• @anuraaga made their first contribution in #6

Full Changelog: https://github.com/connectrpc/connect-python/commits/v0.5.0