network_request 0.1.1

A powerful and comprehensive Dart package for simplifying HTTP requests and interacting with RESTful APIs

A powerful and comprehensive Dart package for simplifying HTTP requests and interacting with RESTful APIs in Flutter and Dart applications. This package provides an organized and efficient way to handle all your networking needs, leveraging the robust http package for actual network calls. Experience streamlined API integration, enhanced debugging capabilities, and a developer-friendly approach to data fetching.

✨ Features

• 🚀 Easily set up and manage your API services and network layers.
• 🐞 Get detailed logs for both API requests and API responses. Essential for quick bug fixing and troubleshooting.
• 🐚 Get cURL commands for every network request for easy debugging and reproduction outside your application.
• 📦 Out-of-the-box support for common HTTP content types like application/json, text/plain, x-www-form-urlencoded, and multipart/form-data.
• 📶 Get download and upload progress in simple callbacks.

📝 Logging Feature

Best suited for JSON APIs. Get detailed logs for both requests and responses with a terminal-pastable cURL command for every request, enabling quick reproduction and testing outside your application. This feature significantly speeds up debugging and facilitates clear communication with your backend team.

🚀 Getting started

In your Dart/Flutter project add the following line to pubspec.yaml file

network_request:
    git: https://github.com/ZakaTiwana/network_request.git

Or from pub.dev use

network_request: 0.1.1

💡 Usage

The network_request package simplifies the process of making HTTP requests. Extend the NetworkRequest class and implement the required overrides to define your API manager.

1. Extending NetworkRequest

First, create a class that extends NetworkRequest. This class will serve as your API manager, where you configure base URLs, default headers, error decoders, and logging.

import 'package:network_request/network_request.dart';

class MockAPIManger extends NetworkRequest {
  @override
  String get baseUrl => 'https://jsonplaceholder.typicode.com'; // Example base URL

  @override
  Future<Map<String, String>> get defaultHeader async => {
        HttpHeaders.contentTypeHeader: 'application/json',
      };

  // Optional: Add authorization headers if needed
  @override
  Future<Map<String, String>> get authorizationHeader async => {};

  // Optional: Implement custom error decoding
  // this is triggered in the case if status code is not in `successfulResponsesStatusCode`
  // which defaults to 200-299
  @override
  Exception? errorDecoder(CapturedResponse response) {
    try {
      return MockAPIError.fromJson(jsonDecode(response.body));
    } catch (_) {
      return null;
    }
  }

  // Essential: Integrate the logging feature
  // This method provides detailed logs, including cURL commands
  @override
  void log(String logString) {
    print(logString);
  }

  // Optional: Implement refresh token logic
  // if you don't want to implement just send `false`
  @override
  Future<bool> tryToReauthenticate() async {
    final presistClient = client as http.Client;

    AuthTokenData authService = .. // for getting the refreshToken
    final refreshToken = authService.refreshToken;

    final result = await call<AuthTokenData>(
      Request(
        method: Method.POST,
        path: '/auth/token/refresh',
        version: 1,
        body: {
          'refreshToken': refreshToken,
        },
        decode: (json) => AuthTokenData.fromJson(json),

        /// Important Remeber to set it to `true`
        isRefreshRequest: true,
      ),

      // If we send the presistClient the same client will be used without
      // closing to trigger the previous API call that had failed and
      // triggered the unautorized / refresh token flow
      presistClient: presistClient,
    );

    // save the new token somewhere for future API calls.
    result.token...
    result.refreshToken...
    
    return true;
  }
}

There are order properties and methods you can use to further customize the API Manager extended from NetworkRequest such as.

• initalizeClient override it, to inialize a custom http.Client.
• isRequestHttps for letting the manager know if this a http or https connection.
• trimJsonLogs, enableLog & enableCurlLog for configuring logging.
• unauthorizedStatusCode a list of status code which will trigger tryToReauthenticate.
• encodeBody & decodeBody to add custom logic for encoding request body and/or decoding response result.

Note: Details are mentioned on the method comments.

2. Defining API Endpoints

To trigger an API endpoint, we have the method call in our NetworkRequest. call takes a Request object in which we can define all the endpoint related information. such as what http method we are using, whats its path, what are the query parameters or its body if any & how to decode its OK response's body.

After setting up your NetworkRequest extension, you can define specific API endpoints using an extension on your manager class or any other perfered way such as passing this MockAPIManger object to your service class.

extension on MockAPIManger {
  Future<MockAPIUser> fetchUser(int id) {
    return call(
      Request(
        method: Method.GET,
        path: '/todos/$id', // Example path
        decode: (json) => MockAPIUser.fromJson(json),
      ),
    );
  }
}

Call the endpoint method where appropriate.

void main() {
  var network = MockAPIManger();
  network.fetchUser(1);
}

3. Example Models for Decoding

To decode your API responses, you'll typically define data models.

class MockAPIError implements Exception {
  final int statusCode;
  final String message;
  const MockAPIError(this.message, this.statusCode);

  @override
  String toString() {
    return 'Status Code: $statusCode, message: $message ';
  }

  factory MockAPIError.fromJson(Map<String, dynamic> json) {
    return MockAPIError(json['message'], json['statusCode']);
  }
}

class MockAPIUser {
  const MockAPIUser({
    required this.id,
    required this.name,
    required this.profilePic,
  });
  final int id;
  final String name;
  final String? profilePic;

  factory MockAPIUser.fromJson(Map<String, dynamic> json) {
    return MockAPIUser(
      id: json['id'],
      name: json['name'],
      profilePic: json['profilePic'],
    );
  }
}

Find more detailed examples in the example folder.

Note: A mock server API with Dart was also created to test network_request functionality. You can find its source code here

📚 Additional Information

Feel free to leave any suggestions :)