Yilun Chong 6d29c22a43 fix conformance test for text format		6 lat temu
..
third_party	e479410564 delete all duplicate empty blanks (#5758)	6 lat temu
ConformanceJava.java	429d2ae19f Merge branch 'master' into integration	6 lat temu
ConformanceJavaLite.java	3808d091f8 Fix spelling in strings and comments	9 lat temu
Makefile.am	d8c2501b43 down integration from internal	6 lat temu
README.md	afe98de32a Replace repo links.	7 lat temu
autoload.php	bcda919cee Fix php well known type conformance tests (#3828)	8 lat temu
binary_json_conformance_main.cc	cecba296b8 Down-integrate internal changes (#5467)	6 lat temu
binary_json_conformance_suite.cc	d8c2501b43 down integration from internal	6 lat temu
binary_json_conformance_suite.h	cecba296b8 Down-integrate internal changes (#5467)	6 lat temu
conformance.proto	a2a0afb546 Down-integrate internal changes to github. (#5575)	6 lat temu
conformance_cpp.cc	cb95a7f6a8 Down-integrate internal changes to github. (#5566)	6 lat temu
conformance_nodejs.js	6d29c22a43 fix conformance test for text format	6 lat temu
conformance_objc.m	0c95791509 [ObjC] add support for the TextFormat constants.	6 lat temu
conformance_php.php	6d29c22a43 fix conformance test for text format	6 lat temu
conformance_python.py	d8c2501b43 down integration from internal	6 lat temu
conformance_ruby.rb	6d29c22a43 fix conformance test for text format	6 lat temu
conformance_test.cc	d8c2501b43 down integration from internal	6 lat temu
conformance_test.h	d8c2501b43 down integration from internal	6 lat temu
conformance_test_main.cc	d8c2501b43 down integration from internal	6 lat temu
conformance_test_runner.cc	d8c2501b43 down integration from internal	6 lat temu
failure_list_cpp.txt	0adb74c2d3 Down-integrate internal changes to github. (#5555)	6 lat temu
failure_list_csharp.txt	6bbe197e9c Down-integrate from google3.	7 lat temu
failure_list_java.txt	6bbe197e9c Down-integrate from google3.	7 lat temu
failure_list_js.txt	188755c065 Fix JS conformance tests	8 lat temu
failure_list_objc.txt	ecc0f54127 Properly error on a tag with field number zero.	8 lat temu
failure_list_php.txt	bcda919cee Fix php well known type conformance tests (#3828)	8 lat temu
failure_list_php_c.txt	a21caa237a Default values should also be serialized for json map key/value (#5643)	6 lat temu
failure_list_php_zts_c.txt	ecca6ea95d Add json encode/decode for php. (#3226)	8 lat temu
failure_list_python-post26.txt	6bbe197e9c Down-integrate from google3.	7 lat temu
failure_list_python.txt	d8c2501b43 down integration from internal	6 lat temu
failure_list_python_cpp.txt	d8c2501b43 down integration from internal	6 lat temu
failure_list_ruby.txt	37a0ab7d83 Fix Any json encoding/decoding for ruby. (#5592)	6 lat temu
failure_list_ruby_mac.txt	aa5c12e882 Revert "Revert "Enable the ignore_unknown_field option in the Ruby unmarshal options" (#5511)" (#5533)	6 lat temu
text_format_conformance_suite.cc	d8c2501b43 down integration from internal	6 lat temu
text_format_conformance_suite.h	d8c2501b43 down integration from internal	6 lat temu
update_failure_list.py	45483fd1c0 file() was removed in Python 3, use open() instead	8 lat temu

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

Running the tests for C++

To run the tests against the C++ implementation, run:

$ cd conformance && make test_cpp

Running the tests for JavaScript (Node.js)

To run the JavaScript tests against Node.js, make sure you have "node" on your path and then run:

$ cd conformance && make test_nodejs

Running the tests for Ruby (MRI)

To run the Ruby tests against MRI, first build the C extension:

$ cd ruby && rake

Then run the tests like so:

$ cd conformance && make test_ruby

Running the tests for other languages

Most of the languages in the Protobuf source tree are set up to run conformance tests. However some of them are more tricky to set up properly. See tests.sh in the base of the repository to see how Travis runs the tests.

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).

README.md