Guidance For: 0.17.0 | 0.16.0 | 0.15.0 | 0.14.0 | 0.13.0 | 0.12.0 | 0.11.0
Thrift supports many programming languages and has an impressive test suite that exercises most of the languages, protocols, and transports. Each build exercises a matrix of thousands of possible combinations. Each language typically has a minimum required version as well as support libraries - some mandatory and some optional. The information provided below will help you assess whether you can use Apache Thrift with your project. Obviously this is a complex matrix to maintain and may not be correct in all cases - if you spot an error please inform the developers using the mailing list, or better yet, Edit on GitHub.
Apache Thrift currently uses two build systems. The autoconf
build system is
the most complete and builds all supported languages, however it does not support
Windows.. The cmake
build system works on Linux and Windows, and has been
designated by the project to replace autoconf
however this transition will
take quite some time to complete. During that transition, the cmake build will
not support all languages.
The Language/Library Levels indicate the minimum and maximum versions that are used in the continuous integration environments (Appveyor, Travis) for Apache Thrift. Other language levels may be supported for each language, however tested less thoroughly; check the README file inside each lib directory for additional details. Note: while a language may contain support for protocols, transports, and servers, the extent to which each is tested as part of the overall build process varies. The definitive integration test for the project is called the “cross” test which executes a test matrix with clients and servers communicating across languages.
Thrift’s core transport (supported by all languages) is TSocket. Thrift’s core protocol is TBinary, supported by all languages except for JavaScript.
Language | Since | Build Systems | Lang/Lib Levels (Tested) | Field types | Low-Level Transports | Transport Wrappers | Protocols | Servers | Open Issues | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
autoconf | cmake | Min | Max | Uuid | Domain | File | Memory | Pipe | Socket | TLS | Framed | Header | http | zlib | Binary | Compact | JSON | Multiplex | Forking | Nonblocking | Simple | Threaded | ThreadPool | |||
C (glib) | 0.6.0 | 2.48.2 | 2.56.4 | C (glib) | ||||||||||||||||||||||
C++ | 0.2.0 | C++11 | C++ | |||||||||||||||||||||||
Common LISP | 0.12.0 | SBCL 1.4.x | SBCL 1.5.3 | Common LISP | ||||||||||||||||||||||
Dlang | 0.9.0 | 2.087.0 | 2.087.0 | D | ||||||||||||||||||||||
Dart | 0.10.0 | 2.0.0 | 2.4.0 | Dart | ||||||||||||||||||||||
Delphi | 0.8.0 | 2010 | Alexandria 11.2 | Delphi | ||||||||||||||||||||||
.NET Standard | 0.13.0 | .NET Standard 2.x, .NET 6 | .NET Standard | |||||||||||||||||||||||
Erlang | 0.3.0 | 18.3 | 22.0 | Erlang | ||||||||||||||||||||||
Go | 0.7.0 | 1.22 | 1.23 | Go | ||||||||||||||||||||||
Haxe | 0.9.3 | 4.1.5 | 4.2.5 | Haxe | ||||||||||||||||||||||
Java (SE) | 0.2.0 | 11 | 19 | Java SE | ||||||||||||||||||||||
Java (ME) | 0.5.0 | unknown | Java ME | |||||||||||||||||||||||
Javascript | 0.3.0 | ES5 | ES6 | Javascript | ||||||||||||||||||||||
Lua | 0.9.2 | 5.1.5 | 5.2.4 | Lua | ||||||||||||||||||||||
node.js | 0.6.0 | 10.x | 10.x | node.js | ||||||||||||||||||||||
node.ts | 0.12.0 | 3.1.6 | node.ts | |||||||||||||||||||||||
OCaml | 0.2.0 | 4.04.0 | OCaml | |||||||||||||||||||||||
Perl | 0.2.0 | 5.22.1 | 5.26.1 | Perl | ||||||||||||||||||||||
PHP | 0.2.0 | 7.0.22 | 7.2.19 | PHP | ||||||||||||||||||||||
Python | 0.2.0 | 2.7.12, 3.5.2 | 2.7.15, 3.6.8 | Python | ||||||||||||||||||||||
Ruby | 0.2.0 | 2.3.1p112 | 2.5.1p57 | Ruby | ||||||||||||||||||||||
Rust | 0.11.0 | 1.65.0 | 1.xx.x | Rust | ||||||||||||||||||||||
Smalltalk | 0.2.0 | unknown | Smalltalk | |||||||||||||||||||||||
Swift | 0.12.0 | 5.7 | Swift | |||||||||||||||||||||||
Language | Since | autoconf | cmake | Min | Max | Uuid | Domain | </th>File | Memory | Pipe | Socket | TLS | Framed | Header | http | zlib | Binary | Compact | JSON | Multiplex | Forking | Nonblocking | Simple | Threaded | ThreadPool | Open Issues |
Build Systems | Lang/Lib Levels (Tested) | Field types | Low-Level Transports | Transport Wrappers | Protocols | Servers |