cogger 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af05bac1bb9c038a63ab4b3a2cab4c88d9da636773fe625215e9b5ec07dbfef9
-  data.tar.gz: be3aa6d32adcd4848a385027db21548f9233960024db003d3a855bb1ac654e4c
+  metadata.gz: c31256d5e4f8446c023227a43adb18992c566a027c61f7b3356cea081662b2ed
+  data.tar.gz: 0ef798366fa9b799dbf24967e656ae5840d14e62953aad6c551aac462e0ff1a4
 SHA512:
-  metadata.gz: f38ac069cb48f265aac5f2a33289a2b0b4a2733dcc295a9fab24e56a165aa1d26d00bf065b237c831a2eb75052e987afe87d6a7aa3aa46469faa8deb7c2c268b
-  data.tar.gz: 12c247340142fa2ae5964971aec4c15f788f3106bdda1a10bd000fe1ceacab566a74a9793346f3f2a3f2b72f8a3fa3a37e8ffd476f860266dd63a4b3c7a156e3
+  metadata.gz: 242434b94151c9072d5dd0bbd5c8985a2020001ed6bd30eb406684755595bac2747c298c694a7c945f3da06a358fceb94b60a8a095c79c169ef2ab55db19411b
+  data.tar.gz: b3e3e7d9ee7d95b987d6c51c019f8811e0ac1aa9ddbe700997be59c51bf64b13a4903c27c985ffc83d50b7ab90a799bcb842db9aa15875cdb1f40aa8a24e88c7

data/README.adoc

@@ -282,6 +282,26 @@ Aliases are a powerful way to customize colors via concise syntax in your templa
 
 💡 Aliases are used by the color and emoji formatters so check out the {tone_link} documentation and/or _Templates_ and _Formatters_ sections below to learn more.
 
+=== Encodings
+
+All messages use UTF-8 encoding. Any unknown character will show up as a question mark. Example:
+
+[source,ruby]
+----
+logger = Cogger.new
+bad = "b\xE9d".dup.force_encoding "ASCII-8BIT"
+
+logger.info bad      # "b?d"
+logger.info { bad }  # "b?d"
+----
+
+The underlying implementation uses the following to produce the logs shown above:
+
+[source,ruby]
+----
+message.encode "UTF-8", invalid: :replace, undef: :replace, replace: "?"
+----
+
 === Templates
 
 Templates are used by all formatters and adhere to an _enhanced_ version of the {format_link} as used by `Kernel#format`. Here’s what is provided by default:
@@ -746,6 +766,41 @@ logger.info "Demo", tags: ["WEB", "PRIMARY", {service: :api, demo: true}]
 
 Notice, with the above, that the single tags of `WEB` and `PRIMARY` show up in the `tags` array while the `:service` and `:demo` keys show up at the top level of the hash. Since the `:tags`, `:service`, `:demo` keys are normal keys, like any key in your JSON output, this means you can use a custom template to arrange the order of these keys if you don't like the default.
 
+A block can be used with a string or hash for content. Example:
+
+[source,ruby]
+----
+logger = Cogger.new formatter: :json
+
+logger.info { "Demo" }
+# {
+#   "id":"console",
+#   "level":"INFO",
+#   "at":"2025-08-03T13:37:58.227-06:00",
+#   "message":"Demo"
+# }
+
+logger.info { {message: :demo, weight: 0.2} }
+# {
+#   "id":"console",
+#   "level":"INFO",
+#   "at":"2025-08-03T13:39:32.438-06:00",
+#   "message":"demo",
+#   "weight":0.2
+# }
+
+logger.info(tags: %w[WEB PRIMARY]) { {message: :demo, weight: 0.2} }
+# {
+#   "id":"console",
+#   "level":"INFO",
+#   "at":"2025-08-03T13:42:22.869-06:00",
+#   "message":"demo",
+#   "tags":["WEB",
+#   "PRIMARY"],
+#   "weight":0.2
+# }
+----
+
 ==== Rack
 
 This formatter is the _Simple_ formatter with a different template and can be configured as follows:

