// Protocol Buffers - Google's data interchange format // Copyright 2014 Google Inc. All rights reserved. // https://developers.google.com/protocol-buffers/ // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include #include #include "convert.h" #include "message.h" #include "protobuf.h" // ----------------------------------------------------------------------------- // Global map from upb {msg,enum}defs to wrapper Descriptor/EnumDescriptor // instances. // ----------------------------------------------------------------------------- static VALUE get_msgdef_obj(VALUE descriptor_pool, const upb_msgdef* def); static VALUE get_enumdef_obj(VALUE descriptor_pool, const upb_enumdef* def); static VALUE get_fielddef_obj(VALUE descriptor_pool, const upb_fielddef* def); static VALUE get_filedef_obj(VALUE descriptor_pool, const upb_filedef* def); static VALUE get_oneofdef_obj(VALUE descriptor_pool, const upb_oneofdef* def); // A distinct object that is not accessible from Ruby. We use this as a // constructor argument to enforce that certain objects cannot be created from // Ruby. VALUE c_only_cookie = Qnil; // ----------------------------------------------------------------------------- // Common utilities. // ----------------------------------------------------------------------------- static const char* get_str(VALUE str) { Check_Type(str, T_STRING); return RSTRING_PTR(str); } static VALUE rb_str_maybe_null(const char* s) { if (s == NULL) { s = ""; } return rb_str_new2(s); } // ----------------------------------------------------------------------------- // DescriptorPool. // ----------------------------------------------------------------------------- typedef struct { VALUE def_to_descriptor; // Hash table of def* -> Ruby descriptor. upb_symtab* symtab; } DescriptorPool; VALUE cDescriptorPool = Qnil; // Global singleton DescriptorPool. The user is free to create others, but this // is used by generated code. VALUE generated_pool = Qnil; static void DescriptorPool_mark(void* _self) { DescriptorPool* self = _self; rb_gc_mark(self->def_to_descriptor); } static void DescriptorPool_free(void* _self) { DescriptorPool* self = _self; upb_symtab_free(self->symtab); xfree(self); } static const rb_data_type_t DescriptorPool_type = { "Google::Protobuf::DescriptorPool", {DescriptorPool_mark, DescriptorPool_free, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static DescriptorPool* ruby_to_DescriptorPool(VALUE val) { DescriptorPool* ret; TypedData_Get_Struct(val, DescriptorPool, &DescriptorPool_type, ret); return ret; } // Exposed to other modules in defs.h. const upb_symtab *DescriptorPool_GetSymtab(VALUE desc_pool_rb) { DescriptorPool *pool = ruby_to_DescriptorPool(desc_pool_rb); return pool->symtab; } /* * call-seq: * DescriptorPool.new => pool * * Creates a new, empty, descriptor pool. */ static VALUE DescriptorPool_alloc(VALUE klass) { DescriptorPool* self = ALLOC(DescriptorPool); VALUE ret; self->def_to_descriptor = Qnil; ret = TypedData_Wrap_Struct(klass, &DescriptorPool_type, self); self->def_to_descriptor = rb_hash_new(); self->symtab = upb_symtab_new(); ObjectCache_Add(self->symtab, ret); return ret; } /* * call-seq: * DescriptorPool.add_serialized_file(serialized_file_proto) * * Adds the given serialized FileDescriptorProto to the pool. */ VALUE DescriptorPool_add_serialized_file(VALUE _self, VALUE serialized_file_proto) { DescriptorPool* self = ruby_to_DescriptorPool(_self); Check_Type(serialized_file_proto, T_STRING); VALUE arena_rb = Arena_new(); upb_arena *arena = Arena_get(arena_rb); google_protobuf_FileDescriptorProto* file_proto = google_protobuf_FileDescriptorProto_parse( RSTRING_PTR(serialized_file_proto), RSTRING_LEN(serialized_file_proto), arena); if (!file_proto) { rb_raise(rb_eArgError, "Unable to parse FileDescriptorProto"); } upb_status status; upb_status_clear(&status); const upb_filedef* filedef = upb_symtab_addfile(self->symtab, file_proto, &status); if (!filedef) { rb_raise(cTypeError, "Unable to build file to DescriptorPool: %s", upb_status_errmsg(&status)); } return get_filedef_obj(_self, filedef); } /* * call-seq: * DescriptorPool.lookup(name) => descriptor * * Finds a Descriptor or EnumDescriptor by name and returns it, or nil if none * exists with the given name. */ static VALUE DescriptorPool_lookup(VALUE _self, VALUE name) { DescriptorPool* self = ruby_to_DescriptorPool(_self); const char* name_str = get_str(name); const upb_msgdef* msgdef; const upb_enumdef* enumdef; msgdef = upb_symtab_lookupmsg(self->symtab, name_str); if (msgdef) { return get_msgdef_obj(_self, msgdef); } enumdef = upb_symtab_lookupenum(self->symtab, name_str); if (enumdef) { return get_enumdef_obj(_self, enumdef); } return Qnil; } /* * call-seq: * DescriptorPool.generated_pool => descriptor_pool * * Class method that returns the global DescriptorPool. This is a singleton into * which generated-code message and enum types are registered. The user may also * register types in this pool for convenience so that they do not have to hold * a reference to a private pool instance. */ static VALUE DescriptorPool_generated_pool(VALUE _self) { return generated_pool; } static void DescriptorPool_register(VALUE module) { VALUE klass = rb_define_class_under( module, "DescriptorPool", rb_cObject); rb_define_alloc_func(klass, DescriptorPool_alloc); rb_define_method(klass, "add_serialized_file", DescriptorPool_add_serialized_file, 1); rb_define_method(klass, "lookup", DescriptorPool_lookup, 1); rb_define_singleton_method(klass, "generated_pool", DescriptorPool_generated_pool, 0); rb_gc_register_address(&cDescriptorPool); cDescriptorPool = klass; rb_gc_register_address(&generated_pool); generated_pool = rb_class_new_instance(0, NULL, klass); } // ----------------------------------------------------------------------------- // Descriptor. // ----------------------------------------------------------------------------- typedef struct { const upb_msgdef* msgdef; VALUE klass; VALUE descriptor_pool; } Descriptor; VALUE cDescriptor = Qnil; static void Descriptor_mark(void* _self) { Descriptor* self = _self; rb_gc_mark(self->klass); rb_gc_mark(self->descriptor_pool); } static const rb_data_type_t Descriptor_type = { "Google::Protobuf::Descriptor", {Descriptor_mark, RUBY_DEFAULT_FREE, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static Descriptor* ruby_to_Descriptor(VALUE val) { Descriptor* ret; TypedData_Get_Struct(val, Descriptor, &Descriptor_type, ret); return ret; } /* * call-seq: * Descriptor.new => descriptor * * Creates a new, empty, message type descriptor. At a minimum, its name must be * set before it is added to a pool. It cannot be used to create messages until * it is added to a pool, after which it becomes immutable (as part of a * finalization process). */ static VALUE Descriptor_alloc(VALUE klass) { Descriptor* self = ALLOC(Descriptor); VALUE ret = TypedData_Wrap_Struct(klass, &Descriptor_type, self); self->msgdef = NULL; self->klass = Qnil; self->descriptor_pool = Qnil; return ret; } /* * call-seq: * Descriptor.new(c_only_cookie, ptr) => Descriptor * * Creates a descriptor wrapper object. May only be called from C. */ static VALUE Descriptor_initialize(VALUE _self, VALUE cookie, VALUE descriptor_pool, VALUE ptr) { Descriptor* self = ruby_to_Descriptor(_self); if (cookie != c_only_cookie) { rb_raise(rb_eRuntimeError, "Descriptor objects may not be created from Ruby."); } self->descriptor_pool = descriptor_pool; self->msgdef = (const upb_msgdef*)NUM2ULL(ptr); return Qnil; } /* * call-seq: * Descriptor.file_descriptor * * Returns the FileDescriptor object this message belongs to. */ static VALUE Descriptor_file_descriptor(VALUE _self) { Descriptor* self = ruby_to_Descriptor(_self); return get_filedef_obj(self->descriptor_pool, upb_msgdef_file(self->msgdef)); } /* * call-seq: * Descriptor.name => name * * Returns the name of this message type as a fully-qualified string (e.g., * My.Package.MessageType). */ static VALUE Descriptor_name(VALUE _self) { Descriptor* self = ruby_to_Descriptor(_self); return rb_str_maybe_null(upb_msgdef_fullname(self->msgdef)); } /* * call-seq: * Descriptor.each(&block) * * Iterates over fields in this message type, yielding to the block on each one. */ static VALUE Descriptor_each(VALUE _self) { Descriptor* self = ruby_to_Descriptor(_self); upb_msg_field_iter it; for (upb_msg_field_begin(&it, self->msgdef); !upb_msg_field_done(&it); upb_msg_field_next(&it)) { const upb_fielddef* field = upb_msg_iter_field(&it); VALUE obj = get_fielddef_obj(self->descriptor_pool, field); rb_yield(obj); } return Qnil; } /* * call-seq: * Descriptor.lookup(name) => FieldDescriptor * * Returns the field descriptor for the field with the given name, if present, * or nil if none. */ static VALUE Descriptor_lookup(VALUE _self, VALUE name) { Descriptor* self = ruby_to_Descriptor(_self); const char* s = get_str(name); const upb_fielddef* field = upb_msgdef_ntofz(self->msgdef, s); if (field == NULL) { return Qnil; } return get_fielddef_obj(self->descriptor_pool, field); } /* * call-seq: * Descriptor.each_oneof(&block) => nil * * Invokes the given block for each oneof in this message type, passing the * corresponding OneofDescriptor. */ static VALUE Descriptor_each_oneof(VALUE _self) { Descriptor* self = ruby_to_Descriptor(_self); upb_msg_oneof_iter it; for (upb_msg_oneof_begin(&it, self->msgdef); !upb_msg_oneof_done(&it); upb_msg_oneof_next(&it)) { const upb_oneofdef* oneof = upb_msg_iter_oneof(&it); VALUE obj = get_oneofdef_obj(self->descriptor_pool, oneof); rb_yield(obj); } return Qnil; } /* * call-seq: * Descriptor.lookup_oneof(name) => OneofDescriptor * * Returns the oneof descriptor for the oneof with the given name, if present, * or nil if none. */ static VALUE Descriptor_lookup_oneof(VALUE _self, VALUE name) { Descriptor* self = ruby_to_Descriptor(_self); const char* s = get_str(name); const upb_oneofdef* oneof = upb_msgdef_ntooz(self->msgdef, s); if (oneof == NULL) { return Qnil; } return get_oneofdef_obj(self->descriptor_pool, oneof); } /* * call-seq: * Descriptor.msgclass => message_klass * * Returns the Ruby class created for this message type. */ static VALUE Descriptor_msgclass(VALUE _self) { Descriptor* self = ruby_to_Descriptor(_self); if (self->klass == Qnil) { self->klass = build_class_from_descriptor(_self); } return self->klass; } static void Descriptor_register(VALUE module) { VALUE klass = rb_define_class_under( module, "Descriptor", rb_cObject); rb_define_alloc_func(klass, Descriptor_alloc); rb_define_method(klass, "initialize", Descriptor_initialize, 3); rb_define_method(klass, "each", Descriptor_each, 0); rb_define_method(klass, "lookup", Descriptor_lookup, 1); rb_define_method(klass, "each_oneof", Descriptor_each_oneof, 0); rb_define_method(klass, "lookup_oneof", Descriptor_lookup_oneof, 1); rb_define_method(klass, "msgclass", Descriptor_msgclass, 0); rb_define_method(klass, "name", Descriptor_name, 0); rb_define_method(klass, "file_descriptor", Descriptor_file_descriptor, 0); rb_include_module(klass, rb_mEnumerable); rb_gc_register_address(&cDescriptor); cDescriptor = klass; } // ----------------------------------------------------------------------------- // FileDescriptor. // ----------------------------------------------------------------------------- typedef struct { const upb_filedef* filedef; VALUE descriptor_pool; // Owns the upb_filedef. } FileDescriptor; static VALUE cFileDescriptor = Qnil; static void FileDescriptor_mark(void* _self) { FileDescriptor* self = _self; rb_gc_mark(self->descriptor_pool); } static const rb_data_type_t FileDescriptor_type = { "Google::Protobuf::FileDescriptor", {FileDescriptor_mark, RUBY_DEFAULT_FREE, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static FileDescriptor* ruby_to_FileDescriptor(VALUE val) { FileDescriptor* ret; TypedData_Get_Struct(val, FileDescriptor, &FileDescriptor_type, ret); return ret; } static VALUE FileDescriptor_alloc(VALUE klass) { FileDescriptor* self = ALLOC(FileDescriptor); VALUE ret = TypedData_Wrap_Struct(klass, &FileDescriptor_type, self); self->descriptor_pool = Qnil; self->filedef = NULL; return ret; } /* * call-seq: * FileDescriptor.new => file * * Returns a new file descriptor. The syntax must be set before it's passed * to a builder. */ static VALUE FileDescriptor_initialize(VALUE _self, VALUE cookie, VALUE descriptor_pool, VALUE ptr) { FileDescriptor* self = ruby_to_FileDescriptor(_self); if (cookie != c_only_cookie) { rb_raise(rb_eRuntimeError, "Descriptor objects may not be created from Ruby."); } self->descriptor_pool = descriptor_pool; self->filedef = (const upb_filedef*)NUM2ULL(ptr); return Qnil; } /* * call-seq: * FileDescriptor.name => name * * Returns the name of the file. */ static VALUE FileDescriptor_name(VALUE _self) { FileDescriptor* self = ruby_to_FileDescriptor(_self); const char* name = upb_filedef_name(self->filedef); return name == NULL ? Qnil : rb_str_new2(name); } /* * call-seq: * FileDescriptor.syntax => syntax * * Returns this file descriptors syntax. * * Valid syntax versions are: * :proto2 or :proto3. */ static VALUE FileDescriptor_syntax(VALUE _self) { FileDescriptor* self = ruby_to_FileDescriptor(_self); switch (upb_filedef_syntax(self->filedef)) { case UPB_SYNTAX_PROTO3: return ID2SYM(rb_intern("proto3")); case UPB_SYNTAX_PROTO2: return ID2SYM(rb_intern("proto2")); default: return Qnil; } } static void FileDescriptor_register(VALUE module) { VALUE klass = rb_define_class_under( module, "FileDescriptor", rb_cObject); rb_define_alloc_func(klass, FileDescriptor_alloc); rb_define_method(klass, "initialize", FileDescriptor_initialize, 3); rb_define_method(klass, "name", FileDescriptor_name, 0); rb_define_method(klass, "syntax", FileDescriptor_syntax, 0); rb_gc_register_address(&cFileDescriptor); cFileDescriptor = klass; } // ----------------------------------------------------------------------------- // FieldDescriptor. // ----------------------------------------------------------------------------- typedef struct { const upb_fielddef* fielddef; VALUE descriptor_pool; // Owns the upb_fielddef. } FieldDescriptor; static VALUE cFieldDescriptor = Qnil; static void FieldDescriptor_mark(void* _self) { FieldDescriptor* self = _self; rb_gc_mark(self->descriptor_pool); } static const rb_data_type_t FieldDescriptor_type = { "Google::Protobuf::FieldDescriptor", {FieldDescriptor_mark, RUBY_DEFAULT_FREE, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static FieldDescriptor* ruby_to_FieldDescriptor(VALUE val) { FieldDescriptor* ret; TypedData_Get_Struct(val, FieldDescriptor, &FieldDescriptor_type, ret); return ret; } /* * call-seq: * FieldDescriptor.new => field * * Returns a new field descriptor. Its name, type, etc. must be set before it is * added to a message type. */ static VALUE FieldDescriptor_alloc(VALUE klass) { FieldDescriptor* self = ALLOC(FieldDescriptor); VALUE ret = TypedData_Wrap_Struct(klass, &FieldDescriptor_type, self); self->fielddef = NULL; return ret; } /* * call-seq: * EnumDescriptor.new(c_only_cookie, pool, ptr) => EnumDescriptor * * Creates a descriptor wrapper object. May only be called from C. */ static VALUE FieldDescriptor_initialize(VALUE _self, VALUE cookie, VALUE descriptor_pool, VALUE ptr) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); if (cookie != c_only_cookie) { rb_raise(rb_eRuntimeError, "Descriptor objects may not be created from Ruby."); } self->descriptor_pool = descriptor_pool; self->fielddef = (const upb_fielddef*)NUM2ULL(ptr); return Qnil; } /* * call-seq: * FieldDescriptor.name => name * * Returns the name of this field. */ static VALUE FieldDescriptor_name(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); return rb_str_maybe_null(upb_fielddef_name(self->fielddef)); } // Non-static, exposed to other .c files. upb_fieldtype_t ruby_to_fieldtype(VALUE type) { if (TYPE(type) != T_SYMBOL) { rb_raise(rb_eArgError, "Expected symbol for field type."); } #define CONVERT(upb, ruby) \ if (SYM2ID(type) == rb_intern( # ruby )) { \ return UPB_TYPE_ ## upb; \ } CONVERT(FLOAT, float); CONVERT(DOUBLE, double); CONVERT(BOOL, bool); CONVERT(STRING, string); CONVERT(BYTES, bytes); CONVERT(MESSAGE, message); CONVERT(ENUM, enum); CONVERT(INT32, int32); CONVERT(INT64, int64); CONVERT(UINT32, uint32); CONVERT(UINT64, uint64); #undef CONVERT rb_raise(rb_eArgError, "Unknown field type."); return 0; } static VALUE descriptortype_to_ruby(upb_descriptortype_t type) { switch (type) { #define CONVERT(upb, ruby) \ case UPB_DESCRIPTOR_TYPE_ ## upb : return ID2SYM(rb_intern( # ruby )); CONVERT(FLOAT, float); CONVERT(DOUBLE, double); CONVERT(BOOL, bool); CONVERT(STRING, string); CONVERT(BYTES, bytes); CONVERT(MESSAGE, message); CONVERT(GROUP, group); CONVERT(ENUM, enum); CONVERT(INT32, int32); CONVERT(INT64, int64); CONVERT(UINT32, uint32); CONVERT(UINT64, uint64); CONVERT(SINT32, sint32); CONVERT(SINT64, sint64); CONVERT(FIXED32, fixed32); CONVERT(FIXED64, fixed64); CONVERT(SFIXED32, sfixed32); CONVERT(SFIXED64, sfixed64); #undef CONVERT } return Qnil; } /* * call-seq: * FieldDescriptor.type => type * * Returns this field's type, as a Ruby symbol, or nil if not yet set. * * Valid field types are: * :int32, :int64, :uint32, :uint64, :float, :double, :bool, :string, * :bytes, :message. */ static VALUE FieldDescriptor__type(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); return descriptortype_to_ruby(upb_fielddef_descriptortype(self->fielddef)); } /* * call-seq: * FieldDescriptor.default => default * * Returns this field's default, as a Ruby object, or nil if not yet set. */ static VALUE FieldDescriptor_default(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_fielddef *f = self->fielddef; upb_msgval default_val = {0}; if (upb_fielddef_issubmsg(f)) { return Qnil; } else if (!upb_fielddef_isseq(f)) { default_val = upb_fielddef_default(f); } return Convert_UpbToRuby(default_val, TypeInfo_get(self->fielddef), Qnil); } /* * call-seq: * FieldDescriptor.json_name => json_name * * Returns this field's json_name, as a Ruby string, or nil if not yet set. */ static VALUE FieldDescriptor_json_name(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_fielddef *f = self->fielddef; const char *json_name = upb_fielddef_jsonname(f); return rb_str_new2(json_name); } /* * call-seq: * FieldDescriptor.label => label * * Returns this field's label (i.e., plurality), as a Ruby symbol. * * Valid field labels are: * :optional, :repeated */ static VALUE FieldDescriptor_label(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); switch (upb_fielddef_label(self->fielddef)) { #define CONVERT(upb, ruby) \ case UPB_LABEL_ ## upb : return ID2SYM(rb_intern( # ruby )); CONVERT(OPTIONAL, optional); CONVERT(REQUIRED, required); CONVERT(REPEATED, repeated); #undef CONVERT } return Qnil; } /* * call-seq: * FieldDescriptor.number => number * * Returns the tag number for this field. */ static VALUE FieldDescriptor_number(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); return INT2NUM(upb_fielddef_number(self->fielddef)); } /* * call-seq: * FieldDescriptor.submsg_name => submsg_name * * Returns the name of the message or enum type corresponding to this field, if * it is a message or enum field (respectively), or nil otherwise. This type * name will be resolved within the context of the pool to which the containing * message type is added. */ static VALUE FieldDescriptor_submsg_name(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); switch (upb_fielddef_type(self->fielddef)) { case UPB_TYPE_ENUM: return rb_str_new2( upb_enumdef_fullname(upb_fielddef_enumsubdef(self->fielddef))); case UPB_TYPE_MESSAGE: return rb_str_new2( upb_msgdef_fullname(upb_fielddef_msgsubdef(self->fielddef))); default: return Qnil; } } /* * call-seq: * FieldDescriptor.subtype => message_or_enum_descriptor * * Returns the message or enum descriptor corresponding to this field's type if * it is a message or enum field, respectively, or nil otherwise. Cannot be * called *until* the containing message type is added to a pool (and thus * resolved). */ static VALUE FieldDescriptor_subtype(VALUE _self) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); switch (upb_fielddef_type(self->fielddef)) { case UPB_TYPE_ENUM: return get_enumdef_obj(self->descriptor_pool, upb_fielddef_enumsubdef(self->fielddef)); case UPB_TYPE_MESSAGE: return get_msgdef_obj(self->descriptor_pool, upb_fielddef_msgsubdef(self->fielddef)); default: return Qnil; } } /* * call-seq: * FieldDescriptor.get(message) => value * * Returns the value set for this field on the given message. Raises an * exception if message is of the wrong type. */ static VALUE FieldDescriptor_get(VALUE _self, VALUE msg_rb) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_msgdef *m; Message_Get(msg_rb, &m); if (m != upb_fielddef_containingtype(self->fielddef)) { rb_raise(cTypeError, "get method called on wrong message type"); } return Message_getfield(msg_rb, self->fielddef); } /* * call-seq: * FieldDescriptor.has?(message) => boolean * * Returns whether the value is set on the given message. Raises an * exception when calling for fields that do not have presence. */ static VALUE FieldDescriptor_has(VALUE _self, VALUE msg_rb) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_msgdef *m; const upb_msgdef *msg = Message_Get(msg_rb, &m); if (m != upb_fielddef_containingtype(self->fielddef)) { rb_raise(cTypeError, "has method called on wrong message type"); } else if (!upb_fielddef_haspresence(self->fielddef)) { rb_raise(rb_eArgError, "does not track presence"); } return upb_msg_has(msg, self->fielddef) ? Qtrue : Qfalse; } /* * call-seq: * FieldDescriptor.clear(message) * * Clears the field from the message if it's set. */ static VALUE FieldDescriptor_clear(VALUE _self, VALUE msg_rb) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_msgdef *m; upb_msgdef *msg = Message_GetMutable(msg_rb, &m); if (m != upb_fielddef_containingtype(self->fielddef)) { rb_raise(cTypeError, "has method called on wrong message type"); } upb_msg_clearfield(msg, self->fielddef); return Qnil; } /* * call-seq: * FieldDescriptor.set(message, value) * * Sets the value corresponding to this field to the given value on the given * message. Raises an exception if message is of the wrong type. Performs the * ordinary type-checks for field setting. */ static VALUE FieldDescriptor_set(VALUE _self, VALUE msg_rb, VALUE value) { FieldDescriptor* self = ruby_to_FieldDescriptor(_self); const upb_msgdef *m; upb_msgdef *msg = Message_GetMutable(msg_rb, &m); upb_arena *arena = Arena_get(Message_GetArena(msg_rb)); upb_msgval msgval; if (m != upb_fielddef_containingtype(self->fielddef)) { rb_raise(cTypeError, "set method called on wrong message type"); } msgval = Convert_RubyToUpb(value, upb_fielddef_name(self->fielddef), TypeInfo_get(self->fielddef), arena); upb_msg_set(msg, self->fielddef, msgval, arena); return Qnil; } static void FieldDescriptor_register(VALUE module) { VALUE klass = rb_define_class_under( module, "FieldDescriptor", rb_cObject); rb_define_alloc_func(klass, FieldDescriptor_alloc); rb_define_method(klass, "initialize", FieldDescriptor_initialize, 3); rb_define_method(klass, "name", FieldDescriptor_name, 0); rb_define_method(klass, "type", FieldDescriptor__type, 0); rb_define_method(klass, "default", FieldDescriptor_default, 0); rb_define_method(klass, "json_name", FieldDescriptor_json_name, 0); rb_define_method(klass, "label", FieldDescriptor_label, 0); rb_define_method(klass, "number", FieldDescriptor_number, 0); rb_define_method(klass, "submsg_name", FieldDescriptor_submsg_name, 0); rb_define_method(klass, "subtype", FieldDescriptor_subtype, 0); rb_define_method(klass, "has?", FieldDescriptor_has, 1); rb_define_method(klass, "clear", FieldDescriptor_clear, 1); rb_define_method(klass, "get", FieldDescriptor_get, 1); rb_define_method(klass, "set", FieldDescriptor_set, 2); rb_gc_register_address(&cFieldDescriptor); cFieldDescriptor = klass; } // ----------------------------------------------------------------------------- // OneofDescriptor. // ----------------------------------------------------------------------------- typedef struct { const upb_oneofdef* oneofdef; VALUE descriptor_pool; // Owns the upb_oneofdef. } OneofDescriptor; static VALUE cOneofDescriptor = Qnil; static void OneofDescriptor_mark(void* _self) { OneofDescriptor* self = _self; rb_gc_mark(self->descriptor_pool); } static const rb_data_type_t OneofDescriptor_type = { "Google::Protobuf::OneofDescriptor", {OneofDescriptor_mark, RUBY_DEFAULT_FREE, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static OneofDescriptor* ruby_to_OneofDescriptor(VALUE val) { OneofDescriptor* ret; TypedData_Get_Struct(val, OneofDescriptor, &OneofDescriptor_type, ret); return ret; } /* * call-seq: * OneofDescriptor.new => oneof_descriptor * * Creates a new, empty, oneof descriptor. The oneof may only be modified prior * to being added to a message descriptor which is subsequently added to a pool. */ static VALUE OneofDescriptor_alloc(VALUE klass) { OneofDescriptor* self = ALLOC(OneofDescriptor); VALUE ret = TypedData_Wrap_Struct(klass, &OneofDescriptor_type, self); self->oneofdef = NULL; self->descriptor_pool = Qnil; return ret; } /* * call-seq: * OneofDescriptor.new(c_only_cookie, pool, ptr) => OneofDescriptor * * Creates a descriptor wrapper object. May only be called from C. */ static VALUE OneofDescriptor_initialize(VALUE _self, VALUE cookie, VALUE descriptor_pool, VALUE ptr) { OneofDescriptor* self = ruby_to_OneofDescriptor(_self); if (cookie != c_only_cookie) { rb_raise(rb_eRuntimeError, "Descriptor objects may not be created from Ruby."); } self->descriptor_pool = descriptor_pool; self->oneofdef = (const upb_oneofdef*)NUM2ULL(ptr); return Qnil; } /* * call-seq: * OneofDescriptor.name => name * * Returns the name of this oneof. */ static VALUE OneofDescriptor_name(VALUE _self) { OneofDescriptor* self = ruby_to_OneofDescriptor(_self); return rb_str_maybe_null(upb_oneofdef_name(self->oneofdef)); } /* * call-seq: * OneofDescriptor.each(&block) => nil * * Iterates through fields in this oneof, yielding to the block on each one. */ static VALUE OneofDescriptor_each(VALUE _self) { OneofDescriptor* self = ruby_to_OneofDescriptor(_self); upb_oneof_iter it; for (upb_oneof_begin(&it, self->oneofdef); !upb_oneof_done(&it); upb_oneof_next(&it)) { const upb_fielddef* f = upb_oneof_iter_field(&it); VALUE obj = get_fielddef_obj(self->descriptor_pool, f); rb_yield(obj); } return Qnil; } static void OneofDescriptor_register(VALUE module) { VALUE klass = rb_define_class_under( module, "OneofDescriptor", rb_cObject); rb_define_alloc_func(klass, OneofDescriptor_alloc); rb_define_method(klass, "initialize", OneofDescriptor_initialize, 3); rb_define_method(klass, "name", OneofDescriptor_name, 0); rb_define_method(klass, "each", OneofDescriptor_each, 0); rb_include_module(klass, rb_mEnumerable); rb_gc_register_address(&cOneofDescriptor); cOneofDescriptor = klass; } // ----------------------------------------------------------------------------- // EnumDescriptor. // ----------------------------------------------------------------------------- typedef struct { const upb_enumdef* enumdef; VALUE module; // begins as nil VALUE descriptor_pool; // Owns the upb_enumdef. } EnumDescriptor; static VALUE cEnumDescriptor = Qnil; static void EnumDescriptor_mark(void* _self) { EnumDescriptor* self = _self; rb_gc_mark(self->module); rb_gc_mark(self->descriptor_pool); } static const rb_data_type_t EnumDescriptor_type = { "Google::Protobuf::EnumDescriptor", {EnumDescriptor_mark, RUBY_DEFAULT_FREE, NULL}, .flags = RUBY_TYPED_FREE_IMMEDIATELY, }; static EnumDescriptor* ruby_to_EnumDescriptor(VALUE val) { EnumDescriptor* ret; TypedData_Get_Struct(val, EnumDescriptor, &EnumDescriptor_type, ret); return ret; } static VALUE EnumDescriptor_alloc(VALUE klass) { EnumDescriptor* self = ALLOC(EnumDescriptor); VALUE ret = TypedData_Wrap_Struct(klass, &EnumDescriptor_type, self); self->enumdef = NULL; self->module = Qnil; self->descriptor_pool = Qnil; return ret; } // Exposed to other modules in defs.h. const upb_enumdef *EnumDescriptor_GetEnumDef(VALUE enum_desc_rb) { EnumDescriptor *desc = ruby_to_EnumDescriptor(enum_desc_rb); return desc->enumdef; } /* * call-seq: * EnumDescriptor.new(c_only_cookie, ptr) => EnumDescriptor * * Creates a descriptor wrapper object. May only be called from C. */ static VALUE EnumDescriptor_initialize(VALUE _self, VALUE cookie, VALUE descriptor_pool, VALUE ptr) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); if (cookie != c_only_cookie) { rb_raise(rb_eRuntimeError, "Descriptor objects may not be created from Ruby."); } self->descriptor_pool = descriptor_pool; self->enumdef = (const upb_enumdef*)NUM2ULL(ptr); return Qnil; } /* * call-seq: * EnumDescriptor.file_descriptor * * Returns the FileDescriptor object this enum belongs to. */ static VALUE EnumDescriptor_file_descriptor(VALUE _self) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); return get_filedef_obj(self->descriptor_pool, upb_enumdef_file(self->enumdef)); } /* * call-seq: * EnumDescriptor.name => name * * Returns the name of this enum type. */ static VALUE EnumDescriptor_name(VALUE _self) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); return rb_str_maybe_null(upb_enumdef_fullname(self->enumdef)); } /* * call-seq: * EnumDescriptor.lookup_name(name) => value * * Returns the numeric value corresponding to the given key name (as a Ruby * symbol), or nil if none. */ static VALUE EnumDescriptor_lookup_name(VALUE _self, VALUE name) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); const char* name_str= rb_id2name(SYM2ID(name)); int32_t val = 0; if (upb_enumdef_ntoiz(self->enumdef, name_str, &val)) { return INT2NUM(val); } else { return Qnil; } } /* * call-seq: * EnumDescriptor.lookup_value(name) => value * * Returns the key name (as a Ruby symbol) corresponding to the integer value, * or nil if none. */ static VALUE EnumDescriptor_lookup_value(VALUE _self, VALUE number) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); int32_t val = NUM2INT(number); const char* name = upb_enumdef_iton(self->enumdef, val); if (name != NULL) { return ID2SYM(rb_intern(name)); } else { return Qnil; } } /* * call-seq: * EnumDescriptor.each(&block) * * Iterates over key => value mappings in this enum's definition, yielding to * the block with (key, value) arguments for each one. */ static VALUE EnumDescriptor_each(VALUE _self) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); upb_enum_iter it; for (upb_enum_begin(&it, self->enumdef); !upb_enum_done(&it); upb_enum_next(&it)) { VALUE key = ID2SYM(rb_intern(upb_enum_iter_name(&it))); VALUE number = INT2NUM(upb_enum_iter_number(&it)); rb_yield_values(2, key, number); } return Qnil; } /* * call-seq: * EnumDescriptor.enummodule => module * * Returns the Ruby module corresponding to this enum type. */ static VALUE EnumDescriptor_enummodule(VALUE _self) { EnumDescriptor* self = ruby_to_EnumDescriptor(_self); if (self->module == Qnil) { self->module = build_module_from_enumdesc(_self); } return self->module; } static void EnumDescriptor_register(VALUE module) { VALUE klass = rb_define_class_under( module, "EnumDescriptor", rb_cObject); rb_define_alloc_func(klass, EnumDescriptor_alloc); rb_define_method(klass, "initialize", EnumDescriptor_initialize, 3); rb_define_method(klass, "name", EnumDescriptor_name, 0); rb_define_method(klass, "lookup_name", EnumDescriptor_lookup_name, 1); rb_define_method(klass, "lookup_value", EnumDescriptor_lookup_value, 1); rb_define_method(klass, "each", EnumDescriptor_each, 0); rb_define_method(klass, "enummodule", EnumDescriptor_enummodule, 0); rb_define_method(klass, "file_descriptor", EnumDescriptor_file_descriptor, 0); rb_include_module(klass, rb_mEnumerable); rb_gc_register_address(&cEnumDescriptor); cEnumDescriptor = klass; } static VALUE get_def_obj(VALUE _descriptor_pool, const void* ptr, VALUE klass) { DescriptorPool* descriptor_pool = ruby_to_DescriptorPool(_descriptor_pool); VALUE key = ULL2NUM((intptr_t)ptr); VALUE def; def = rb_hash_aref(descriptor_pool->def_to_descriptor, key); if (ptr == NULL) { return Qnil; } if (def == Qnil) { // Lazily create wrapper object. VALUE args[3] = { c_only_cookie, _descriptor_pool, key }; def = rb_class_new_instance(3, args, klass); rb_hash_aset(descriptor_pool->def_to_descriptor, key, def); } return def; } static VALUE get_msgdef_obj(VALUE descriptor_pool, const upb_msgdef* def) { return get_def_obj(descriptor_pool, def, cDescriptor); } static VALUE get_enumdef_obj(VALUE descriptor_pool, const upb_enumdef* def) { return get_def_obj(descriptor_pool, def, cEnumDescriptor); } static VALUE get_fielddef_obj(VALUE descriptor_pool, const upb_fielddef* def) { return get_def_obj(descriptor_pool, def, cFieldDescriptor); } static VALUE get_filedef_obj(VALUE descriptor_pool, const upb_filedef* def) { return get_def_obj(descriptor_pool, def, cFileDescriptor); } static VALUE get_oneofdef_obj(VALUE descriptor_pool, const upb_oneofdef* def) { return get_def_obj(descriptor_pool, def, cOneofDescriptor); } // ----------------------------------------------------------------------------- // Shared functions // ----------------------------------------------------------------------------- // Functions exposed to other modules in defs.h. VALUE Descriptor_DefToClass(const upb_msgdef *m) { const upb_symtab *symtab = upb_filedef_symtab(upb_msgdef_file(m)); VALUE pool = ObjectCache_Get(symtab); PBRUBY_ASSERT(pool != Qnil); VALUE desc_rb = get_msgdef_obj(pool, m); const Descriptor* desc = ruby_to_Descriptor(desc_rb); return desc->klass; } const upb_msgdef *Descriptor_GetMsgDef(VALUE desc_rb) { const Descriptor* desc = ruby_to_Descriptor(desc_rb); return desc->msgdef; } VALUE TypeInfo_InitArg(int argc, VALUE *argv, int skip_arg) { if (argc > skip_arg) { if (argc > 1 + skip_arg) { rb_raise(rb_eArgError, "Expected a maximum of %d arguments.", skip_arg + 1); } return argv[skip_arg]; } else { return Qnil; } } TypeInfo TypeInfo_FromClass(int argc, VALUE* argv, int skip_arg, VALUE* type_class, VALUE* init_arg) { TypeInfo ret = {ruby_to_fieldtype(argv[skip_arg])}; if (ret.type == UPB_TYPE_MESSAGE || ret.type == UPB_TYPE_ENUM) { *init_arg = TypeInfo_InitArg(argc, argv, skip_arg + 2); if (argc < 2 + skip_arg) { rb_raise(rb_eArgError, "Expected at least %d arguments for message/enum.", 2 + skip_arg); } VALUE klass = argv[1 + skip_arg]; VALUE desc = MessageOrEnum_GetDescriptor(klass); *type_class = klass; if (desc == Qnil) { rb_raise(rb_eArgError, "Type class has no descriptor. Please pass a " "class or enum as returned by the DescriptorPool."); } if (ret.type == UPB_TYPE_MESSAGE) { ret.def.msgdef = ruby_to_Descriptor(desc)->msgdef; Message_CheckClass(klass); } else { PBRUBY_ASSERT(ret.type == UPB_TYPE_ENUM); ret.def.enumdef = ruby_to_EnumDescriptor(desc)->enumdef; } } else { *init_arg = TypeInfo_InitArg(argc, argv, skip_arg + 1); } return ret; } void Defs_register(VALUE module) { DescriptorPool_register(module); Descriptor_register(module); FileDescriptor_register(module); FieldDescriptor_register(module); OneofDescriptor_register(module); EnumDescriptor_register(module); rb_gc_register_address(&c_only_cookie); c_only_cookie = rb_class_new_instance(0, NULL, rb_cObject); }