readme.md

Overview

grpc-ditto is grpc mocking server that can mock any grpc services by parsing corresponding proto file.

Usage example:

grpc-ditto --proto myprotodir --mocks jsonmocksdir

this command will run a server on port 51000 by default, parse all proto files in --proto directory, load all mocks from json files in --mocks directory and also expose grpc reflection service.

Mock format

• method is fully qualified grpc service method name
• matches_jsonpath supports JSONPath spec: https://goessner.net/articles/JsonPath/
• equal_to_json supports protobuf specific json format: https://developers.google.com/protocol-buffers/docs/proto3#json
• multiple body_patterns should all match in order for a request to match

[
  {
    "request": {
      "method": "/greet.Greeter/SayHello",
      "body_patterns": [
        {
          "matches_jsonpath": { "expression": "$.name", "eq": "Bob" }
        }
      ]
    },
    "response": {
      "body": { "message": "hello Bob" }
    }
  },
  {
    "request": {
      "method": "/greet.Greeter/SayHello",
      "body_patterns": [
        {
          "matches_jsonpath": { "expression": "$.name", "eq": "John" }
        }
      ]
    },
    "response": [
      {
        "status": {
          "code": "NOT_FOUND",
          "message": "user not found"
        }
      }
    ]
  }
]