chore(release): v0.1.2

Author: karei

CHANGELOG.md

@@ -32,5 +32,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Documentation: general improvements and clarifications.
 
+## [0.1.2] - 2025-10-13
+### Changed
+- PlainLogger: reworked rendering for simpler, more predictable output and better performance.
+  - Use `render_plain` helpers: arrays with `N >= 2` are shown with `show(MIME"text/plain")` for readable matrices; scalars and 1-D arrays print directly.
+  - Remove color styling and rely on plain printing for consistent logs across environments.
+  - Normalize metadata footer: prints `@ <Module> <file> :<line>` only when available, always followed by a newline.
+  - Tighten `handle_message` signature to `message::Union{Tuple,AbstractString}`.
+  - Add `@nospecialize kwargs` to avoid excessive specialization and reduce latency.
+
+### Fixed
+- Ensure `handle_message` always returns `nothing` for type stability.
+
 [Unreleased]: https://github.com/<owner>/<repo>/compare/v0.1.1...HEAD
+[0.1.2]: https://github.com/<owner>/<repo>/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/<owner>/<repo>/compare/v0.1.0...v0.1.1

Project.toml

@@ -1,7 +1,7 @@
 name = "ComponentLogging"
 uuid = "3f6ec708-df3b-46b4-8b70-ec9fa53b9f7d"
 authors = ["karei <abcdvvvv@gmail.com>"]
-version = "0.1.1"
+version = "0.1.2"
 
 [deps]
 Logging = "56ddb016-857b-54e1-b83d-db4d58db5568"

src/PlainLogger.jl

@@ -11,7 +11,19 @@ PlainLogger(min_level::LogLevel=Info) = PlainLogger(Base.CoreLogging.closed_stre
 Logging.min_enabled_level(logger::PlainLogger) = logger.min_level
 Logging.shouldlog(logger::PlainLogger, level, _module, group, id) = level >= logger.min_level
 
-function Logging.handle_message(l::PlainLogger, level::LogLevel, message, _module, group, id, file, line; kwargs...)
+function render_plain(iob, x::AbstractArray{T,N}) where {T,N}
+    if N >= 2
+        show(iob, MIME"text/plain"(), x)
+    else
+        print(iob, x)
+    end
+end
+
+render_plain(iob, x) = print(iob, x)
+
+function Logging.handle_message(l::PlainLogger, level::LogLevel, message::Union{Tuple,AbstractString}, _module, group, id, file, line; kwargs...)::Nothing
+    @nospecialize kwargs
+
     stream::IO = l.stream
     if !(isopen(stream)::Bool)
         stream = stderr
@@ -20,40 +32,31 @@ function Logging.handle_message(l::PlainLogger, level::LogLevel, message, _modul
     buf = IOBuffer()
     iob = IOContext(buf, stream)
 
-    color = level >= Error ? :red : level >= Warn ? :yellow : level == Debug ? :green : :normal
-    pretty(x) = begin
-        if x isa AbstractArray{T,2} where {T} || x isa AbstractArray{T,3} where {T}
-            str = sprint(show, MIME"text/plain"(), x)
-            printstyled(iob, str; color)
-        else
-            printstyled(iob, x; color)
-        end
-    end
-
     if message isa Tuple
         for m in message
-            pretty(m)
+            render_plain(iob, m)
         end
     else
-        pretty(message)
+        render_plain(iob, message)
     end
     for (k, v) in kwargs
-        print(iob, "\n ")
-        printstyled(iob, k, " = "; color)
-        pretty(v)
+        print(iob, "\n ", k, " = ")
+        render_plain(iob, v)
     end
 
     if _module !== nothing || file !== nothing
-        println(iob)
-        printstyled(iob, "@ "; color)
-        _module !== nothing && printstyled(iob, string(_module), " "; color)
-        file !== nothing && printstyled(iob, Base.basename(String(file)), " "; color)
-        line !== nothing && printstyled(iob, ":", line; color)
+        print(iob, "\n@ ")
+        _module !== nothing && print(iob, string(_module), " ")
+        if file !== nothing
+            print(iob, Base.basename(String(file)), " ")
+            line !== nothing && print(iob, ":", line)
+        end
     end
     println(iob)
 
     bytes = take!(buf)
     lock(l.lock) do
         write(stream, bytes)
     end
+    nothing
 end