skip to navigation
skip to content

thriftpy 0.1.2

Pure python implemention of Apache Thrift.

Latest Version: 0.3.9

ThriftPy is a pure python implemention of Apache Thrift in a pythonic way.



Install with pip

$ pip install thriftpy

You may also install cython first to build cython extension locally.

$ pip install cython thriftpy

Code Demo

ThriftPy make it super easy to write server/client code with thrift. Let’s checkout this simple pingpong service demo.

We need a ‘pingpong.thrift’ file:

service PingPong {
    string ping(),

Then we can make a server:

import thriftpy
from thriftpy.rpc import make_server

pingpong = thriftpy.load("pingpong.thrift")

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

server = make_server(pingpong.PingPong, Dispatcher(), '', 6000)

And a client:

import thriftpy
from thriftpy.rpc import make_client

pingpong = thriftpy.load("pingpong.thrift")

client = make_client(pingpong.PingPong, '', 6000)

See, it’s that easy!

You can refer to ‘examples’ and ‘tests’ directory in source code for more usage examples.


Currently ThriftPy have these features (also advantages over the upstream python lib):

  • Supports python2.7 to python3.4 and pypy.

  • Compatible with Apache Thirft. You can use ThriftPy together with the official implemention servers and clients, such as a upstream server with a thriftpy client or the opposite.

    (Currently only binary protocol & buffered transport were implemented.)

  • Can directly load thrift file as module, the sdk code will be generated on the fly.

    For example, pingpong = thriftpy.load("pingpong.thrift") will load ‘pingpong.thrift’ as ‘pingpong’ module.

    Or, when import hook enabled, directly use import pingpong_thrift to import the ‘pingpong.thrift’ file as module.

  • Pure python, standalone implemention. No longer need to compile & install the ‘thrift’ package. All you need is python and thrift file.

  • Easy RPC server/client setup.


Some benchmark results:

# apache thrift py binary
binary protocol struct benchmark for 100000 times:
encode  -> 3.74061203003
decode  -> 5.02829790115

# apache thrift c binary
accelerated protocol struct benchmark for 100000 times:
encode  -> 0.398949146271
decode  -> 0.536000013351

# thriftpy & pypy2.3
binary protocol struct benchmark for 100000 times:
encode  -> 0.413738965988
decode  -> 0.605606079102

# thriftpy & py3.4
binary protocol struct benchmark for 100000 times:
encode  -> 3.291545867919922
decode  -> 4.337666034698486

# thriftpy & py3.4 + cython
cybinary protocol struct benchmark for 100000 times:
encode  -> 1.1233220100402832
decode  -> 1.9023690223693848

Checkout the benchmark/benchmark.rst for detailed benchmark scripts and scores.


Currently ThriftPy is not fully compatible with thrift, I only implemented the features we need at

These todos need to be done, but may not be completed by me in near future, so contributions are very welcome!

  • other protocol and transport except binary and buffered transport.

  • Cython binary protocol code audit & C Binary extension.

    I’m not good at C or Cython programming so the cython implemention may have issues and need to be audited. The cython binary protocol implemention is about 2-3 times faster than the python binary protocol, but still many times slower than the official C extension. A better c extension needed.

  • map type const.

  • ‘namespace’, ‘extends’, ‘import’, ‘oneway’ keywords.

  • the ‘.thrift’ file parser will skip a section if it has syntax error. A better warning message should be given.


  1. Fork the repo and make changes.
  2. Write a test which shows a bug was fixed or the feature works as expected.
  3. Make sure travis-ci test succeed.
  4. Send pull request.
File Type Py Version Uploaded on Size
thriftpy-0.1.2.tar.gz (md5) Source 2014-06-07 66KB