Skip to content
SPECIFICTION
Get listed

gRPC CLI vs sabledocs

gRPC CLI

grpc.github.io

sabledocs

markvincze.github.io

Side by side

FiguregRPC CLIsabledocs
Price fromFreeFree
Free planYesYes
Free trial——
Open source——
WindowsYesYes
macOSYesYes
LinuxYesYes
Plans published11
Spec score · gRPC Tools8.1 (#5)7.8 (#14)
PrerequisiteMost commands need server reflection, though local proto files can be used as an alternative.The package requires Python 3.11 or higher, and the build process uses a binary descriptor generated with protoc.
PurposegRPC CLI is a command-line tool included in the gRPC repository for interacting with gRPC servers.Sabledocs is a static documentation generator for Protobuf and gRPC contracts.

Plans

gRPC CLI

  • gRPC CLIFree

gRPC CLI pricing →

sabledocs

  • SabledocsFree

sabledocs pricing →

In their own words

gRPC CLI

gRPC CLI is a free, open-source command-line tool in the gRPC repository for inspecting services and calling remote methods. It can send unary RPCs, attach metadata to requests, display metadata received from a server, and handle common server authentication. With server reflection, it can list services and methods; when reflection is unavailable, local proto files can supply service definitions and request or response types. Requests can be read in proto text or wire form. Responses can be displayed as text or written to a file in wire form. Streaming RPC support is described as a desired capability, not part of the documented core functionality. The tool runs on Linux, macOS, and Windows, but must be built from repository source. The documented process uses CMake and the `make grpc_cli` build target. Its documentation describes the tool as not yet up to par in user-friendliness and says grpcurl is better maintained in its current state. The gRPC repository identifies its license as Apache-2.0.

Visit grpc.github.io

sabledocs

Sabledocs is a free, open-source command-line generator for static HTML documentation of Protobuf and gRPC contracts. It can create one documentation site for multiple packages and combine material for Protobuf and gRPC. The input is a binary descriptor generated with protoc; comments require the descriptor to include source information. Search is enabled by default and can use a prebuilt Lunr index, while Markdown is supported in the main content page and Protobuf comments. Configuration in sabledocs.toml covers items such as titles, paths, package visibility, member ordering, and comment filtering. Jinja templates can be customized for primary content, and extra templates can be added to the output. Users can configure source links for Protobuf model members in GitHub, Bitbucket, Bitbucket Data Center, and GitLab repositories. The generator writes the site to sabledocs_output, where it can be opened through index.html. Sabledocs requires Python 3.11 or higher and is installed with pip install sabledocs. A Docker image includes both protoc and Sabledocs.

Visit markvincze.github.io