Sources

GripMock can load API definitions from different source types.

Supported source types

1) .proto files

Load one or multiple proto files directly:

gripmock service.proto
gripmock api/service1.proto api/service2.proto

2) Compiled descriptors (.pb, .protoset)

Load precompiled FileDescriptorSet files:

gripmock service.pb
gripmock api.protoset

This is useful for reproducible CI runs and dependency-free runtime startup.

3) Directory with mixed sources

Load all supported files recursively from a directory:

gripmock ./proto

GripMock will process .proto, .pb, and .protoset files found under the directory.

4) Buf Schema Registry (BSR)

Load API definitions directly from a BSR module:

gripmock --stub ./stubs buf.build/connectrpc/eliza

For private/on-prem usage and refs, see BSR.

5) gRPC Reflection (grpc://, grpcs://)

Load API definitions from a live gRPC server via reflection:

gripmock grpc://localhost:50051
gripmock grpcs://api.company.local:443

For query parameters and TLS notes, see gRPC Reflection Source.