dio_pretty_logger 2.0.0

A pretty-printing Dio interceptor for debugging HTTP requests and responses.

📱 dio_pretty_logger

A developer-friendly Dio interceptor that logs HTTP requests, responses, and errors in a clean, readable format. Useful for debugging API calls in Flutter/Dart projects.

✨ Features

• ✅ Proper Interceptor subclass — add directly to dio.interceptors.
• ✅ Instance-based configuration — run multiple loggers with different settings.
• ✅ Pretty-prints Maps, Lists, JSON strings, and binary (Uint8List) bodies.
• ✅ Silent in release builds by default (enabled: !kReleaseMode).
• ✅ Pluggable log sink via logPrint — redirect to any logger (e.g. logger package).
• ✅ Configurable list truncation, line width, and compaction.

📦 Installation

dependencies:
  dio: ^5.9.2
  dio_pretty_logger: ^2.0.0

flutter pub get

🚀 Usage

Basic

import 'package:dio/dio.dart';
import 'package:dio_pretty_logger/dio_pretty_logger.dart';

final dio = Dio();
dio.interceptors.add(DioPrettyLogger());

Custom configuration

dio.interceptors.add(DioPrettyLogger(
  showResponseHeader: true,   // also log response headers
  showRequestBody: false,     // hide request bodies (e.g. to avoid logging passwords)
  maxWidth: 120,              // wider terminal
  maxListPrintLength: 5,      // show at most 5 list items
  enabled: !kReleaseMode,     // explicit control
));

Custom log sink

import 'package:logger/logger.dart';

final _log = Logger();

dio.interceptors.add(DioPrettyLogger(
  logPrint: (obj) => _log.d(obj),
));

Pretty-print a map directly

final logger = DioPrettyLogger(enabled: true);
logger.printPrettyMap({'key': 'value', 'nested': {'a': 1}});

🔧 Constructor Parameters

Parameter	Type	Default	Description
showRequest	bool	true	Log the request method and URL.
showRequestHeader	bool	true	Log request headers, query params, and extras.
showRequestBody	bool	true	Log the request body or form data.
showResponseBody	bool	true	Log the response body.
showResponseHeader	bool	false	Log response headers.
showError	bool	true	Log DioException errors.
compact	bool	true	Collapse small maps/lists onto a single line.
maxWidth	int	90	Maximum line width before wrapping.
chunkSize	int	20	Bytes per row when printing Uint8List responses.
maxListPrintLength	int	10	Maximum list items printed. 0 = unlimited.
enabled	bool	!kReleaseMode	Master switch — set to false to silence all output.
logPrint	void Function(Object)	debugPrint	Custom output sink.

🔀 Migration from v1.x

v2.0 is a breaking change. The old global prettyInterceptorsWrapper and static DioPrettyLogger.* API have been replaced by a proper Interceptor subclass.

v1.x	v2.x
dio.interceptors.add(prettyInterceptorsWrapper)	dio.interceptors.add(DioPrettyLogger())
DioPrettyLogger.showRequest = false (static field)	DioPrettyLogger(showRequest: false) (constructor param)
DioPrettyLogger.kDioLogenable = false	DioPrettyLogger(enabled: false)
DioPrettyLogger.printPrettyMap(map) (static)	DioPrettyLogger().printPrettyMap(map) (instance)

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

💬 Contributing

Feel free to submit issues or pull requests. Contributions are welcome!

🌐 Author

Made with ❤️ by Deepak.