buf.gen.yaml

version: v2
managed:
  enabled: true
  override:
      - file_option: go_package
        module: buf.build/bufbuild/protovalidate
        value: github.com/bufbuild/protovalidate-go

plugins:
  # Use protoc-gen-go latest
  - remote: buf.build/protocolbuffers/go
    out: api
    opt: paths=source_relative
  # Use the latest version of protoc-gen-go-grpc
  - remote: buf.build/grpc/go
    out: api
    opt:
      - paths=source_relative
      - require_unimplemented_servers=false

  # Use the latest version of protoc-gen-validate
  - remote:  buf.build/bufbuild/validate-go
    out: api
    opt:
      - paths=source_relative


  # gen openapi for docs.
  - remote: buf.build/community/google-gnostic-openapi
    out: docs
    opt:
      - paths=source_relative
      - naming=proto
 # gen swagger format api docs
#  - remote: buf.build/grpc-ecosystem/openapiv2
#    out: docs

  # gen html format for docs
  - remote: buf.build/community/pseudomuto-doc
    out: docs
    opt:
      - html,docs.html
    #  - markdown,docs.md

  # this plugin will be installed via kratos upgrade.so use as local
  - local: protoc-gen-go-http
    out: api
    opt:
      - paths=source_relative
      # supported other parameter
      #  omit if google.api is empty,default:true
      #- omitempty=false
      # if google.api is empty,use this prefix,default:""
      # - omitempty_prefix=/v1
 # this plugin will be installed via kratos upgrade
  - local: protoc-gen-go-errors
    out: api
    opt:
      - paths=source_relative

# ====================================================
#       other purpose plugins.for more plugins,visit
#        https://buf.build/plugins
# ====================================================
  # to generate optimized marshalling & unmarshalling code you can use the plugin,
  # but conflict with default protoc-gen-go plugin

#  - remote: buf.build/community/planetscale-vtprotobuf
#    out: api
#    opt:
#      - paths=source_relative

  # gRPC to JSON proxy generator following the gRPC HTTP spec.
#  - remote: buf.build/grpc-ecosystem/gateway
#    out: gen
#    opt:
#      - paths=source_relative