takumi-client 0.1.0

Thrift client pool for Takumi

Thrift client pool for Takumi.

Install

$ pip install takumi-client

Usage

This module relies on takumi-config for settings.

• CLIENT_SETTINGS
  • service_name: required, service name defined in thrift file
  • thrift_file: required, existing thrift file path
  • pool_size: optional, connection pool size, default 30
  • timeout: optional, connection timeout, default 30s
  • check_time: optional, time interval for checking failed connections, default 10s
  • hosts: optional, a list of hosts: [(‘hostname’, port)]
  • hosts_class: optional, alternative class used to load hosts, default takumi_client.hosts.ListHosts
  • extra args: vary for different hosts classes

Example settings:

CLIENT_SETTINGS = {
    'demo': {
        'service_name': 'PingService',
        'thrift_file': 'ping.thrift',
        'hosts': [
            ('localhost', 1990),
            ('localhost', 8010),
            ('localhost', 1890)
        ]
    }
}

To get a pool:

from takumi_client import clients

pool = clients['demo']

To invoke an api:

with pool.client_ctx() as c:
    c.ping()