ci: bump version to v0.3.21

Author: github-actions[bot]

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.3.21]
+
+- Released @ 7/2025 (UTC)
+- Update readme
+
 ## [0.3.20]
 
 - Released @ 7/2025 (UTC)

README.md

@@ -6,16 +6,16 @@ Dart & Flutter Packages by dev-cetera.com & contributors.
 [![sponsor](https://img.shields.io/badge/sponsor-grey?logo=github-sponsors)](https://github.com/sponsors/dev-cetera)
 [![patreon](https://img.shields.io/badge/patreon-grey?logo=patreon)](https://www.patreon.com/c/RobertMollentze)
 [![pub](https://img.shields.io/pub/v/df_log.svg)](https://pub.dev/packages/df_log)
-[![tag](https://img.shields.io/badge/tag-v0.3.20-purple?logo=github)](https://github.com/dev-cetera/df_log/tree/v0.3.20)
+[![tag](https://img.shields.io/badge/tag-v0.3.21-purple?logo=github)](https://github.com/dev-cetera/df_log/tree/v0.3.21)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/dev-cetera/df_log/main/LICENSE)
 
 ---
 
-[![banner](https://github.com/dev-cetera/df_log/blob/v0.3.20/doc/assets/banner.png?raw=true)](https://github.com/dev-cetera)
+[![banner](https://github.com/dev-cetera/df_safer_dart/blob/v0.3.21/doc/assets/banner.png?raw=true)](https://github.com/dev-cetera)
 
 <!-- BEGIN _README_CONTENT -->
 
-A package that provides a simple, powerful, and beautiful logging utility for better debugging in Dart and Flutter.
+`df_log` is a massive upgrade from `print()`. It makes your console output beautiful, readable, and powerful, turning your logs into a central event bus for debugging, analytics, and crash reporting. It’s for the developer who wants the simplicity of `print()` but with more clarity, context, and control.
 
 ## Features
 
@@ -32,6 +32,15 @@ A package that provides a simple, powerful, and beautiful logging utility for be
 
 <img src="https://raw.githubusercontent.com/dev-cetera/df_log/main/example/example.png" alt="Example image" width="400">
 
+## 🚀 Getting Started
+
+For an introduction, please refer to this article:
+
+- **MEDIUM.COM** [Dart Logging: Your New Best Friend](https://medium.com/@dev-cetera/dart-logging-your-new-best-friend-7e0dbd701dc7)
+- **DEV.TO** [Dart Logging: Your New Best Friend](https://dev.to/dev_cetera/dart-logging-your-new-best-friebd-ae1)
+- **GITHUB** [Dart Logging: Your New Best Friend](https://github.com/dev-cetera/df_log/blob/main/ARTICLE.md)
+
+
 ## Usage
 
 ### 1. Categorized Logs

lib/src/log.dart

@@ -554,7 +554,8 @@ final class Log {
     }
 
     // Only print if combinedTags is empty or any of combinedTags are in activeTags.
-    if (combinedTags.isNotEmpty && !activeTags.any((e) => combinedTags.contains(e))) {
+    if (combinedTags.isNotEmpty &&
+        !activeTags.any((e) => combinedTags.contains(e))) {
       return;
     }
 

lib/src/log_item.dart

@@ -48,8 +48,8 @@ final class LogItem {
     required this.showTags,
     required this.showTimestamp,
     required this.frame,
-  })  : id = const Uuid().v4(),
-        timestamp = DateTime.now();
+  }) : id = const Uuid().v4(),
+       timestamp = DateTime.now();
 
   //
   //
@@ -102,8 +102,12 @@ final class LogItem {
     final hasLocation = location1 != null && location1.isNotEmpty;
 
     if (hasLocation) {
-      final bracketStyle = nonMessageStyle != null ? AnsiStyle.bold + nonMessageStyle : null;
-      final pathTextStyle = nonMessageStyle != null ? AnsiStyle.italic + nonMessageStyle : null;
+      final bracketStyle = nonMessageStyle != null
+          ? AnsiStyle.bold + nonMessageStyle
+          : null;
+      final pathTextStyle = nonMessageStyle != null
+          ? AnsiStyle.italic + nonMessageStyle
+          : null;
       if (icon != null) {
         buffer.write('$icon ');
       }
@@ -120,8 +124,8 @@ final class LogItem {
 
     if (message != null) {
       final styledMessage = message.toString().trim().withAnsiStyle(
-            messageStyle,
-          );
+        messageStyle,
+      );
       buffer.write(styledMessage);
     }
 
@@ -149,7 +153,9 @@ final class LogItem {
     final uri = frame?.uri.toString();
 
     return {
-      'icon': icon != null && (location != null && location!.isNotEmpty) ? icon : null,
+      'icon': icon != null && (location != null && location!.isNotEmpty)
+          ? icon
+          : null,
       'location': location != null && location!.isNotEmpty ? location : null,
       'message': () {
         try {
@@ -175,7 +181,9 @@ final class LogItem {
 
   String toJson({bool pretty = true}) {
     final map = toMap();
-    final encoder = pretty ? const JsonEncoder.withIndent('  ') : const JsonEncoder();
+    final encoder = pretty
+        ? const JsonEncoder.withIndent('  ')
+        : const JsonEncoder();
     return encoder.convert(map);
   }