Merge pull request #26 from matttproud/fix_rebase_build_system_agains…

…t_thrift_stable

Fix rebase build system against thrift stable

README.md

@@ -0,0 +1,96 @@
+The contents of this repository were originally incorporated into Apache Thrift
+as of version 0.7 or commit revision 1072478.*  However, unfortunately upstream
+development ceased and necessitated continued development here; thusly, these
+files have been rebased against Thrift revision 1362341 at
+http://svn.apache.org/repos/asf/thrift/tags/thrift-0.8.0.
+
+This project will continued to be maintained for any further developments for
+Thrift for Go as needed (e.g., Go Version 1 compatibility).
+
+Add this Git repository to your Thrift checkout.  It will overwrite a few files
+to add options for Go.
+
+Currently generates code for the following protocols:
+
+1. Binary Protocol (with test cases)
+2. Fast Binary Protocol (with test cases)
+3. Standard Thrift JSON Protocol (with test cases)
+4. A (custom) simple JSON Protocol (with test cases)
+5. Services (compiles and runs against Java, assumed to work elsewhere)
+
+Tested on Mac OS X 10.6 (Snow Leopard) and Linux ca. 2010 derivatives.
+
+To install locally, perform the following:
+  ```go get github.com/pomack/thrift4go/lib/go/thrift```
+
+5 files for thrift compiler (last tested on July 18, 2012):
+
+1. ```configure.ac```
+2. ```lib/Makefile.am```
+3. ```lib/go/Makefile.am```
+4. ```compiler/cpp/Makefile.am```
+5. ```compiler/cpp/src/generate/t_go_generator.cc```
+
+A tutorial has been created in the thrift4go/tutorial/go/src directory.
+
+To use this tutorial, run the following:
+    ```thrift -r --gen go <thrift_src_dir>/tutorial/tutorial.thrift```
+Build the files in the ```gen-go``` directory using ```go install``` as
+appropriate.
+Build the files in the ```<thrift_src_dir>/tutorial/go``` directory with
+```go install``` as appropriate.
+Run the server from ```<thrift_src_dir>/tutorial/go/TutorialServerClient``` and
+run the client from either
+```<thrift_src_dir>/tutorial/go/TutorialServerClient``` or
+```gen-go/tutorial/Calculator/Calculator-remote```.
+
+Make sure you specify the same protocol for both the server and client.
+
+# Basic Walkthrough
+
+```thrift --gen go <thrift_src_dir>/test/ThriftTest.thrift```
+
+This will create ```gen-go/thrift/test/*.go``` and associated files/directories.
+
+- ```gen-go/thrift/test/ThriftTest.go``` shows a service and client base
+implementation with the associated interfaces and the ability to send/receive
+or serialize/deserialize as necessary.
+
+- ThriftTestClient is a client library designed to access the ThriftTest
+service.  No changes would need to be made here.
+
+- A ```ThriftTest/ThriftTest-remote.go``` and associated Makefile is also made
+available so you can access a remote service implementing the ThriftTest
+interface and see how the client side works under the covers.  The command-line
+arguments use the custom JSON parser, so you can just pass in JSON strings as
+arguments when you need to populate a struct, which I find better than any
+other alternative.
+
+- ThriftTestProcessor implements the server side and you would want to implement
+the server handlers using ```NewThriftTestProcessor()```.
+
+- You just pass in your handler that implements the ```IThriftTest``` interface
+and make sure you import the appropriate package.  Package directories/names
+are shown in the relevant Makefile.
+
+- One unique thing about Go is that to have a publicly available
+function/variable, the first letter has to be capitalized, so all exportable
+functions/variables have the first letter capitalized, but since the Thrift
+files normally don't, they assume any serialization uses the capitalization
+found in the Thrift interface definition file itself.
+
+# Areas for Future Assistance
+
+- Providing qualification tests that automatically build against Thrift stable
+as well as HEAD.
+
+- Improving idiomaticness of generated Thrift.
+
+- Generating Go interface code that would comply with ```gofmt``` tool.
+
+# Continuous Integration
+
+[![Build Status](https://secure.travis-ci.org/pomack/thrift4go.png?branch=master)](http://travis-ci.org/pomack/thrift4go)
+
+
+[*] - See https://issues.apache.org/jira/browse/THRIFT-625.