proto-mock

proto-mock is a Node.js library that generates random data for given Protobuf message types.

Installation

npm install proto-mock

Usage

import { generateMockData } from 'proto-mock';

const mockData = await generateMockData('path/to/proto/file.proto', 'MyMessageType');
console.log(mockData);

generateMockData(protoFilePath: string, messageType: string, options?: GenerateMockDataOptions): Promise<any>

• protoFilePath - Required. The path to the Protobuf file.
• messageType - Required. The name of the message type.
• options - Optional. The settings for generating random data.
• keyValueRange - Optional parameter that specifies the value range for specific fields. Default is {} (empty object).

Return value: A Promise that asynchronously returns the generated random data.

GenerateMockDataOptions

• maxRepeatedLength - Optional. Specifies the maximum length of generated arrays. Defaults to 3.
• maxMapEntries - Optional. Specifies the maximum number of entries in generated maps. Defaults to 3.
• keepCase - Optional. Specifies whether to preserve the case of field names. Defaults to false (camel case).

Example

Suppose there is a person.proto file defining a Person message type:

syntax = "proto3";

package example;

message Person {
  string name = 1;
  int32 age = 2;
  repeated string email = 3;
}

Using proto-mock, random data can be generated for the Person type:

import { generateMockData } from 'proto-mock';

const mockData = await generateMockData('path/to/person.proto', 'Person');
console.log(mockData);
// Outputs randomly generated data similar to:
// {
//   name: 'Lola Hudson',
//   age: -12713,
//   email: [ '[email protected]', '[email protected]' ]
// }

By using keyValueRange, you can control the value range of specific fields to ensure that the generated random data meets your expectations.

import { generateMockData } from 'proto-mock';

const options = {
  keyValueRange: {
    name: ['Alice', 'Bob'],
    age: [18, 21, 30]
  }
};

const mockData = await generateMockData('path/to/person.proto', 'Person', options);
console.log(mockData);
// Outputs random data similar to the following:
// {
//   name: 'Alice',
//   age: 21,
//   email: [ '[email protected]', '[email protected]' ]
// }