Skip to main content

simple_fetch 0.1.0 copy "simple_fetch: ^0.1.0" to clipboard
simple_fetch: ^0.1.0 copied to clipboard

Turn Dio responses into typed models. Works for JSON objects, lists, and nested payloads across current Flutter versions.

simple_fetch #

A wrapper around Dio that maps a response into a model in one call. It works for a single JSON object, a list, and nested payloads such as {"data": [...]}.

Any 2xx status is success. Pass successCodes to allow or require specific codes, including codes outside 2xx. An empty body becomes null, or an empty list from the list methods. Pass baseOptions or an existing Dio to set a base URL, headers, and timeouts. url is required.

Get started #

Install #

Add the simple_fetch package to your pubspec dependencies.

import 'package:simple_fetch/simple_fetch.dart';

final simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';

Very simple use #


  testGet()async{

      List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
        url: apiUrl,
        mapper: Todo.fromJson,
      );

  }

Examples #

Performing a GET request :


 /// Fetch an object and make it a model type
  void getOneDataItemFromEndpoint() async {
    SimpleFetch simpleFetch = SimpleFetch();

    String apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';

    try {
      Todo? productsData = await simpleFetch.get<Todo>(
        url: apiUrl,
        mapper: Todo.fromJson,
        // transformer: (transform) => transform['data'],
      );
      print(productsData?.toJson());
    } on SimpleError catch (exception) {
      print(exception.message);
    } catch (e) {}
  }


 /// Fetch a List of object and make it a model type

  void getDataFromEndpoint() async {

    SimpleFetch simpleFetch = SimpleFetch();

    String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';

    try {
      List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
        url: apiUrl,
        mapper: Todo.fromJson,
      );

      print(allProductsData.map((e) => e?.toJson()).toList());
    } on SimpleError catch (exception) {
      print(exception.message);
    } catch (e) {}
  }

Performing a POST request:


 /// If the response of your post request is a single item
  void postSingleResponse() async {
    SimpleFetch simpleFetch = SimpleFetch();

    String apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';

    try {
      Todo? productsData = await simpleFetch.post<Todo>(
        url: apiUrl,
        data: {'id': 1, 'name': 'hello'},
        mapper: Todo.fromJson,
        // transformer: (transform) => transform['data'],
      );
      print(productsData?.toJson());
    } on SimpleError catch (exception) {
      print(exception.message);
    } catch (e) {}
  }

 // If the response of your post request is a list of item

  void postMultipleResponse() async {

    SimpleFetch simpleFetch = SimpleFetch();

    String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';

    try {
      List<Todo?> allProductsData = await simpleFetch.postList<Todo>(
        url: apiUrl,
        data: {'id': 2, 'name': 'Hiiii'},
        mapper: Todo.fromJson,
      );

      print(allProductsData.map((e) => e?.toJson()).toList());
    } on SimpleError catch (exception) {
      print(exception.message);
    } catch (e) {}
  }

Performing multiple concurrent requests:

response = await Future.wait([request1, request2]);

Transformers #

By default the packages is designed for you to simply retrieve data that is a list or json Sometimes you may want to remove,add or filter the data that is received before making it an object The transformer parameter helps you achieve this

{
    "data":[
        {
            "userId": 1,
            "id": 1,
            "title": "delectus aut autem",
            "completed": false
        },
        {
            "userId": 2,
            "id": 2,
            "title": "User ovier vac",
            "completed": true
        },
    ]
}

In this case you may want to return an list so you can do

    try {
      List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
        url: apiUrl,
        mapper: Todo.fromJson,
        transformer: (transform) => transform['data'],
      );

      print(allProductsData.map((e) => e?.toJson()).toList());
    } on SimpleError catch (exception) {
      print(exception.message);
    } catch (e) {}
4
likes
160
points
85
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Turn Dio responses into typed models. Works for JSON objects, lists, and nested payloads across current Flutter versions.

Repository (GitHub)
View/report issues

Topics

#dio #http #network #interceptor #middleware

License

MIT (license)

Dependencies

dio, flutter

More

Packages that depend on simple_fetch