chirp 0.9.0

A lightweight, fully customizable Dart logger with automatic caller info, zero config, rotating file writers, and structured logging.

Chirp Changelog

0.9.0

• New Lazy message construction — pass () => 'expensive $message' to any log method. The lambda is only called when the log level passes the filter, avoiding unnecessary string allocations.

• New Lazy log builders — traceLazy, debugLazy, infoLazy, noticeLazy, successLazy, warningLazy, errorLazy, criticalLazy, wtfLazy, and logLazy (with a level: argument) — defer the entire log call (message, data, error, stackTrace, formatOptions) until the level filter passes. Useful when expensive work lives in the structured data map, not just the message string.

  Chirp.warningLazy(
    (log) => log('snapshot', data: {'state': renderState()}),
  );
  

  Matching Chirp.*Lazy static forwarders are exposed on the global logger. Caller resolution lands on the xxxLazy(...) invocation line, not the inner (log) => ... lambda body, so eager and lazy calls report consistent source locations. Adds the ChirpLogFn typedef for the inner log callback.

0.8.0

New Features

• New LogRecord.wallClock, always capturing DateTime.now() vs. LogRecord.time capturing clock.now() which can be faked in tests
• New RotatingFileWriter to write log files with automatic rotation and optional compression, including a RotatingFileReader to consume the log files again.
• Unified formatter architecture — Console and file formatters now share a single ChirpFormatter base class with MessageBuffer, replacing the separate ConsoleMessageFormatter / FileMessageFormatter hierarchies.
• Wasm support: RotatingFileWriter is only available on non-web platforms.
• Add minLevel constructor parameter to all writers

Breaking Changes

• Breaking ConsoleMessageFormatter is now a deprecated typedef for ChirpFormatter — migrate custom formatters to extend ChirpFormatter and use format(LogRecord record, MessageBuffer buffer) instead of format(LogRecord record, ConsoleMessageBuffer buffer)
• Breaking FileMessageFormatter is now a deprecated typedef for ChirpFormatter — migrate custom file formatters to extend ChirpFormatter and write to buffer.file instead of returning a String
• Breaking JsonFileFormatter removed — use JsonLogFormatter instead
• Breaking JsonLogFormatter (replaces JsonMessageFormatter) simplified: removed includeSourceLocation, includeClassAndInstance, useUtcTimestamps, JsonDataStyle, .console(), and .file() constructors. Source location and class/instance info are now always included. Timestamps are always UTC. Data fields are always written at the root level.
• Deprecated JsonMessageFormatter — use JsonLogFormatter instead

0.7.0

New Features

Structured logging for cloud platforms

• Add GcpMessageFormatter for Google Cloud Platform with automatic Error Reporting, sourceLocation, and trace correlation
• Add AwsMessageFormatter for AWS CloudWatch with proper log level mapping
• Add JsonMessageFormatter for platform-agnostic JSON output

Lambda-based APIs for inline customization

• Add DelegatedChirpInterceptor for creating interceptors inline with lambdas
• Add DelegatedChirpWriter for creating writers inline with lambdas
• Add DelegatedConsoleMessageFormatter for creating formatters inline with lambdas

New span types for custom formatters

• Add DataKey and DataValue spans for individual key/value rendering
• Add StackFrameInfo.packageRelativePath for clean, package-relative file paths
• InlineData now supports custom separators via entrySeparatorBuilder and keyValueSeparatorBuilder

Other additions

• Add LogRecord.copyWith() for easier log record manipulation in interceptors

Breaking Changes

• Span-related exports moved from package:chirp/chirp.dart to package:chirp/chirp_spans.dart
  • Affected: SpanBasedFormatter, all span classes (PlainText, AnsiStyled, etc.), colorForHash, ColorSaturation
  • Migration: Add import 'package:chirp/chirp_spans.dart'; if using custom formatters

Bug Fixes

• Fix child logger not inheriting parent's minLogLevel
• Fix Aligned span ignoring ANSI escape codes in padding calculation
• Fix StackTraceSpan adding extra blank line due to trailing newline

Improvements

• Remove dimmed styling from log messages without level color for better readability

Deprecations

• Deprecate RainbowMessageFormatter.metaWidth (no longer has any effect)

0.6.0

• First public release to pub.dev
• Rework of ANSI colors, now with truecolor support and detection
• Interceptors for filtering and manipulation
• minLogLevel for fast level based filtering
• Optional Stacktrace.current capturing

0.5.0

• First working prototype