THRIFT-2497 server and client for test/go, also several fixes and improvements
Client: Go
Patch: Aleksey Pesternikov

This closes #109

commit f2e7186ca8d63f407dba0c56ee51afd6405926ba
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-22T12:48:14Z

add _ to generated filename if it ends with _test.go

commit a6ed88196fbf4622a3b0261bbac0fe6b258bdd36
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-22T14:19:13Z

use tcxx instead of tr1 in test/cpp

commit d1848fa05f4baefc66eb405f4b1a8657bb2869bd
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-23T01:01:03Z

Merge branch 'master' of https://github.com/apache/thrift into go_integration

commit 04d22fef228d3f868b32a296a38f99ff52ee2142
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T00:34:24Z

additions:
 test for client/server with several protocol/transport/ssl combinations
 bin/testclient and bin/testserver
 debug_transport

fixes:
 separate Listen() and AcceptLoop() instead of Serve() in SimpleServer
 if handler function returns any unknown exception, handler closes connection

commit ed88d57d977cffea9fac8f61143801f3097ef46c
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T13:29:54Z

Generate lowercase package name
 lowercased pkg name in thrift files
 underline() -> lowercase()

commit 498a910c6c6753a4b1e3633eb5c9c82be33e8c7b
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T13:32:26Z

Merge branch 'master' into go_test_service_name

commit 25792d7218a2c32ee3c2077f65ca7d0cea7f31f5
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-22T12:48:14Z

add _ to generated filename if it ends with _test.go

commit af994b415308a2e174d57a03675fc83d7cbd43d1
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T00:34:24Z

additions:
 test for client/server with several protocol/transport/ssl combinations
 bin/testclient and bin/testserver
 debug_transport

fixes:
 separate Listen() and AcceptLoop() instead of Serve() in SimpleServer
 if handler function returns any unknown exception, handler closes connection

commit f22a777a5d5b4d93a8d7981e7aadc2c63919518a
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T13:44:08Z

Merge branch 'go_integration' of github.com:apesternikov/thrift into go_integration

commit 49a33c8c80ea35f923ee9aa3577780fcf41fe840
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T13:49:05Z

Merge branch 'master' into test_cpp_on_mac

commit 81b402ec6301f6b132c9b346ad5481f55f0aff89
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T13:56:56Z

operator < for ThriftTest

commit cde312d940d12077274dd0ba677ca850b5b439a7
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T14:12:58Z

minor formatting

commit 0a693115c2c20a2a8375f3859ff7bed261e6c8da
 Author: Aleksey Pesternikov <ap@alekseys-mbp.att.net>
 Date: 2014-04-25T14:13:20Z

Merge branch 'test_cpp_on_mac' into go_integration

commit e06b5d24e8b6d429723a3c77a58c6ce903e1366a
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T15:19:20Z

Merge branch 'go_test_service_name' into go_integration

commit 42d577c9812a070060c773fcd0598e58e6d6ba61
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T15:39:57Z

imported THRIFT-2491
 lowercase package names

commit 491ccf8b018c046c5ced72b1e19d9ac4ec48a6f5
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T15:51:53Z

--noinsane flag for c++ TestClient. works with go server now for other default params

commit 78db3c9a3a5742818a5de6e57f2fe9aed84919e5
 Author: Aleksey Pesternikov <ap@alekseys-macbook-pro.local>
 Date: 2014-04-25T16:03:23Z

license
16 files changed
tree: abe6885e38df797de5002be7daf56916e990dfec
  1. aclocal/
  2. compiler/
  3. contrib/
  4. debian/
  5. doc/
  6. lib/
  7. test/
  8. tutorial/
  9. .gitignore
  10. .travis.yml
  11. bootstrap.sh
  12. bower.json
  13. CHANGES
  14. cleanup.sh
  15. composer.json
  16. configure.ac
  17. doap.rdf
  18. LICENSE
  19. Makefile.am
  20. NOTICE
  21. rat_exclude
  22. README.md
  23. sonar-project.properties
README.md

Apache Thrift

Last Modified: 2014-03-16

License

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

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.md files in your particular subdirectory of interest.

Hierarchy

thrift/

compiler/ Contains the Thrift compiler, implemented in C++.

lib/ Contains the Thrift software library implementation, subdivided by language of implementation.

cpp/
go/
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

See http://wiki.apache.org/thrift/ThriftRequirements for an up-to-date list of build requirements.

Resources

More information about Thrift can be obtained on the Thrift webpage at:

 http://thrift.apache.org

Acknowledgments

Thrift was inspired by pillar, a lightweight RPC tool written by Adam D'Angelo, and also by Google's protocol buffers.

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.md file in the lib// folder for more details on the installation of each language library package.

Testing

There are a large number of client library tests that can all be run from the top-level directory.

      make -k check

This will make all of the libraries (as necessary), and run through the unit tests defined in each of the client libraries. If a single language fails, the make check will continue on and provide a synopsis at the end.

To run the cross-language test suite, please run:

      make cross

This will run a set of tests that use different language clients and servers.