charlatan
This package provides the ability to configure and return fake HTTP responses from your Dio HTTP Client. This makes it easy to test the behavior of code that interacts with HTTP services without having to use mocks.
It consists of two components:
Charlatan- a class for configuring and providing fake HTTP responses based on HTTP method and URI template.CharlatanHttpClientAdapter- an implementation of Dio'sHttpClientAdapterthat returns responses from a configuredCharlataninstance.
Usage
Add charlatan to your pubspec.yaml's dev_dependencies:
# pubspec.yaml
dev_dependencies:
charlatan:
Configuring fake responses
Create an instance of Charlatan and call the corresponding configuration method for the HTTP method you want to map a request to.
You can configure fakes responses using a specific path or a URI template. You can also use the request object to customize your response.
final charlatan = Charlatan();
charlatan.whenPost('/users', (_) => { 'id': 1, 'bilbo' });
charlatan.whenGet('/users/{id}', (req) => { 'id': req.pathParameters['id'], 'name': 'bilbo' });
charlatan.whenPut('/users/{id}/profile', (_) => null, statusCode: 204);
charlatan.whenDelete('/users/{id}', (_) => null, statusCode: 204);
If you need to further customize the response, you can return a CharlatanHttpResponse.
charlatan.whenPost('/users', (req) {
final data = req.body as Map<String, Object?>? ?? {};
final name = data['name'] as String?;
if (name == null) {
return CharlatanHttpResponse(
statusCode: 422,
body: {
'errors': {
'name': ['cannot be blank'],
},
},
);
}
return CharlatanHttpResponse(
statusCode: 201,
body: { 'id': 1, 'name': name },
);
});
Building a fake HTTP client
Build the CharlatanHttpClientAdapter from the Charlatan instance and then assign it to your Dio instance's httpClientAdapter.
final charlatan = Charlatan();
// ... configure fake responses ...
final dio = Dio()..httpClientAdapter = charlatan.toFakeHttpClientAdapter();
Now make HTTP requests like your normally would and they will be routed through your configured fakes.
final result = await dio.get<Object?>('/users/1');
expect(result.data, {'id', 1, 'name': 'bilbo'});
FAQ
What happens if I make a request that doesn't match a configured fake response?
You get a helpful error message like this:
Unable to find matching fake http response definition for:
GET /blahhhh
Did you configure it?
The fake http response definitions configured were:
GET /users
POST /users
PUT /users
DELETE /users
How can I configure a fake response that relies upon the result of another fake request? e.g. a POST followed by a GET that can "read its own writes"
Check out the example directory.
3 Dec 15, 2022
9 Nov 5, 2022
46 Dec 13, 2022
531 Dec 23, 2022
2 Apr 16, 2022
2 Feb 27, 2022
94 Dec 7, 2022
23 Dec 28, 2022
13 Jul 17, 2022
1 Apr 21, 2022
40 Sep 27, 2022
38 Oct 23, 2021
9 Oct 29, 2022
5 Dec 25, 2022
3 May 20, 2022
12 Nov 3, 2022
46 Dec 19, 2021
11.2k Jan 3, 2023
6 Dec 29, 2021