Mmock is a testing and fast prototyping tool for developers:
Easy and fast HTTP mock server.
- Download Mmock
- Create a mock definition.
- Configure your application endpoints to use Mmock
- Receive the expected responses
- Inspect the requests in the web UI
- Release it to a real server
Built with Go - Mmock runs without installation on multiple platforms.
- Easy mock definition via JSON
- Variables in response (fake or request data)
- Glob matching ( /a/b/* )
- Match request by method, URL params, headers, cookies and bodies.
- Mock definitions hot replace (edit your mocks without restart)
- Web interface to view requests data (method,path,headers,cookies,body,etc..)
- Fine grain log info in web interface
- Real-time updates using WebSockets
- Priority matching
- Crazy mode for failure testing
- Public interface auto discover
- Lightweight and portable
- No installation required
Mock definition file example:
{
"request": {
"method": "GET",
"path": "/hello/*"
},
"response": {
"statusCode": 200,
"headers": {
"Content-Type":["application/json"]
},
"body": "{\"hello\": \"{{request.query.name}}, my name is {{fake.FirstName}}\"}"
}
}
Either:
Run it from Docker using the provided Dockerfile
or from Docker Hub
go get github.com/jmartin82/mmock
docker build -t mmock/mmock .
docker run -v YOUR_ABS_PATH:/config -p 8082:8082 -p 8083:8083 mmock/mmock
Or run mmock locally from the command line.
go get github.com/jmartin82/mmock
mmock -h
To configure Mmock, use command line flags described in help.
Usage of ./mmock:
-cconsole-port int
Console server Port (default 8083)
-config-path string
Mocks definition folder (default "execution_path/config")
-console
Console enabled (true/false) (default true)
-console-ip string
Console Server IP (default "public_ip")
-server-ip string
Mock server IP (default "public_ip")
-server-port int
Mock Server Port (default 8082)
Mock definition:
{
"request": {
"method": "GET|POST|PUT|PATCH|...",
"path": "/your/path/*",
"queryStringParameters": {
"name": ["value"],
"name": ["value", "value"]
},
"headers": {
"name": ["value"]
},
"cookies": {
"name": "value"
},
"body": "Expected Body"
},
"response": {
"statusCode": "int (2xx,4xx,5xx,xxx)",
"headers": {
"name": ["value"]
},
"cookies": {
"name": "value"
},
"body": "Response body"
},
"control": {
"delay": "int (response delay in seconds)",
"crazy": "bool (return random 5xx)",
"priority": "int (matching priority)"
}
}
This mock definition section represents the expected input data. I the request data match with mock request section, the server will response the mock response data.
- method: Request http method. Mandatory
- path: Resource identifier. It allows * pattern. Mandatory
- queryStringParameters: Array of query strings. It allows more than one value for the same key.
- headers: Array of headers. It allows more than one value for the same key.
- cookies: Array of cookies.
- body: Body string. It allows * pattern.
To do a match with queryStringParameters, headers, cookies. All defined keys in mock will be present with the exact value.
- statusCode: Request http method.
- headers: Array of headers. It allows more than one value for the same key and vars.
- cookies: Array of cookies. It allows vars.
- body: Body string. It allows vars.
- delay: Delay the response in seconds. Simulate bad connection or bad server performance.
- crazy: Return random server errors (5xx) in some request. Simulate server problems.
- priority: Set the priority to avoid match in less restrictive mocks.
You can use variable data (random data or request data) in response. The variables will be defined as tags like this {{nameVar}}.
Request data:
- request.query."key"
- request.cookie."key"
Fake data:
- fake.Brand
- fake.Character
- fake.Characters
- fake.City
- fake.Color
- fake.Company
- fake.Continent
- fake.Country
- fake.CreditCardVisa
- fake.CreditCardMasterCard
- fake.CreditCardAmericanExpress
- fake.Currency
- fake.CurrencyCode
- fake.Day
- fake.Digits
- fake.EmailAddress
- fake.FirstName
- fake.FullName
- fake.LastName
- fake.Gender
- fake.IPv4
- fake.Language
- fake.Model
- fake.Month
- fake.Year
- fake.Paragraph
- fake.Paragraphs
- fake.Phone
- fake.Product
- fake.Sentence
- fake.Sentences
- fake.SimplePassword
- fake.State
- fake.StateAbbrev
- fake.Street
- fake.StreetAddress
- fake.UserName
- fake.WeekDay
- fake.Word
- fake.Words
- fake.Zip
Basic benchmark with ab (Apache HTTP server benchmarking tool)
Intel(R) Pentium(R) CPU 2127U @ 1.90GHz 350 Concurrent 20000 Request
ab -k -c 350 -n 20000 http:https://YOURIP:8083/
Server Software:
Server Hostname: 172.17.0.2
Server Port: 8083
Document Path: /
Document Length: 0 bytes
Concurrency Level: 350
Time taken for tests: 11.348 seconds
Complete requests: 20000
Failed requests: 0
Non-2xx responses: 20000
Keep-Alive requests: 20000
Total transferred: 2940000 bytes
HTML transferred: 0 bytes
Requests per second: 1762.49 [#/sec] (mean)
Time per request: 198.583 [ms] (mean)
Time per request: 0.567 [ms] (mean, across all concurrent requests)
Transfer rate: 253.01 [Kbytes/sec] received
Clone this repository to $GOPATH/src/github.com/jmartin82/mmock
and type go get .
.
Requires Go 1.4+ to build.
If you make any changes, run go fmt ./...
before submitting a pull request.
Copyright © 2016 - 2017, Jordi Martín (http:https://jordi.io)
Released under MIT license, see LICENSE for details.