plugin.h

plugin.h

#include <google/protobuf/compiler/plugin.h>
namespace google::protobuf::compiler

Front-end for protoc code generator plugins written in C++.

To implement a protoc plugin in C++, simply write an implementation of CodeGenerator, then create a main() function like:

int main(int argc, char* argv[[]]) {
  MyCodeGenerator generator;
  return google::protobuf::compiler::PluginMain(argc, argv, &generator);
}

You must link your plugin against libprotobuf and libprotoc.

The core part of PluginMain is to invoke the given CodeGenerator on a CodeGeneratorRequest to generate a CodeGeneratorResponse. This part is abstracted out and made into function GenerateCode so that it can be reused, for example, to implement a variant of PluginMain that does some preprocessing on the input CodeGeneratorRequest before feeding the request to the given code generator.

To get protoc to use the plugin, do one of the following:

Classes in this file

File Members

These definitions are not part of any class.
int
PluginMain(int argc, char * argv, const CodeGenerator * generator)
Implements main() for a protoc plugin exposing the given code generator.
bool
GenerateCode(const CodeGeneratorRequest & request, const CodeGenerator & generator, CodeGeneratorResponse * response, std::string * error_msg)
Generates code using the given code generator. more...

bool compiler::GenerateCode(
        const CodeGeneratorRequest & request,
        const CodeGenerator & generator,
        CodeGeneratorResponse * response,
        std::string * error_msg)

Generates code using the given code generator.

Returns true if the code generation is successful. If the code generation fails, error_msg may be populated to describe the failure cause.