Protobuf-templates NPM

Protobuf Templates

Generate TypeScript code from proto files.

This package uses the protobufjs library to auto-generate TypeScript or JavaScript code using handlebars templates.

The package doesn't rely on the protoc compiler and generates TypeScript code directly rather than inferring types from generated JavaScript code. This makes usage of the auto-generated code easier as it does not need to compile at the point of creation.

Example templates are included, but the user may specify their own custom templates if required.

Prerequisites

Node.js > v6.12.0, which includes npm.

Installation

$ npm install protobuf-templates

Usage in gulp

First, import this task into your gulpfile:

let protobuf = require("protobuf-templates");

Then pipe a stream of .proto files into the task and save the output:

gulp.task("protobuf-gen", () => {
    return gulp.src(protoFiles)
    .pipe(protobuf())
    .pipe(gulp.dest(distDir));
});

Options

The following options are available:

template                Specifies the template to use. Also accepts a path to a custom template

                        interface           Generate a typescript interface (default)

type                    The target language to use

                        typescript          Generate TypeScript code (default)
                        javascript          Generate JavaScript code

keepCase                Keeps field casing instead of converting to camel case