flutter_devlog 0.3.0

A lightweight, extensible colored console logger for Flutter with structured log records, source location, JSON, levels, tags and scopes.

0.3.0

Production-safe: assert()-based tree-shaking.

Every log call (log, lazy, json, configure, reset) is now wrapped in an assert(() { ...; return true; }()) block. Dart/Flutter removes all assert() calls at compile time when building with --no-enable-asserts (the default for flutter build apk, flutter build ipa, flutter build web, and every AOT release build). This means zero bytes of logging code exist in your release binary — it is a compiler-level guarantee, not a runtime check.

This supersedes the previous kReleaseMode runtime guard (which kept the code in the binary but short-circuited it). The new approach is the idiomatic Dart pattern used by the Flutter framework itself.

Changes:

• configure() and reset() are also assert-wrapped and are no-ops in release.
• enabled now defaults to true (the assert() wrapper is the debug-only gate; setting enabled = false is still the way to silence the logger in debug/profile builds).
• import 'package:flutter/foundation.dart' removed — no longer needed.

No breaking API changes. Users do not need to update any call sites.

0.2.0

New features:

• Release builds are now always silent: even DevLog.enabled = true has no effect in release mode. The check is a compile-time constant (kReleaseMode), so logging code is tree-shaken out of release builds. enabled now only controls debug and profile builds.

• Structured log sink: DevLog.onLog now receives a LogRecord with the level, raw message (no ANSI codes), channel name, tag, error, stack trace, timestamp, and source location. Use record.formatted for the colored console string.

• DevLog.configure(...) to set several options in one call and DevLog.reset() to restore all defaults (handy in test tearDown).

• Tag filtering: DevLog.allowedTags (allowlist) and DevLog.blockedTags (denylist).

• Timestamps: set DevLog.showTimestamps = true for an HH:mm:ss.SSS prefix.

• ScopedLogger parity: lazy(), child() for nested scopes (Auth/Login), a label parameter on json(), and error/stackTrace parameters on log().

• DevLog.json now accepts a level (defaults to the new LogLevel.json) and respects minPriority like every other log.

Breaking changes:

• DevLog.onLog changed from void Function(String message, String name) to void Function(LogRecord record). Errors and stack traces are no longer delivered as separate /ERR and /STK calls; they are fields on the record. Migration:

  // Before
  DevLog.onLog = (message, name) => file.writeln('[$name] $message');
  
  // After
  DevLog.onLog = (record) =>
      file.writeln('[${record.name}] ${record.message}');
  

• The sourceSkip parameter was removed from DevLog.log. The source location is now resolved automatically and stays correct through wrappers.

• DevLog.json prints the title and JSON body as a single log entry instead of two, and is filtered by minPriority (priority info by default).

0.1.0

Initial release.

• Leveled colored logging: info, success, warn, error, api, storage, ui.
• Custom LogLevel support with LogPriority for filtering.
• Optional [file:line] source location (DevLog.includeSource).
• error and stackTrace parameters forwarded to dart:developer.
• Tagged logging (tag:) and per-module DevLog.scoped() loggers.
• DevLog.minPriority filter and DevLog.lazy() for deferred messages.
• Pretty JSON logging via DevLog.json.
• Pluggable output via DevLog.onLog; debug-only by default.