Skip to main content

Why Contract Testing Matters

Integration testing has an important role in the test pyramid, it aims to test the integrations of the software products in the integration environments. This means that the software should be built and deployed to an integration test environment and then run the test against the version in the testing environment. If anything wrong occurs as a regression issue then the CI gives feedback about the failures. As a result, the issue should be fixed and built and deployed to the integration test environment. Therefore this process is very expensive and is so late for the modern approach to SDLC, for the shift-left approach. As a solution to this problem, we should consider testing the integration isolatedly within the context of the software itself. Contract testing is an approach to testing the integration depending on the written contract during the build phase. In this post, I want to explain the importance of contract testing.

What is Contract

The contract is a document created by the consumers to list the required functionalities that are used by the consumers. Therefore, the consumer should create a contract for every change in the requirements then, it should be shared with the providers to follow the up-to-date contracts.

What is Contract Testing

Contract testing is testing the integrations of the applications in isolation so is complimentary to integration testing with some extra benefits. Contract testing has a very important role in the software development lifecycle as a good approach to making the integration testing shift left. The contract is a document created by the consumers to list the required functionalities that are used by the consumers. Therefore the contract should be created by the consumer for every change in the requirements then it should be shared with the providers to follow the up-to-date contracts. 

There is a misunderstanding about the contract test is rewriting the unit tests against a mock service. But in reality, it is not as simple as this definition since it is bi-directional and it checks the requirement as well as the implementation in build time. The following image also shows where is the contract test in the test matrix. The contract test is basically non-functional testing at the integration level. It is non-functional because we are not aiming to check logic or consumer flows, and also it is checking the integration of the services/APIs so it is an integration level testing. 



What is the Problem with Classical Integration Testing

An integration testing project is mostly a project that checks the integration of microservices/services/APIs with some libraries like rest-assured, requests, airbone, etc. Most of the time this project is contributed by the quality team by writing tests for each requirement as soon as the related requirements are turned into functionalities in the product. This is an asynchronous process which means development teams do their jobs and the quality team does their job separately. This causes isolation instead of integration. This is not only done by doing the job but also by running and reporting the results of the tests. 

Everyone will be happy until there is a failure in the result of the integration test run. When an error is caught, a hero should be chosen and take responsibility and start investigating the issue. There might have already been changes in the requirement or there is an intermittent issue, so this is most of the time a time-consuming job. Also, there will be job failures until the issue is fixed which will reduce the reliability of the integration test. 

Basically, these are the problems of the integration testing:
  • Flakiness
    • Data management for each MSs and APIs
    • Testing different MSs in the same test
  • Slow
    • Requires network
    • Data creation process
    • Network calls between MSs
  • Independent from Clients
    • Tests are not created by clients
    • Updates are not made by clients
    • Testing more general instead of the client's requirements

Popular posts for software testing and automation

Selenium Error "Element is not currently interactable and may not be manipulated"

Selenium webdriver can drive different browsers like as Firefox, Chrome or Internet Explorer. These browsers actually cover the majority of internet users, so testing these browsers possibly covers the 90% of the internet users. However, there is no guaranty that the same automation scripts can work without a failure on these three browsers. For this reason, automation code should be error-prone for the browsers you want to cover. The following error is caught when the test script run for Chrome and Internet Explorer, but surprisingly there is no error for the Firefox. Selenium gives an error like below: Traceback (most recent call last):   File "D:\workspace\sample_project\sample_run.py", line 10, in <module>     m.login()   File "D:\workspace\ sample_project \test_case_imps.py", line 335, in login     driver.find_element_by_id("id_username").clear()   File "C:\Python27\lib\site-packages\selenium-2.35.0-py2.7.egg\seleni...

Change Default Timeout and Wait Time of Capybara

One of the biggest challenge for automation is handling timeout problem. Most of the time, timeout is 60 seconds but it may sometimes not enough if you have badly designed asynchronous calls or the third party ajax calls. This makes handling timeout more complex. set large enough to tolerate network related problems. For Selenium based automation frameworks, like Capybara, default Webdriver timeout is set to Net::ReadTimeout (Net::ReadTimeout) Changing ReadTimeout If you have timeout problem for Capybara, it gives an error like above. This means that the page is not fully loaded in given timeout period. Even you can see that page is loaded correctly but webdriver wait until the Ajax calls finish. class BufferedIO #:nodoc: internal use only def initialize (io) @io = io @read_timeout = 60 @continue_timeout = nil @debug_output = nil @rbuf = '' end . . . . . def rbuf_fill beg...

Create an Alias for Interactive Console Work: Selenium and Capybara

If you are working on shell most of the time Aliases are very helpfull and time saving. For testing purposes you can use Alias for getting ready your test suites. In this post, I want to explain both running Selenium and Capybara on console and creating aliases for each.  This post is for Windows machines, if you are using Unix-like see   this post . Creating Scripts for Selenium and Capybara First of all, it is assumed that you have installed Selenium and Capybara correctly and they work on your machines. If you haven't installed, you can see my previous posts. I am using the Selenium with Python and the Capybara with Ruby. You can use several different language for Selenium but Capybara works only with Ruby.  Create scripts in a directory called scripts (in your home folder, like as  ~/scripts ) for your automation tool as following, save them as capybara.rb, sel.py :  Creating Aliases Depends on your favourite shell, you need to add the al...

Page-Object Pattern for Selenium Test Automation with Python

Page-object model is a pattern that you can apply it to develop efficient automation framework. With the page-model, it is possible to minimize maintenance cost. Basically page-object means that your every page is inherited from a base class which includes basic functionalities for every page. If you have some new functionalities that every page should have, you can simple add it to the base class. Base class is like the following: In this part we are creating pages which are inherited from base page. Every page has its own functionalities written as python functions. Some functions return to a new page, it means that these functions leave the current page and produce a new page. You should write as much as functions you need in the assertion part because this is the only part you can use the webdriver functions to interact with web pages . This part can be evaluate as providing data to assertion part.   The last part is related to...

Performance Testing on CI: Locust is running on Jenkins

For a successful Continuous Integration pipeline, there should be jobs for testing the performance of the application. It is necessary if the application is still performing well. Generally performance testing is thought as kinds of activities performed one step before going to live. In general approach it is true but don't forget to test your application's performance as soon as there is an testable software, such as an api end point, functions, and etc. For CI it is a good approach to testing performance after functional testing and just before the deployment of next stage. In this post, I want to share some info about Jenkins and Locust. In my previous post you can find some information about Locust and Jenkins. Jenkins operates the CI environment and Locust is a tool for performance testing. To run the Locust on Jenkins you need command line arguments which control the number of clients ,   hatch rate,  running locust without web interface and there s...