Skip to content

Latest commit

 

History

History
50 lines (34 loc) · 1.99 KB

README.md

File metadata and controls

50 lines (34 loc) · 1.99 KB
Raw

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:

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