Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A set of Protocol Buffers tools and modules for Erlang applications.
Erlang Perl
Branch: master
Failed to load latest commit information.
doc remove makefiles and move overview.edoc
fw-pkgin Fixed unit test paths, and added framewerk generated files to .gitign…
scripts adding eqc test for decode_many
src Left in some commented out code
support did this wrong the first time, adding back flag
tests Minor issue with renaming breaking a test
AUTHORS add the rest of the erlrc integration
ChangeLog Adding nested types. add the rest of the erlrc integration
README.markdown removing no_debug_info
bootstrap add the rest of the erlrc integration add the rest of the erlrc integration



This module is a composite of other open source modules and original code to make interfacing with the Protocol Buffers protocol easy.

Encode / Decode

Encoding is simple.

1> protobuffs:encode(1, 1, uint32).
2> erlang:iolist_to_binary([
    protobuffs:encode(1, <<"Nick">>, string),
    protobuffs:encode(2, 25, uint32)

Decoding is simple too.

1> protobuffs:decode(<<8, 1>>, uint32).
{{1, 1}, <<>>}
2> protobuffs:decode(<<10,4,78,105,99,107,16,25>>, bytes).
{{1, <<"Nick">>}, <<16,25>>}
3> protobuffs:decode(<<16,25>>, bytes).
{{2, 25}, <<>>}

Using .proto Files

The main objective of this module is to allow developers to use .proto files easily. This module provides very basic functionality to do so.

Consider the t/simple.proto file.

message Person {
    required string name = 1;
    required string address = 2;
    required string phone_number = 3;
    required int32 age = 4;

From that file we can create an Erlang module that can encode and decode the Person message into records.

1> protobuffs_compile:scan_file("simple.proto").
2> simple_pb:decode_person(<<10,4,78,105,99,107,18,13,77,111,...>>).
{person,<<"Nick">>,<<"Mountain View">>, <<"+1 (000) 555-1234">>,25}
3> simple_pb:encode_person({person, <<"Nick">>, <<"Mountain View">>,
    <<"+1 (000) 555-1234">>,25}).

How cool is that? From .proto files, we create modules that export encode and decode functions for the messages defined.


Support for parsing proto files and creating code from it is volatile and should be considered alpha software at best. It currently only supports flat messages, simple types (ints, strings, etc) and will break on ENUM types and any sort of nesting. Please do not use this in production.


The protobuffs_compile module relies on the pokemon_pb module being compiled with debug info. This is because pokemon_pb serves as a template for generated _pb modules. Running protobuffs_compile:scan_file/1 reads the erlang forms from the pokemon_pb.beam file and expands and alters those forms to create the generated module.


Some of the protobuffs.erl module came from code written by Brian Buchanan.

Some of the protobuffs_compile.erl module came from code written by Tim Fletcher.

The rest of it and it's test suite was written by Nick Gerakines. Major contributions have been made by Jacob Vorreuter.

Something went wrong with that request. Please try again.