grpcmock-go vs protoc-gen-doc

grpcmock-go is a free, MIT-licensed Go module providing gRPC testing utilities. It helps tests mock gRPC servers, configure expectations for methods, headers, and payloads, and invoke client calls. Supported methods include unary, client-streaming, server-streaming, and bidirectional-streaming patterns. Request matching can use exact values, regular expressions, JSON, or custom matchers. Mock responses may return payloads, errors, or custom-handler results, and streaming client invocations can use custom handlers. Services can be registered from generated Go code, service instances, or individual methods when generated code is unavailable. The project recommends MockServerWithBufConn for in-memory application testing, with examples using bufconn listeners and context dialers. Installation uses `go get go.nhat.io/grpcmock`, and Go 1.25 or later is required. GitHub lists v0.34.0, released December 12, 2025, as the latest release. The Open-source Go module plan costs nothing.

protoc-gen-doc is a documentation generator plugin for the Google Protocol Buffers compiler. It turns comments in .proto files into HTML, JSON, DocBook, or Markdown documentation, covering files, messages, fields, services and methods, enums and values, and extensions. It supports proto2 and proto3, including both in the same context. You can exclude files with path patterns and omit comments marked with the @exclude prefix. The plugin runs through protoc with the --doc_out and --doc_opt options; its source_relative flag places generated output in the same relative directory as the input. For customization, users can supply a Go template or use a stylesheet.css file to change HTML appearance. Installation options include Go, prebuilt releases, a Docker image, and a Maven Central package. It runs on Linux, macOS, and Windows and is self-hosted. The project is free under the MIT License, which allows use, modification, distribution, sublicensing, and sale under its terms. The license provides the software as is, without warranty.