diff options
author | Chris Fallin <cfallin@c1f.net> | 2015-02-20 18:01:13 -0800 |
---|---|---|
committer | Chris Fallin <cfallin@c1f.net> | 2015-02-20 18:01:13 -0800 |
commit | 5d9cc7d1669a98e870de1aff06b3c1a81d982d61 (patch) | |
tree | 81ccc9d3c4723d2e0cdd1e86a0f8b7429fd79942 | |
parent | 32f5d0178c216a0f748edafa8bd31b2150aa6502 (diff) | |
parent | 6ad8f547fee97798c11b37f5e887d02b6f3c8a2a (diff) | |
download | protobuf-5d9cc7d1669a98e870de1aff06b3c1a81d982d61.tar.gz protobuf-5d9cc7d1669a98e870de1aff06b3c1a81d982d61.tar.bz2 protobuf-5d9cc7d1669a98e870de1aff06b3c1a81d982d61.zip |
Merge pull request #214 from cfallin/ruby-changelog
Updated CHANGES.txt to mention Ruby extension.
-rw-r--r-- | CHANGES.txt | 29 | ||||
-rw-r--r-- | ruby/README.md | 1 |
2 files changed, 27 insertions, 3 deletions
diff --git a/CHANGES.txt b/CHANGES.txt index 02c964cb..e0c02084 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -1,10 +1,35 @@ -2015-2-22 version 3.0.0-alpha-2 (Ruby/JavaNano): +2015-02-22 version 3.0.0-alpha-2 (Ruby/JavaNano): General * Introduced two new language implementations (Ruby and JavaNano) to proto3. * Various bug fixes since 3.0.0-alpha-1 Ruby: - TODO(cfallin): Add descriptions here. + We have added proto3 support for Ruby via a native C extension. + + The Ruby extension itself is included in the ruby/ directory, and details on + building and installing the extension are in ruby/README.md. The extension + will also be published as a Ruby gem. Code generator support is included as + part of `protoc` with the `--ruby_out` flag. + + The Ruby extension implements a user-friendly DSL to define message types + (also generated by the code generator from `.proto` files). Once a message + type is defined, the user may create instances of the message that behave in + ways idiomatic to Ruby. For example: + + - Message fields are present as ordinary Ruby properties (getter method + `foo` and setter method `foo=`). + - Repeated field elements are stored in a container that acts like a native + Ruby array, and map elements are stored in a container that acts like a + native Ruby hashmap. + - The usual well-known methods, such as `#to_s`, `#dup`, and the like, are + present. + + Unlike several existing third-party Ruby extensions for protobuf, this + extension is built on a "strongly-typed" philosophy: message fields and + array/map containers will throw exceptions eagerly when values of the + incorrect type are inserted. + + See ruby/README.md for details. JavaNano: JavaNano is a special code generator and runtime library designed especially diff --git a/ruby/README.md b/ruby/README.md index 88e9c0e1..59d5ace8 100644 --- a/ruby/README.md +++ b/ruby/README.md @@ -16,7 +16,6 @@ To build this Ruby extension, you will need: * Bundler * Ruby development headers * a C compiler -* the upb submodule First, install the required Ruby gems: |