diff options
author | Chris Fallin <cfallin@c1f.net> | 2014-11-18 14:19:58 -0800 |
---|---|---|
committer | Chris Fallin <cfallin@c1f.net> | 2014-12-09 16:55:59 -0800 |
commit | 973f425725f1cc18211992792f2aed83d3d73831 (patch) | |
tree | da0022d2cbe3a0700c02765a02e1be5a8b0c4f30 /ruby/README.md | |
parent | a0d9c59a7604139401cab78a27542b23f5724c19 (diff) | |
download | protobuf-973f425725f1cc18211992792f2aed83d3d73831.tar.gz protobuf-973f425725f1cc18211992792f2aed83d3d73831.tar.bz2 protobuf-973f425725f1cc18211992792f2aed83d3d73831.zip |
Provide a Ruby extension.
This adds a Ruby extension in ruby/ that is based on the 'upb' library
(now included as a submodule), and adds support for Ruby code generation
to the protoc compiler.
Diffstat (limited to 'ruby/README.md')
-rw-r--r-- | ruby/README.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/ruby/README.md b/ruby/README.md new file mode 100644 index 00000000..c966a103 --- /dev/null +++ b/ruby/README.md @@ -0,0 +1,34 @@ +This directory contains the Ruby extension that implements Protocol Buffers +functionality in Ruby. + +The Ruby extension makes use of generated Ruby code that defines message and +enum types in a Ruby DSL. You may write definitions in this DSL directly, but +we recommend using protoc's Ruby generation support with .proto files. The +build process in this directory only installs the extension; you need to +install protoc as well to have Ruby code generation functionality. + +Installation +------------ + +To build this Ruby extension, you will need: + +* Rake +* Bundler +* Ruby development headers +* a C compiler +* the upb submodule + +First, ensure that upb/ is checked out: + + $ cd .. # top level protobuf directory + $ git submodule init + $ git submodule update + +Then install the required Ruby gems: + + $ sudo gem install bundler rake rake-compiler rspec rubygems-tasks + +Then build the Gem: + + $ rake gem + $ gem install pkg/protobuf-$VERSION.gem |