Pure python implementation of Apache Thrift.
Project description
ThriftPy is a pure python implementation of Apache Thrift in a pythonic way.
Documentation: https://thriftpy.readthedocs.org/
Installation
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
pingpong_thrift = thriftpy.load("pingpong.thrift", module_name="pingpong_thrift")
from thriftpy.rpc import make_server
class Dispatcher(object):
def ping(self):
return "pong"
server = make_server(pingpong_thrift.PingPong, Dispatcher(), '127.0.0.1', 6000)
server.serve()
And a client:
import thriftpy
pingpong_thrift = thriftpy.load("pingpong.thrift", module_name="pingpong_thrift")
from thriftpy.rpc import make_client
client = make_client(pingpong_thrift.PingPong, '127.0.0.1', 6000)
client.ping()
See, it’s that easy!
You can refer to ‘examples’ and ‘tests’ directory in source code for more usage examples.
Features
Currently ThriftPy have these features (also advantages over the upstream python lib):
Supports python2.6+, python3.3+, pypy and pypy3.
Pure python implementation. No longer need to compile & install the ‘thrift’ package. All you need is thriftpy and thrift file.
Compatible with Apache Thrift. You can use ThriftPy together with the official implementation servers and clients, such as a upstream server with a thriftpy client or the opposite.
Currently implemented protocols and transports:
binary protocol (python and cython)
compact protocol (python and cython)
json protocol
buffered transport (python & cython)
framed transport
tornado server and client (with tornado 4.0)
Can directly load thrift file as module, the sdk code will be generated on the fly.
For example, pingpong_thrift = thriftpy.load("pingpong.thrift", module_name="pingpong_thrift") will load ‘pingpong.thrift’ as ‘pingpong_thrift’ module.
Or, when import hook enabled by thriftpy.install_import_hook(), you can directly use import pingpong_thrift to import the ‘pingpong.thrift’ file as module, you may also use from pingpong_thrift import PingService to import specific object from the thrift module.
Easy RPC server/client setup.
Contribute
Fork the repo and make changes.
Write a test which shows a bug was fixed or the feature works as expected.
Make sure travis-ci or tox tests succeed.
Send pull request.
Contributors
Changelog
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.