devizzent / codeception-mockserver-helper
Codeception helper to manage and verify MockServer expectations
Installs: 1 706
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 1
Forks: 0
Open Issues: 1
Requires
- php: 7.4.*||8.*
- codeception/codeception: 4.*||5.*
- guzzlehttp/guzzle: ^7.0
- jfcherng/php-diff: ^6.14
- phpunit/phpunit: ^8.5 || ^9.0 || ^10.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-24 02:18:17 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