Need help with erlang_protobuffs?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ngerakines
129 Stars 38 Forks 80 Commits 8 Opened issues

Description

A set of Protocol Buffers tools and modules for Erlang applications.

Services available

!
?

Need anything else?

Contributors list

# 47,388
Erlang
Go
Activit...
Shell
21 commits
# 39,599
Erlang
trojans
anti-vi...
Elixir
6 commits
# 121,574
Ruby
Shell
Erlang
markdow...
1 commit

README

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).
<<8,1>>
2> erlang:iolist_to_binary([
    protobuffs:encode(1, <>, string),
    protobuffs:encode(2, 25, uint32)
]).
<<10,4,78,105,99,107,16,25>>

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, <>}, <<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").
ok
2> simple_pb:decode_person(<<10,4,78,105,99,107,18,13,77,111,...>>).
{person,<>,<>, <>,25}
3> simple_pb:encode_person({person, <>, <>,
    <>,25}).
<<10,4,78,105,99,107,18,13,77,111,117,110,116,97,105,110,32,86,105,...>>

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

CAVEATS

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.

nodebuginfo

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

CREDITS

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.