data/cogger.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "cogger"
-  spec.version = "1.3.0"
+  spec.version = "1.4.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/cogger"

data/lib/cogger/configuration.rb

@@ -18,7 +18,8 @@ module Cogger
     :size,
     :suffix,
     :entry,
-    :logger
+    :logger,
+    :mutex
   ) do
     using Refinements::Array
 
@@ -33,7 +34,8 @@ module Cogger
                    size: 1_048_576,
                    suffix: "%Y-%m-%d",
                    entry: Entry,
-                   logger: Logger
+                   logger: Logger,
+                   mutex: Mutex.new
       super.tap { tags.freeze }
     end
 

data/lib/cogger/entry.rb

@@ -5,11 +5,13 @@ require "core"
 module Cogger
   # Defines a log entry which can be formatted for output.
   Entry = Data.define :id, :level, :at, :message, :tags, :datetime_format, :payload do
-    def self.for(message = nil, **payload)
+    def self.for(message = nil, **payload, &)
+      content = block_given? ? yield : message
+
       new id: payload.delete(:id) || Program.call,
           level: (payload.delete(:level) || "INFO").upcase,
           at: payload.delete(:at) || ::Time.now,
-          message: (block_given? ? yield : message),
+          message: sanitize!(content, payload),
           tags: Array(payload.delete(:tags)),
           datetime_format: payload.delete(:datetime_format) || DATETIME_FORMAT,
           payload:
@@ -26,6 +28,22 @@ module Cogger
           }
     end
 
+    def self.sanitize! content, payload
+      body = if content.is_a? Hash
+               content.delete(:message).tap { payload.merge! content }
+             else
+               content
+             end
+
+      if body.is_a? String
+        body.encode "UTF-8", invalid: :replace, undef: :replace, replace: "?"
+      else
+        body
+      end
+    end
+
+    private_class_method :sanitize!
+
     def initialize id: Program.call,
                    level: "INFO",
                    at: ::Time.now,

data/lib/cogger/formatters/abstract.rb

@@ -23,8 +23,8 @@ module Cogger
 
       protected
 
-      def sanitize entry, message
-        entry.public_send(message).tap do |attributes|
+      def sanitize entry, method
+        entry.public_send(method).tap do |attributes|
           filter attributes
           attributes.transform_values! { |value| format_time value, format: entry.datetime_format }
         end

data/lib/cogger/formatters/parsers/position.rb

@@ -19,10 +19,8 @@ module Cogger
           @pattern = pattern
         end
 
-        # :reek:FeatureEnvy
         def call template, attributes
-          return attributes if !template || template.empty?
-          return attributes unless template.match? pattern
+          return attributes unless String(template).match? pattern
 
           keys = scan template
           attributes.slice(*keys).merge!(attributes.except(*keys))

data/lib/cogger/hub.rb

@@ -6,7 +6,6 @@ require "refinements/hash"
 
 module Cogger
   # Loads configuration and simultaneously sends messages to multiple streams.
-  # :reek:TooManyInstanceVariables
   # :reek:TooManyMethods
   class Hub
     extend Forwardable
@@ -40,7 +39,6 @@ module Cogger
       @configuration = model[**find_formatter(attributes)]
       @primary = configuration.to_logger
       @streams = [@primary]
-      @mutex = Mutex.new
     end
 
     def add_stream **attributes
@@ -80,7 +78,7 @@ module Cogger
 
     private
 
-    attr_reader :registry, :configuration, :primary, :streams, :mutex
+    attr_reader :registry, :configuration, :primary, :streams
 
     # :reek:FeatureEnvy
     def find_formatter attributes
@@ -110,7 +108,7 @@ module Cogger
         &
       )
 
-      mutex.synchronize { streams.each { |logger| logger.public_send level, entry } }
+      configuration.mutex.synchronize { streams.each { |logger| logger.public_send level, entry } }
       true
     end
     # rubocop:enable Metrics/MethodLength

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cogger
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -175,7 +175,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.1
 specification_version: 4
 summary: A customizable and feature rich logger.
 test_files: []