This Repository was created to share the code snippets shown during the talk Contract Testing - How do you tame an external API that constantly breaks your tests? at WeAreDevelopers 2023. It contains automatic API tests using the karate framework. They are meant to be run against the sample api at https://fakestoreapi.com/.
To run the tests use mvn:
mvn test
You can also just run specific subsets of tests such as only the status validation:
mvn test -Dkarate.options=src/test/java/store/Validate/Level1/validateStatus.feature
To setup a mock server, you need to download the karate jar file from the Karate Repo. The jar files are listed under the Assets section.
To create a mock server, execute the following command:
java -jar <Path_to_jar> -m <Path_to_mock> -p <Port_number>
E.g:
java -jar karate-1.4.0.jar -m src/test/java/Simulate/products.feature -p 8081
You can also pass multiple feature files for the mock server:
java -jar karate-1.4.0.jar -m src/test/java/Simulate/products.feature -m src/test/java/Simulate/users.feature -p 8081
Once the mock is running, testing against it is as simple as telling the mvn command to use the mock environment. This environment is configured to look for the mock at localhost port 8081 :
mvn test -Dkarate.env=mock
You can configure the environments differently by changing the values in karate-config.js