@bufbuild/protoplugin

What is @bufbuild/protoplugin?

@bufbuild/protoplugin is a package designed to facilitate the creation of plugins for the Buf build system, which is used for working with Protocol Buffers (protobufs). It provides tools and utilities to help developers generate code and manage protobuf schemas more efficiently.

What are @bufbuild/protoplugin's main functionalities?

Code Generation

This feature allows you to generate code from protobuf files. You can specify the input protobuf file and the output directory where the generated code should be placed.

const { CodeGenerator } = require('@bufbuild/protoplugin');

const generator = new CodeGenerator();
generator.generate({
  protoFile: 'path/to/your.proto',
  outputDir: 'path/to/output',
  options: { /* generation options */ }
});

Schema Management

This feature helps in managing protobuf schemas. You can load a schema from a file and retrieve it for further processing or validation.

const { SchemaManager } = require('@bufbuild/protoplugin');

const manager = new SchemaManager();
manager.loadSchema('path/to/schema.proto');
const schema = manager.getSchema();
console.log(schema);

Plugin Development

This feature allows you to develop custom plugins for the Buf build system. You can extend the Plugin class and implement your own code generation logic.

const { Plugin } = require('@bufbuild/protoplugin');

class MyCustomPlugin extends Plugin {
  constructor() {
    super();
  }

  generateCode(request) {
    // Custom code generation logic
  }
}

const plugin = new MyCustomPlugin();
plugin.run();

Other packages similar to @bufbuild/protoplugin

protobufjs

protobufjs is a popular library for working with Protocol Buffers in JavaScript. It provides comprehensive support for parsing, serializing, and generating protobuf messages. Compared to @bufbuild/protoplugin, protobufjs is more focused on general protobuf operations rather than plugin development for the Buf build system.

grpc-tools

grpc-tools is a package that provides tools for working with gRPC and Protocol Buffers. It includes a code generator for creating gRPC service stubs and protobuf message classes. While grpc-tools is more focused on gRPC services, @bufbuild/protoplugin is tailored for creating plugins for the Buf build system.

protoc-gen-ts

protoc-gen-ts is a plugin for the Protocol Buffers compiler (protoc) that generates TypeScript code from .proto files. It is similar to @bufbuild/protoplugin in that it focuses on code generation, but it is specifically designed for TypeScript, whereas @bufbuild/protoplugin is more general-purpose and integrated with the Buf build system.

README

@bufbuild/protoplugin

This package helps to create your own code generator plugin.

Protocol Buffers for ECMAScript

A complete implementation of Protocol Buffers in TypeScript, suitable for web browsers and Node.js.
Learn more at github.com/bufbuild/protobuf-es.

It is a complete implementation of Protocol Buffers in TypeScript, suitable for web browsers and Node.js.

For example, the following definition:

message Person {
  string name = 1;
  int32 id = 2;  // Unique ID number for this person.
  string email = 3;
}

Is compiled to an ECMAScript class that can be used like this:

let pete = new Person({
  name: "pete",
  id: 123
});

let bytes = pete.toBinary();
pete = Person.fromBinary(bytes);
pete = Person.fromJsonString('{"name": "pete", "id": 123}');

Learn more at github.com/bufbuild/protobuf-es.