History

Josh Haberman 78da66698b Changed Ruby to properly camelCase its JSON by default.		2016-02-18 10:50:14 -08:00
..
third_party/jsoncpp	Make conformance tests build for C++ and Java.	2015-12-16 13:38:10 -08:00
conformance_cpp.cc	Down-integrate from internal code base.	2015-12-11 17:10:28 -08:00
conformance_objc.m	Fix up the conformance tests	2016-01-05 16:31:40 -05:00
conformance_python.py	Remove all bare strings as exceptions.	2015-12-04 15:03:12 -08:00
conformance_ruby.rb	Changed Ruby to properly camelCase its JSON by default.	2016-02-18 10:50:14 -08:00
conformance_test_runner.cc	Allow conformance test runner to tolerate crashes, and re-enable conformance tests.	2016-01-11 16:15:46 -08:00
conformance_test.cc	Allow conformance test runner to tolerate crashes, and re-enable conformance tests.	2016-01-11 16:15:46 -08:00
conformance_test.h	Make conformance tests build for C++ and Java.	2015-12-16 13:38:10 -08:00
conformance.proto	Down-integrate from internal code base.	2015-12-11 17:10:28 -08:00
ConformanceJava.java	Down-integrate from internal code base.	2015-12-11 17:10:28 -08:00
failure_list_cpp.txt	Allow conformance test runner to tolerate crashes, and re-enable conformance tests.	2016-01-11 16:15:46 -08:00
failure_list_csharp.txt	Remove now-fixed conformance errors.	2016-01-15 14:43:17 +00:00
failure_list_java.txt	Allow conformance test runner to tolerate crashes, and re-enable conformance tests.	2016-01-11 16:15:46 -08:00
failure_list_objc.txt	Fix up the conformance tests	2016-01-05 16:31:40 -05:00
failure_list_python_cpp.txt	Fixed Python 3.x C++ build, and updated conformance failure lists.	2016-01-15 17:26:44 -08:00
failure_list_python-post26.txt	Updated C#'s failure list, and added missing file.	2016-01-11 16:15:46 -08:00
failure_list_python.txt	Fixed Python 3.x C++ build, and updated conformance failure lists.	2016-01-15 17:26:44 -08:00
failure_list_ruby.txt	Changed Ruby to properly camelCase its JSON by default.	2016-02-18 10:50:14 -08:00
Makefile.am	Fix tests broken by the Java directory change.	2016-01-14 14:29:51 -08:00
README.md	Added first version of conformance tests.	2015-04-08 13:14:10 -07:00

README.md

Protocol Buffers - Google's data interchange format

This directory contains conformance tests for testing completeness and correctness of Protocol Buffers implementations. These tests are designed to be easy to run against any Protocol Buffers implementation.

This directory contains the tester process conformance-test, which contains all of the tests themselves. Then separate programs written in whatever language you want to test communicate with the tester program over a pipe.

Before running any of these tests, make sure you run make in the base directory to build protoc, since all the tests depend on it.

$ make

Then to run the tests against the C++ implementation, run:

$ cd conformance && make test_cpp

More tests and languages will be added soon!

Testing other Protocol Buffer implementations

To run these tests against a new Protocol Buffers implementation, write a program in your language that uses the protobuf implementation you want to test. This program should implement the testing protocol defined in conformance.proto. This is designed to be as easy as possible: the C++ version is only 150 lines and is a good example for what this program should look like (see conformance_cpp.cc). The program only needs to be able to read from stdin and write to stdout.

Portability

Note that the test runner currently does not work on Windows. Patches to fix this are welcome! (But please get in touch first to settle on a general implementation strategy).