thriftpy2-httpx-client 0.5

HTTPX Client for ThriftPy2

This package is provides an alternative HTTP client for ThriftPy2 which uses HTTPX instead of the builtin http.client and http.server libraries. This allows the developer to use more complex features like authentication, fine grained timeouts, and asyncio.

Examples:

Setup (Borrowed from ThriftPy2 Docs):

# pingpong.thrift
service PingPong {
    string ping(),
}

import thriftpy2
from thriftpy2.http import make_server

pingpong_thrift = thriftpy2.load(
    "pingpong.thrift",
    module_name="pingpong_thrift",
)

class Dispatcher(object):
    def ping(self):
        return "pong"

server = make_server(
    service=pingpong_thrift.PingPong,
    handler=Dispatcher(),
    host='127.0.0.1',
    port=6000,
)
server.serve()

Async Usage:

from thriftpy2_httpx_client import make_aio_client

client = await make_aio_client(pingpong_thrift, url='http://localhost:6000')
print(await client.ping())  # prints 'pong'

Sync Usage:

from thriftpy2_httpx_client import make_sync_client

client = make_sync_client(pingpong_thrift, url='http://localhost:6000')
print(client.ping())  # prints 'pong'

Additional keyword arguments can be passed to the client to configure the internal httpx.AsyncClient() and httpx.Client() instances. For example, you can enable Kerberos authentication using httpx-gssapi:

from httpx_gssapi import HTTPSPNEGOAuth
from thriftpy2_httpx_client import make_aio_client

client = await make_aio_client(
    pingpong_thrift,
    url='http://localhost:6000',
    auth=HTTPSPNEGOAuth(),
)
print(await client.ping())  # prints 'pong'