philiprehberger-structured_logger 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50d320ddded4b27df7fd1288642a66633c791a208c902409758587319a5ed612
-  data.tar.gz: 934b1119be3f20d97ea378643f7565be4d8033f4c3d2a9f16e20d1648b031307
+  metadata.gz: dc7adb741998f54fcb27d66e78322d0abcb77c6537298e8b8d9be58b999bf571
+  data.tar.gz: bbeea6cf1479ffa7548be5ab32cdaca87dc42c8d5657a778e1e71574056ac4f1
 SHA512:
-  metadata.gz: 9a3f313e944d193a34245debfa06347340e0daec990911f672209a8a9221560d500db387bd8057ead52e13510c4552ebef2a4d35265d9a008d20c7f3276b0d13
-  data.tar.gz: 73a5a960e9d8b8b0287b4380a7a2df5bbce8d108831015dbe9c109a68729b3b56d813830a14828c7fd0aea641b315f1d27d21373f93ab350042d9032ce9a54fa
+  metadata.gz: 67ac2a22e4a7b1b3397256fc39e9e04d11fe219b21096fd1b3c8e9996bb98f8120859baa378448d33cfe55425759c406aac72f17520582fcda4ad23e4171c4a2
+  data.tar.gz: db854b806432b15b8b891592011f02ca39741975657ef1948d6fcfad6f5408e69101b7100b46007b03588216fd85cb997c7d91fbfa299d99dcff82c88fdb5ace

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-17
+
+### Added
+- `Logger#measure(event, **context) { block }` yields to the block, captures elapsed time, and emits a single info-level structured event with `duration_ms` (plus `error`/`error_class` on failure; original exception re-raised)
+
+## [0.3.5] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
+## [0.3.4] - 2026-03-31
+
+### Changed
+- Standardize README badges, support section, and license format
+
 ## [0.3.3] - 2026-03-26
 
 ### Fixed

data/README.md

