Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tomjankes/wiremock-groovy
groovy bindings for wiremock
https://github.com/tomjankes/wiremock-groovy
Last synced: about 2 months ago
JSON representation
groovy bindings for wiremock
- Host: GitHub
- URL: https://github.com/tomjankes/wiremock-groovy
- Owner: tomjankes
- License: apache-2.0
- Created: 2015-02-17T23:29:37.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-04-28T08:55:17.000Z (over 1 year ago)
- Last Synced: 2024-06-08T18:39:47.737Z (3 months ago)
- Language: Groovy
- Size: 124 KB
- Stars: 43
- Watchers: 4
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - tomjankes/wiremock-groovy - groovy bindings for wiremock (Groovy)
README
# Wiremock groovy
[](https://travis-ci.org/tomjankes/wiremock-groovy) [](https://maven-badges.herokuapp.com/maven-central/com.github.tomjankes/wiremock-groovy)
## What it is
I love [WireMock](https://github.com/tomakehurst/wiremock) and use it extensively in integration tests. I also love how [Spock](https://github.com/spockframework/spock) allows to write very readable and clean tests.
This project aims to create more suitable groovy API, that will allow more concise stubbing and verifying syntax in integration tests written in groovy/spock using WireMock, without using WireMock's default static imports API.
## What it does
Currently there is only extremely thin wrapper for Wire Mock REST API, that is exposed as raw json builder.
Examples of what can be currently achieved:
### Stubbing
```groovy
@Rule
WireMockRule wireMockRule = new WireMockRule()
def wireMockStub = new WireMockGroovy()
def "some integration test that tests feature using external REST resource" () {
given:
wireMockStub.stub {
request {
method "GET"
url "/some/thing"
}
response {
status 200
body "Some body"
headers {
"Content-Type" "text/plain"
}
}
}
...
}
```
### Verifying
Verifying can be achieved by querying for count of matching requests that have been sent to WireMock server.
```groovy
@Rule
WireMockRule wireMockRule = new WireMockRule()
def wireMockStub = new WireMockGroovy()
def "example verifying test" () {
...
then:
1 == wireMockStub.count {
method "GET"
url "/some/url"
}
}
def "test using groovy truth if you need at least one request and shows example matcher" () {
...
then:
wireMockStub.count {
method "POST"
url "/some/url"
headers {
"Content-Type" {
matches ".*xml"
}
}
}
}
```
##Contribution
Project is in very early stage, pull requests and ideas in form of feature requests are welcome.
## Building
* Clone the repository
* Run `./gradlew clean build` (on Linux/Mac) or `gradlew.bat build` (on Windows)
## Licence
Apache Licence v2.0 (see LICENCE.txt)