Moved from http://code.google.com/p/protobuf-json

Provide serialization and de-serialization of Google's protobuf Messages into/from JSON format. protobuf-json is written in python and depends on Google's protobuf compiler for python.

Using .proto file like this:

 message Person {
   required int32 id = 1;
   required string name = 2;
   optional string email = 3;
 }

You can encode and decode it to/from json:

 {
  "id": 123,
  "name": "person name",
  "email": "[email protected]"
 }

More complex example:

 message Book {
   required string title = 1;
   optional float price = 2;
   repeated Person authors = 3;
 }

 {
  "title": "Book example",
  "price": 12.7,
  "authors": [
   {
    "id": 123,
    "name": "person name",
    "email": "[email protected]"
   },
   {
    "id": 456,
    "name": "another person",
   }
  ]
 }

From version 2.3.0 protobuf protoc supports a plugin system for code generators. Plugins can generate code for new languages.

TODO: write JavaScript code generator