protoc-gen-doc Add oneOf support

In our proto files we use the oneof keyword and we have noticed that this is currently ignored in the generated outputs. Our documentation team would like to see oneof support added to the tool.

To generate oneOf support for the 0.96 release I had added the following QT code to the message generation (line 346 onwards)

// Add basic info.
field["field_name"] = QString::fromStdString(fieldDescriptor->name());
field["field_description"] = description;
field["field_label"] = labelName(fieldDescriptor->label());
field["field_default_value"] = defaultValue(fieldDescriptor);
if (fieldDescriptor->containing_oneof()){
    field["field_one_of"] = QString::fromStdString(fieldDescriptor->containing_oneof()->name());
    field["field_one_of_description"] = descriptionOf(fieldDescriptor->containing_oneof(), excluded);
}

Since then I see that the code has been ported to GO, and I have another have been working on adding the equivalent code to the 1.0.0 release.

Would you like to examine a PR for making this happen?

Jan 03 '18 15:01 jason-fox

Hey @jason-fox, I'd definitely be interested in a PR to add oneOf support!

Jan 08 '18 00:01 pseudomuto

I added my patches as base in the existing PR https://github.com/pseudomuto/protoc-gen-doc/pull/336 Didn't have time to do a proper PR and add tests. Sorry for that :(