protoc-gen-fieldmask

KO | EN

gitlite — search

#javascript #python #ai #typescript #golang #android #machine-learning #rust #deep-learning #windows #awesome-list #pytorch #mcp #openai

protoc-gen-fieldmask

(★ 30)

A protoc plugin that generates fieldmask paths

protoc-gen-fieldmask 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# protoc-gen-fieldmask

[![CI](https://github.com/idodod/protoc-gen-fieldmask/actions/workflows/ci.yml/badge.svg)](https://github.com/idodod/protoc-gen-fieldmask/actions/workflows/ci.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/idodod/protoc-gen-fieldmask)](https://goreportcard.com/report/github.com/idodod/protoc-gen-fieldmask)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/idodod/protoc-gen-fieldmask)
![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/idodod/protoc-gen-fieldmask)
![GitHub](https://img.shields.io/github/license/idodod/protoc-gen-fieldmask)

A protoc plugin that generates fieldmask paths as static type properties for proto messages, which elimantes the usage of error-prone strings.

For example, given the following proto messages:

```proto

syntax = "proto3";

package example;

option go_package = "example/;example";

import "google/type/date.proto";

message Foo {
  string baz = 1;
  int32 xyz = 2;
  Bar my_bar = 3;
  google.type.Date some_date = 4;
}

message Bar {
  string some_field = 1;
  bool another_field = 2;
}
```

fieldmasks paths can be used as follows:

```golang
  foo := &example.Foo{}

// Prints "baz"
  fmt.Println(foo.FieldMaskPaths().Baz())
  
  // Prints "xyz"
  fmt.Println(foo.FieldMaskPaths().Xyz())

// Prints "my_bar"
  fmt.Println(foo.FieldMaskPaths().MyBar().String())

// Since baz is a nested message, we can print a nested path - "my_bar.some_field"
  fmt.Println(foo.FieldMaskPaths().MyBar().SomeField())

// Thirdparty messages work the same way:
  // Prints "some_date"
  fmt.Println(foo.FieldMaskPaths().SomeDate().String())

// Prints "some_date.year"
  fmt.Println(foo.FieldMaskPaths().SomeDate().Year())
```

## Usage

### Installation

The plugin can be downloaded from the [release page](https://github.com/idodod/protoc-gen-fieldmask/releases/latest), and should be ideally installed somewhere available in your `$PATH`.

### Executing the plugin

```sh
protoc --fieldmask_out=gen protos/example.proto

# If the plugin is not in your $PATH:
protoc --fieldmask_out=out_dir protos/example.proto --plugin=protoc-gen-fieldmask=/path/to/protoc-gen-fieldmask
```

### Parameters

The following parameters can be set by passing `--fieldmask_opt` to the command:

*   `maxdepth`: This option is relevant for a recursive message case.\
    Specify the max depth for which the paths will be pregenerated. If the path depth gets over the max value, it will be generated at runtime.
    default value is `7`.

## Features

*   Currently the only supported language is `go`.
*   All paths are pregenerated (except for recursive messages past `maxdepth`).
*   Support all type of fields including repeated fields, maps, oneofs, third parties, nested messages and recursive messages.

protoc-gen-fieldmask

protoc-gen-fieldmask 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

protoc-gen-fieldmask

protoc-gen-fieldmask 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README