You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by ro...@apache.org on 2014/03/01 17:01:30 UTC

git commit: THRIFT-847 Test Framework harmonization across all languages README.md added Patch: Roger Meier

Repository: thrift
Updated Branches:
  refs/heads/master 3e4c51f5c -> f85fdd7a3


THRIFT-847 Test Framework harmonization across all languages
README.md added
Patch: Roger Meier


Project: http://git-wip-us.apache.org/repos/asf/thrift/repo
Commit: http://git-wip-us.apache.org/repos/asf/thrift/commit/f85fdd7a
Tree: http://git-wip-us.apache.org/repos/asf/thrift/tree/f85fdd7a
Diff: http://git-wip-us.apache.org/repos/asf/thrift/diff/f85fdd7a

Branch: refs/heads/master
Commit: f85fdd7a3af3255ea2464118930c10f582caf035
Parents: 3e4c51f
Author: Roger Meier <ro...@apache.org>
Authored: Sat Mar 1 17:00:46 2014 +0100
Committer: Roger Meier <ro...@apache.org>
Committed: Sat Mar 1 17:00:46 2014 +0100

----------------------------------------------------------------------
 test/README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/thrift/blob/f85fdd7a/test/README.md
----------------------------------------------------------------------
diff --git a/test/README.md b/test/README.md
new file mode 100755
index 0000000..dd27a42
--- /dev/null
+++ b/test/README.md
@@ -0,0 +1,52 @@
+# Apache Thrift - integration test suite
+
+This is the cross everything integration test suite for Apache Thrift.
+executed by
+
+    make cross
+
+at the moment, this starts the test.sh script which does the real cross test
+with different transports, protocols and languages.
+
+Unit tests for languages ar usually located under lib/<lang>/test/
+cross language tests acording to [ThriftTest.thrift](ThriftTest.thrift) shall be
+provided for every language including executables with the following command
+line interface for servers:
+
+    $ ./cpp/TestServer -h
+    Allowed options:
+      -h [ --help ]               produce help message
+      --port arg (=9090)          Port number to listen
+      --domain-socket arg         Unix Domain Socket (e.g. /tmp/ThriftTest.thrift)
+      --server-type arg (=simple) type of server, "simple", "thread-pool", 
+                                  "threaded", or "nonblocking"
+      --transport arg (=buffered) transport: buffered, framed, http
+      --protocol arg (=binary)    protocol: binary, compact, json
+      --ssl                       Encrypted Transport using SSL
+      --processor-events          processor-events
+      -n [ --workers ] arg (=4)   Number of thread pools workers. Only valid for 
+                              thread-pool server type
+
+and this for clients:
+
+    $ ./cpp/TestClient -h
+    Allowed options:
+      -h [ --help ]               produce help message
+      --host arg (=localhost)     Host to connect
+      --port arg (=9090)          Port number to connect
+      --domain-socket arg         Domain Socket (e.g. /tmp/ThriftTest.thrift), 
+                                  instead of host and port
+      --transport arg (=buffered) Transport: buffered, framed, http, evhttp
+      --protocol arg (=binary)    Protocol: binary, compact, json
+      --ssl                       Encrypted Transport using SSL
+      -n [ --testloops ] arg (=1) Number of Tests
+
+If you have executed the **make check** or **make cross** then you will be able to browse
+[gen-html/ThriftTest.html](gen-html/ThriftTest.html) with the test documentation.
+
+## SSL
+Test Keys and Certificates are provided in multiple formats under the following
+directory
+
+    test/keys
+