pop_network

Description:

pop network

Popnetwork #
The pop_network library is an extension of the Dio HTTP client, designed to simplify HTTP requests and assist developers in making efficient use of REST APIs. It includes support for mocking responses using the http_mock_adapter library.
Installation #
Add the pop_network package to your pubspec.yaml file:
dependencies:
pop_network: ^1.0.0
copied to clipboard
Then run pub get to install the package.
Getting Started #
Simple Usage #
To get started with pop_network, create an instance of ApiManager with your desired configuration. Here's an example of a simple GET request:
import 'package:pop_network/pop_network.dart';

final _apiManager = ApiManager(
baseUrl: 'https://jsonplaceholder.typicode.com',
);

void getTodo() async {
final response = await _apiManager.get('/todos/1');
print(response);
}
copied to clipboard
Mocking Responses #
You can also use pop_network to mock responses for testing or development purposes. Provide a loadMockAsset function and use MockReplyParams to configure mock responses:
final _apiManager = ApiManager(
baseUrl: 'https://jsonplaceholder.typicode.com',
loadMockAsset: rootBundle.loadString, // default root folder for Flutter
);

await _apiManager.get(
'/todos/1',
mockReplyParams: MockReplyParams(
mockPath: 'todo_example',
delay: const Duration(seconds: 1),
status: HttpStatusEnum.ok,
),
);
copied to clipboard
Logging #
pop_network provides built-in logging support. You can configure it like this:
final _apiManager = ApiManager(
baseUrl: 'https://jsonplaceholder.typicode.com',
interceptors: [
PopNetworkLogInterceptor(
logPrint: (str) => developer.log(str.toString(), name: 'TODO_LOG'),
),
],
);
copied to clipboard
Caching Requests with PopCacheInterceptor #
The package includes a caching mechanism that allows you to cache HTTP responses for a specified duration. This feature is made possible with the PopCacheInterceptor and ICacheRequestData classes.
Create an instance of MemoryCacheRequestData, this class manages the cache storage in memory using a Map, or your own implementation of ICacheRequestData and use it to create an instance of PopCacheInterceptor.
final apiManager = ApiManager(
baseUrl: 'https://jsonplaceholder.typicode.com',
interceptors: [
PopCacheInterceptor(MemoryCacheRequestData()),
],
);
copied to clipboard
Using Cache in Requests
To enable caching for a specific request, you need to provide the cacheExpiresIn parameter in the request. This parameter specifies how long the response should be cached. Here's an example of using cache with a GET request:
final response = await apiManager.get(
'/todos',
cacheExpiresIn: Duration(minutes: 15), // Cache the response for 15 minutes
);
print(response.data);
copied to clipboard
Issues and Contributions #
If you encounter any issues or would like to contribute to this library, please visit the GitHub repository.