dio_ansi_logger 1.0.2

A beautiful, Postman-style Dio interceptor that logs HTTP requests and responses with ANSI colors, structured formatting, and customizable themes.

dio_ansi_logger

A beautiful, Postman-style Dio interceptor that logs HTTP requests and responses with ANSI colors, structured formatting, and fully customizable themes — straight to your Flutter debug console.

---

✨ Features

• 📦 Structured output — bordered sections for REQUEST, RESPONSE ✓ and ERROR ✕
• 🎨 4 built-in themes — dark, minimal, solarized, nord
• 🖌️ Fully customizable — control the color of every single field
• 🌈 Syntax-highlighted JSON — keys, strings, numbers, booleans and nulls each get their own color
• ✂️ Body truncation — set maxBodyLength to prevent huge payloads flooding the console
• 🔧 Toggleable sections — disable request, response or error logging independently
• 0️⃣ Zero extra dependencies — only requires dio

---

📸 Output Preview

╔════════════════════════════════════════════════════
║  REQUEST
╠════════════════════════════════════════════════════
  Method  : POST
  URL     : https://api.example.com/auth/login
  Headers :
             Content-Type: application/json
  Body    :
    {
      "email": "[e-mail]",
      "password": "••••••••"
    }
╚════════════════════════════════════════════════════

╔════════════════════════════════════════════════════
║  RESPONSE ✓
╠════════════════════════════════════════════════════
  Status  : 200 OK
  Method  : POST
  URL     : https://api.example.com/auth/login
  Headers :
             Content-Type: application/json
  Body    :
    {
      "token": "eyJhbGciOiJIUzI1NiJ9...",
      "expiresIn": 3600
    }
╚════════════════════════════════════════════════════

Colors render in the VS Code Debug Console and Unix terminals.
Android Studio users: install the ANSI Highlighting plugin.

---

🚀 Installation

Add to your pubspec.yaml:

dependencies:
  dio_ansi_logger: ^1.0.0

Then run:

flutter pub get

---

🔧 Usage

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

final dio = Dio();
dio.interceptors.add(const DioLogger());

That's it. Every request, response and error will now be logged beautifully.

---

🎨 Switching Themes

// Dark terminal — Postman-inspired (default)
dio.interceptors.add(const DioLogger());
dio.interceptors.add(const DioLogger(theme: LoggerThemes.dark));

// Other built-in themes
dio.interceptors.add(const DioLogger(theme: LoggerThemes.minimal));
dio.interceptors.add(const DioLogger(theme: LoggerThemes.solarized));
dio.interceptors.add(const DioLogger(theme: LoggerThemes.nord));
dio.interceptors.add(const DioLogger(theme: LoggerThemes.matrix)); // 🟢 bright green

---

🖌️ Custom Theme

Use LoggerTheme with Ansi constants to build your own palette:

import 'package:dio_ansi_logger/dio_ansi_logger.dart';

const myTheme = LoggerTheme(
  sectionBorder:   Ansi.dim + Ansi.magenta,
  sectionTitle:    Ansi.bold + Ansi.brightMagenta,
  label:           Ansi.dim + Ansi.white,
  value:           Ansi.brightWhite,
  methodGet:       Ansi.bold + Ansi.brightGreen,
  methodPost:      Ansi.bold + Ansi.brightBlue,
  methodPut:       Ansi.bold + Ansi.brightYellow,
  methodDelete:    Ansi.bold + Ansi.brightRed,
  methodPatch:     Ansi.bold + Ansi.brightMagenta,
  statusSuccess:   Ansi.bold + Ansi.brightGreen,
  statusRedirect:  Ansi.bold + Ansi.brightYellow,
  statusError:     Ansi.bold + Ansi.brightRed,
  jsonKey:         Ansi.brightCyan,
  jsonString:      Ansi.brightGreen,
  jsonNumber:      Ansi.brightYellow,
  jsonBool:        Ansi.brightMagenta,
  jsonNull:        Ansi.dim + Ansi.white,
  errorTitle:      Ansi.bold + Ansi.brightRed,
  errorValue:      Ansi.red,
  dim:             Ansi.dim + Ansi.white,
  reset:           Ansi.reset,   // ← always keep this as Ansi.reset
);

dio.interceptors.add(const DioLogger(theme: myTheme));

Ansi color reference

Code	Color	Code	Color
Ansi.red	Red	Ansi.brightRed	Bright Red
Ansi.green	Green	Ansi.brightGreen	Bright Green
Ansi.yellow	Yellow	Ansi.brightYellow	Bright Yellow
Ansi.blue	Blue	Ansi.brightBlue	Bright Blue
Ansi.magenta	Magenta	Ansi.brightMagenta	Bright Magenta
Ansi.cyan	Cyan	Ansi.brightCyan	Bright Cyan
Ansi.white	White	Ansi.brightWhite	Bright White
Ansi.bold	Bold	Ansi.dim	Dim

Combine them: Ansi.bold + Ansi.brightGreen = bold bright green.

---

⚙️ Options

Parameter	Type	Default	Description
theme	LoggerTheme	LoggerThemes.dark	Color theme
logRequest	bool	true	Log outgoing requests
logResponse	bool	true	Log successful responses
logError	bool	true	Log errors (debug mode only)
maxBodyLength	int	5000	Max body chars before truncation

---

📄 License

MIT © Your Name