devizzent/codeception-mockserver-helper

Codeception helper to manage and verify MockServer expectations

1.1.1 2023-06-29 20:24 UTC

README

This library is a Module for Codeception which allows your tests interact with mock-server(v5) in an easy and intuitive way.

MockServer allows you to simulate http services in your testing/local environment and this helper allows you check all the request you have sent to mock server and manage the expectations of mockserver.

How to use it

//You can create expectations before call your application in a test
$I->createMockRequest('{"id": "elastic-get-entity-1", "httpRequest": {...}, "httpResponse": {...}}')
$I->createMockRequest('{"id": "elastic-get-entity-2", "httpRequest": {...}, "httpResponse": {...}}')
$I->createMockRequestFromJsonFile('/root/path/elastic-get-entity-3.json')
$I->sendGet('/applition/endpoint/1');
//After execute our application we can check our mocked HTTP communication
$I->seeMockRequestWasCalled('elastic-get-entity-1');
$I->seeMockRequestWasNotCalled('elastic-get-entity-2');
$I->seeAllRequestWereMatched();
$I->removeMockRequest("elastic-get-entity-2");
$I->removeAllMockRequest();

Installation

Install the latest version with

$ composer require devizzent/codeception-mockserver-helper --dev

Codeception Configuration

This helper isn't a codeception module, it can't be configured in the global codeception.yml only in the *.suite.yml configuration.

Go to your codeception suite configuration and add this module

modules:
  enabled:
    - DEVizzent\CodeceptionMockServerHelper\MockServerHelper:
        ##Mandatory field, mock server url
        url: 'http://mockserver:1080' 
        ## Optional field, [test, suite, never] allowed. Default: test
        cleanupBefore: 'test'
        ## Optional field, [enabled, disabled] allowed. Default: enabled
        notMatchedRequest: 'enabled' 
        ## Optional field, path of the expectations folder or file to load before test
        expectationsPath: '/absolute/expectations/path' 

cleanupBefore

This variable set the moment when we want to clean the mockserver logs in order to don't affect the other tests or suites. We recomend set this value in the default value.

  • 'test' will remove all logs before start any test making sure that you are not affected by request did in the previous test execution.
  • 'suite' will remove all logs before start a suite of tests.
  • 'never' will not remove your mock-server logs. It can generate confusion and failures in your tests, because if you check something was called X times, the number of times increase every time you run your tests. If you only check that a request was called, it could be called in the previous execution, but by error not in the current one.

notMatchedRequest

When this option is enabled, it creates an expectation with lowest priority which match all the request haven't matched our expectations, returning a 500 error with a message Request not matched by MockServer.

It allows us to validate all request our application do, are expected and we haven't change our communication with external services.

expectationsPath

Get the file or files in the path, and send the content to create expectations on mockserver.

About

Requirements

Codecetion-MockServer Helper needs at least php 7.4 or higher and codeception 4 or higher.

How to contribute

Create an issue describing the bug or the new feature, create your fork of this project and send your PR.

For using the dev environment you only need Docker, Docker-compose and Makefile.

Usage:
  make <target>

Targets:
  help                       Display this help
  install                    Install required software and initialize your local configuration
  up                         Start application containers and required services
  debug                      Start application containers and required services in debug mode
  down                       Stop application containers and required services
  test                       Execute all phpunit test
  composer-update            Run composer update
  composer-install           Run composer update

Author

Vicent Valls - vizzent@gmail.com - https://twitter.com/ViMalaBarrakahttps://www.youtube.com/@DEVizzent
See also the list of contributors who participated in this project.

License

Codecetion-MockServer Helper is licensed under the MIT License - see the LICENSE file for details