@@ -2,8 +2,7 @@
 
 [![Tests](https://github.com/philiprehberger/rb-structured-logger/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-structured-logger/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-structured_logger.svg)](https://rubygems.org/gems/philiprehberger-structured_logger)
-[![License](https://img.shields.io/github/license/philiprehberger/rb-structured-logger)](LICENSE)
-[![Sponsor](https://img.shields.io/badge/sponsor-GitHub%20Sponsors-ec6cb9)](https://github.com/sponsors/philiprehberger)
+[![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-structured-logger)](https://github.com/philiprehberger/rb-structured-logger/commits/main)
 
 Structured JSON logger with context and child loggers
 
@@ -122,6 +121,23 @@ end
 logger.log_exception(e, level: :fatal, user_id: 42)
 ```
 
+### Timing a block
+
+Use `measure` to time a block and emit a single structured event with `duration_ms`:
+
+```ruby
+logger.measure("db.query", table: "users") { User.find(1) }
+# => {"timestamp":"...","level":"info","message":"db.query","event":"db.query","table":"users","duration_ms":12.345}
+```
+
+On failure, the original exception is re-raised and the log entry also includes `error` and `error_class`:
+
+```ruby
+logger.measure("db.query") { raise "boom" }
+# => {"timestamp":"...","level":"info","message":"db.query","event":"db.query","duration_ms":0.123,"error":"boom","error_class":"RuntimeError"}
+# RuntimeError: boom
+```
+
 ### Multiple Outputs
 
 Log to multiple destinations simultaneously. Each output can have its own level filter and formatter:
@@ -258,6 +274,7 @@ When the buffer is full, writes fall back to synchronous mode (backpressure) to
 | `with_context(**extra, &block)` | Temporarily merge context for a block |
 | `silence(level = :fatal, &block)` | Temporarily raise log level for a block |
 | `log_exception(exception, level: :error, **extra)` | Log exception details |
+| `measure(event_name, **context) { block }` | Time a block, emit an info event with `duration_ms`, and re-raise on failure |
 | `add_output(io, level: nil, formatter: nil)` | Add an output destination at runtime |
 | `with_correlation_id(id = nil, &block)` | Set a correlation ID for the block |
 | `flush` | Force write of all buffered log entries |
@@ -292,6 +309,24 @@ bundle exec rspec
 bundle exec rubocop
 ```
 
+## Support
+
+If you find this project useful:
+
+⭐ [Star the repo](https://github.com/philiprehberger/rb-structured-logger)
+
+🐛 [Report issues](https://github.com/philiprehberger/rb-structured-logger/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+💡 [Suggest features](https://github.com/philiprehberger/rb-structured-logger/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+
+❤️ [Sponsor development](https://github.com/sponsors/philiprehberger)
+
+🌐 [All Open Source Projects](https://philiprehberger.com/open-source-packages)
+
+💻 [GitHub Profile](https://github.com/philiprehberger)
+
+🔗 [LinkedIn Profile](https://www.linkedin.com/in/philiprehberger)
+
 ## License
 
 [MIT](LICENSE)

data/lib/philiprehberger/structured_logger/formatter.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "json"
-require "time"
+require 'json'
+require 'time'
 
 module Philiprehberger
   module StructuredLogger
@@ -44,7 +44,7 @@ module Philiprehberger
         context.each do |key, value|
           parts << "#{key}=#{value}"
         end
-        parts.join(" ")
+        parts.join(' ')
       end
     end
 
@@ -54,7 +54,7 @@ module Philiprehberger
       when :text then TextFormatter.new
       when Proc then formatter
       else
-        raise ArgumentError, "Invalid formatter" unless formatter.respond_to?(:call)
+        raise ArgumentError, 'Invalid formatter' unless formatter.respond_to?(:call)
 
         formatter
       end

data/lib/philiprehberger/structured_logger/logger.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "monitor"
-require "securerandom"
+require 'monitor'
+require 'securerandom'
 
 module Philiprehberger
   module StructuredLogger
@@ -76,6 +76,41 @@ module Philiprehberger
             **extra)
       end
 
+      # Yields to the given block, measures its monotonic wall-clock
+      # duration, and emits a single info-level log entry describing the
+      # outcome. On success, the block's return value is returned. On
+      # exception, the failure is logged and the original exception is
+      # re-raised.
+      #
+      # @param event_name [String, Symbol] the event name to record as
+      #   the `event` field in the log entry.
+      # @param context [Hash] extra context merged into the log entry.
+      # @yield executes the measured block.
+      # @return [Object] the block's return value on success.
+      # @raise re-raises any exception raised by the block.
+      #
+      # @example Measuring a database query
+      #   logger.measure('db.query', table: 'users') { User.find(1) }
+      #   # logs event: 'db.query', table: 'users', duration_ms: 12.345
+      def measure(event_name, **context)
+        start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        begin
+          result = yield
+          duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0).round(3)
+          log(:info, event_name.to_s, event: event_name, duration_ms: duration_ms, **context)
+          result
+        rescue StandardError => e
+          duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0).round(3)
+          log(:info, event_name.to_s,
+              event: event_name,
+              duration_ms: duration_ms,
+              error: e.message,
+              error_class: e.class.name,
+              **context)
+          raise
+        end
+      end
+
       def flush
         @monitor.synchronize { @outputs.each { |out| out[:io].flush if out[:io].respond_to?(:flush) } }
       end

data/lib/philiprehberger/structured_logger/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructuredLogger
-    VERSION = "0.3.3"
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/structured_logger.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require_relative "structured_logger/version"
-require_relative "structured_logger/formatter"
-require_relative "structured_logger/async_writer"
-require_relative "structured_logger/logger"
+require_relative 'structured_logger/version'
+require_relative 'structured_logger/formatter'
+require_relative 'structured_logger/async_writer'
+require_relative 'structured_logger/logger'
 
 module Philiprehberger
   module StructuredLogger

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-structured_logger
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-04-18 00:00:00.000000000 Z
 dependencies: []
 description: A zero-dependency Ruby gem for structured JSON logging with context merging,
   child loggers, level filtering, and pluggable outputs.
@@ -26,11 +26,11 @@ files:
 - lib/philiprehberger/structured_logger/formatter.rb
 - lib/philiprehberger/structured_logger/logger.rb
 - lib/philiprehberger/structured_logger/version.rb
-homepage: https://github.com/philiprehberger/rb-structured-logger
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-structured_logger
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-structured-logger
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-structured_logger
   source_code_uri: https://github.com/philiprehberger/rb-structured-logger
   changelog_uri: https://github.com/philiprehberger/rb-structured-logger/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'