API Response Logger 🔍

<<صل عل النبي>> A Flutter package for logging and analyzing API responses with deep type inspection and structured formatting. Perfect for debugging, development, and monitoring API interactions.

✨ Features

  • Deep Type Analysis: Recursively detects data types at all levels.
  • Tree Structure View: Easy-to-read nested data visualization.
  • Smart JSON Detection: Parses JSON strings automatically.
  • Type Summary: Count of all detected data types.
  • Error Logging: With stack trace support.
  • Endpoint Tracking: Logs which API endpoint generated the response.
  • Performance Metrics: Optional timestamps & processing time.
  • Arabic & RTL Support ✅
  • Large Data Handling: Intelligent truncation & previews.
  • Custom Object Analysis: Attempts to analyze Dart objects.

🚀 Getting Started

Installation

dependencies:
log_type: ^0.0.5

Run:

flutter pub get

Import

import 'package:api_response_logger/api_response_logger.dart';

📌 Usage

Basic

ApiResponseLogger.log(response);

With Endpoint & Status

ApiResponseLogger.logResponse(
  response,
  endpoint: '/api/users',
  statusCode: 200,
);

With Type Summary

ApiResponseLogger.logResponseWithSummary(
  response,
  endpoint: '/api/users',
  statusCode: 200,
);

Error Logging

try {
  final response = await apiCall();
  ApiResponseLogger.logResponse(response);
} catch (e, stackTrace) {
  ApiResponseLogger.logError(
    e,
    endpoint: '/api/users',
    stackTrace: stackTrace,
  );
}

🛠 Example

final complexResponse = {
  'user': {
    'id': 123,
    'profile': {
      'name': 'أحمد محمد',
      'preferences': {
        'language': 'ar',
        'notifications': {'email': true, 'sms': false, 'push': null}
      }
    }
  },
  'metadata': '{"server": "api-01", "version": "2.1.0"}'
};

ApiResponseLogger.logResponseWithSummary(
  complexResponse,
  endpoint: '/api/user/complete',
  statusCode: 200,
);

📊 Type Summary (Programmatic)

final summary = ApiResponseLogger.getTypeSummary(response);
print('Strings: ${summary['String']}');
print('Maps: ${summary['Map']}');
print('Lists: ${summary['List']}');

📚 API Reference

  • logResponse → Logs response with basic analysis.
  • logResponseWithSummary → Deep analysis + type summary.
  • logError → Logs errors + optional stack trace.
  • getTypeSummary → Returns type counts.
  • log → Quick simple logger.

⚡ Best Practices

  • Use mainly during development/testing.
  • Avoid logging sensitive data.
  • Large responses are truncated automatically.
  • Can be disabled in production with kDebugMode.

📖 Extra

  • Full examples in /example.
  • Licensed under MIT.

👨‍💻 Author: Salah Saad 📧 Email: kassabksab@gmail.com

Libraries

log_type