mirror of
https://github.com/valitydev/thrift.git
synced 2024-11-07 18:58:51 +00:00
b72d19f653
Summary: - make dist is no fun. Had to add a lot of stuff to Makefile.am to make sure stuff got included in the tarball. - Added a permanent NEWS file with the release notes for this release. - clean.sh removes ylwrap also. - Gave it a real version for make dist. - Added ACLOCAL_AMFLAGS to lib/cpp/Makefile.am to make it easier to work on configure.ac. - Made concurrency_test a non-installed binary because no one wants to install it. - Dropped some symlinks that were annoying make dist. - Updated README. Test Plan: ./bootstrap.sh && ./configure && make dist Compared contents of tarball to source tree. Did this from a fresh git tree so no gross untracked files would be around. On devrs: ./bootstrap.sh && ./configure && make install DESTDIR=/tmp/relinst1 Made sure concurrency_test was built but not installed. Checked zlib URL with firefox. Reviewed By: mcslee git-svn-id: https://svn.apache.org/repos/asf/incubator/thrift/trunk@665274 13f79535-47bb-0310-9956-ffa450edef68
133 lines
3.7 KiB
Plaintext
133 lines
3.7 KiB
Plaintext
Thrift (Thrift IDL and RPC tool)
|
|
|
|
Mark Slee (mcslee@facebook.com)
|
|
Marc Kwiatkowski (marc@facebook.com)
|
|
Aditya Agarwal (aditya@facebook.com)
|
|
|
|
Last Modified: 2007-Mar-06
|
|
|
|
Thrift is distributed under the Thrift open source software license.
|
|
Please see the included LICENSE file.
|
|
|
|
Introduction
|
|
============
|
|
|
|
Thrift is a lightweight, language-independent software stack with an
|
|
associated code generation mechanism for RPC. Thrift provides clean
|
|
abstractions for data transport, data serialization, and application
|
|
level processing. The code generation system takes a simple definition
|
|
language as its input and generates code across programming languages that
|
|
uses the abstracted stack to build interoperable RPC clients and servers.
|
|
|
|
Thrift is specifically designed to support non-atomic version changes
|
|
across client and server code.
|
|
|
|
For more details on Thrift's design and implementation, take a gander at
|
|
the Thrift whitepaper included in this distribution or at the README files
|
|
in your particular subdirectory of interest.
|
|
|
|
Heirarchy
|
|
=========
|
|
|
|
thrift/
|
|
|
|
compiler/
|
|
Contains the Thrift compiler, implemented in C++.
|
|
|
|
lib/
|
|
Contains the Thrift software library implementation, subdivided by
|
|
language of implementation.
|
|
|
|
cpp/
|
|
java/
|
|
php/
|
|
py/
|
|
rb/
|
|
|
|
test/
|
|
|
|
Contains sample Thrift files and test code across the target programming
|
|
languages.
|
|
|
|
tutorial/
|
|
|
|
Contains a basic tutorial that will teach you how to develop software
|
|
using Thrift.
|
|
|
|
Requirements
|
|
============
|
|
|
|
Thrift requires boost shared pointers from boost-1.33.1 or greater, see:
|
|
http://www.boost.org/libs/smart_ptr/smart_ptr.htm
|
|
|
|
Some portions of Thrift also depend upon libevent, see:
|
|
http://monkey.org/~provos/libevent/
|
|
|
|
Some portions of Thrift also depend upon zlib, see:
|
|
http://www.zlib.net/
|
|
|
|
These libraries are open source and may be freely obtained, but they are not
|
|
provided as a part of this distribution.
|
|
|
|
Resources
|
|
=========
|
|
|
|
More information about Thrift can be obtained on the Thrift webpage at:
|
|
|
|
http://developers.facebook.com/thrift
|
|
|
|
Acknowledgments
|
|
===============
|
|
|
|
Thrift was inspired by pillar, a lightweight RPC tool written by Adam D'Angelo.
|
|
|
|
Installation
|
|
============
|
|
|
|
If you are building from the first time out of the source repository, you will
|
|
need to generate the configure scripts. (This is not necessary if you
|
|
downloaded a tarball.) From the top directory, do:
|
|
|
|
./bootstrap.sh
|
|
|
|
Once the configure scripts are generated, thrift can be configured.
|
|
From the top directory, do:
|
|
|
|
./configure
|
|
|
|
You may need to specify the location of the boost files explicitly.
|
|
If you installed boost in /usr/local, you would run configure as follows:
|
|
|
|
./configure --with-boost=/usr/local
|
|
|
|
Note that by default the thrift C++ library is typically built with debugging
|
|
symbols included. If you want to customize these options you should use the
|
|
CXXFLAGS option in configure, as such:
|
|
|
|
./configure CXXFLAGS='-g -O2'
|
|
./configure CFLAGS='-g -O2'
|
|
./configure CPPFLAGS='-DDEBUG_MY_FEATURE'
|
|
|
|
Run ./configure --help to see other configuration options
|
|
|
|
Please be aware that the Python library will ignore the --prefix option
|
|
and just install wherever Python's distutils puts it (usually along
|
|
the lines of /usr/lib/pythonX.Y/site-packages/). If you need to control
|
|
where the Python modules are installed, set the PY_PREFIX variable.
|
|
(DESTDIR is respected for Python and C++.)
|
|
|
|
Make thrift:
|
|
|
|
make
|
|
|
|
From the top directory, become superuser and do:
|
|
|
|
make install
|
|
|
|
Note that some language packages must be installed manually using build tools
|
|
better suited to those languages (at the time of this writing, this applies
|
|
to Java, Ruby, PHP).
|
|
|
|
Look for the README file in the lib/<language>/ folder for more details on the
|
|
installation of each language library package.
|