znsio / specmatic-order-api-grpc-kotlin

Specmatic gRPC Sample

Specmatic Order API gRPC Sample

This sample project demonstrates Specmatic gRPC support which allows you to use your proto files for Contract Testing. Specmatic gRPC support can also help you use your proto files for service mocking, #nocode backward compatibility testing and more.

The specmatic-order-api-grpc-kotlin is a gRPC server application developed according to the following proto files, which can be found in the central contract repository:

• order.proto
• product.proto

The ContractTest class demonstrates how to use Specmatic to test specmatic-order-api-grpc-kotlin gRPC server app using the above proto files.

Requirements

• Java 17 or later

Project Setup

1. Clone the repository

   git clone https://github.com/znsio/specmatic-order-api-grpc-kotlin

2. Initialize and update the specmatic-order-contracts submodule

   git submodule update --init --recursive --remote

3. Enable automatic submodule updating when executing git pull

   git config submodule.recurse true

4. To run contract tests,

   1. Using gradle - ./gradlew clean test
   2. Using docker -
      • Run the application using ./gradlew bootRun
      • Run the tests

      docker run --network host -v "$(pwd)/specmatic.yaml:/usr/src/app/specmatic.yaml" -v "$(pwd)/build/reports/specmatic:/usr/src/app/build/reports/specmatic" -v "$PWD/src/test/resources/specmatic:/usr/src/app/examples" -e SPECMATIC_GENERATIVE_TESTS=true znsio/specmatic-grpc-trial test --port=9090 --host=host.docker.internal --examples=examples

5. In case you want to run just the gRPC server using Gradle you can execute

   ./gradlew bootRun