google-proto-files

What is google-proto-files?

The google-proto-files npm package provides access to Google's Protocol Buffers (protobuf) files. These files define the structure of data used by Google's APIs and services. By using this package, developers can easily integrate with Google's APIs by leveraging the predefined protobuf files.

What are google-proto-files's main functionalities?

Accessing Google Protobuf Files

This feature allows you to access the path to Google's protobuf files. The code sample demonstrates how to require the google-proto-files package and retrieve the path to a specific protobuf file, in this case, 'timestamp.proto'.

const protoFiles = require('google-proto-files');
const path = protoFiles('google/protobuf/timestamp.proto');
console.log(path);

Integrating with Google APIs

This feature demonstrates how to integrate with Google APIs using the protobuf files provided by google-proto-files. The code sample shows how to load the 'cloud_speech.proto' file and create a gRPC client for the Google Cloud Speech API.

const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');
const protoFiles = require('google-proto-files');

const packageDefinition = protoLoader.loadSync(protoFiles('google/cloud/speech/v1/cloud_speech.proto'), {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true
});
const speechProto = grpc.loadPackageDefinition(packageDefinition).google.cloud.speech.v1;

const client = new speechProto.SpeechClient({
  // Client configuration
});

console.log(client);

Other packages similar to google-proto-files

@grpc/proto-loader

The @grpc/proto-loader package is used to load .proto files for use with gRPC in Node.js. It provides similar functionality to google-proto-files in terms of loading protobuf files, but it does not specifically provide access to Google's predefined protobuf files. Instead, it is a more general-purpose loader for any .proto files.

protobufjs

The protobufjs package is a comprehensive library for working with Protocol Buffers in JavaScript. It allows you to define, encode, decode, and verify protobuf messages. While it does not provide direct access to Google's protobuf files, it offers a wide range of features for working with protobufs in general.

README

Google APIs Proto Files: Node.js Client

All of the Google API's protocol buffer files

• Google APIs Proto Files Node.js Client API Reference

• github.com/googleapis/nodejs-proto-files

Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.

Table of contents:

• Quickstart

  • Installing the client library

• Versioning

• Contributing

• License

Quickstart

Installing the client library

npm install google-proto-files

Using the API

const protoFiles = require('google-proto-files')

Get a directory path by executing as a function

protoFiles('logging', 'v2')
// node_modules/google-proto-files/google/logging/v2

Get a path to the entry proto file for a specific API version

protoFiles.pubsub.v1
// node_modules/google-proto-files/google/pubsub/v1/pubsub.proto

load|loadSync(fileName, [options])

options

Load a proto which depends on google common protos.

Asynchronously

protoFiles.load('path/to/file.proto').then(function(root) {
  const MyService = root.lookup('example.MyService')
})

Synchronously

const root = protoFiles.loadSync('path/to/file.proto');
const MyService = root.lookup('example.MyService');

The Google APIs Proto Files Node.js Client API Reference documentation also contains samples.

Versioning

This library follows Semantic Versioning.

This library is considered to be General Availability (GA). This means it is stable; the code surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against GA libraries are addressed with the highest priority.

More Information: Google Cloud Platform Launch Stages

Contributing

Contributions welcome! See the Contributing Guide.

License

Apache Version 2.0

See LICENSE

Changelog

1.0.2 (2019-06-14)

Bug Fixes

• docs: move to new client docs URL (#203) (324bbad)