metrics 0.12.0 → 0.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68f3f47929348e39fb0b1989c529211aeca2e77a11d89cc74eb5156517413920
-  data.tar.gz: 23d3a1efe32f6de6a69f63401ad777e5ccd42d9386bb02dfa8039c0bfa84e7b0
+  metadata.gz: da58c61e306a2816806803db0b41e967f593517c8f825a454d1480dafce50342
+  data.tar.gz: c535510ec158b5c0181b57a772c0d43c9800356f9180a4ae97c35037732e99af
 SHA512:
-  metadata.gz: 266cbaef3d8f81ba42de551bf2119ec6f93004a68cc373046726aec26129a949e01b3548362d6f155bd9fbc48144d06483fcc83db62c9eab34bfe340c4681df7
-  data.tar.gz: 50fe49335a1fadc4362d1dac69c084867eb47b358de9197d7f77276033a9c55176db64464bf422ef55da3e52ffef2263bd0baae741a0f0027e98182e8aa4d588
+  metadata.gz: 0ae866b7e9dfce05883974ed8ea2489536838d3a8cc9e5947ee188879e7e72c8793f23e9274b26a20749e114d653b6006ed8a10827f13f3dbb680052e5fd2231
+  data.tar.gz: cb70aa1a2a2672df5d80a8368265495b2652a612fc0128972a64c1eec917076881ff27daafb9c514b5f86fd46bcf400cb838597971ff00be6fe59b42562d199a

data/lib/metrics/backend/capture.rb

@@ -3,7 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2023-2024, by Samuel Williams.
 
-require "console"
 require_relative "../metric"
 
 module Metrics

data/lib/metrics/backend/console.rb

@@ -3,9 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require "console"
 require_relative "../metric"
 
+require "console"
+
 module Metrics
 	module Backend
 		module Console

data/lib/metrics/backend/test.rb

@@ -3,7 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require "console"
 require_relative "../metric"
 
 module Metrics

data/lib/metrics/backend.rb

@@ -3,27 +3,11 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require "console/event/failure"
+require_relative "config"
 
 module Metrics
 	module Backend
-		# Require a specific trace backend.
-		def self.require_backend(env = ENV)
-			if backend = env["METRICS_BACKEND"]
-				begin
-					require(backend)
-				rescue LoadError => error
-					::Console::Event::Failure.for(error).emit(self, "Unable to load metrics backend!", backend: backend, severity: :warn)
-					
-					return false
-				end
-				
-				Metrics.extend(Backend::Interface)
-				
-				return true
-			end
-		end
 	end
+	
+	Config::DEFAULT.require_backend
 end
-
-Metrics::Backend.require_backend

data/lib/metrics/config.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024-2025, by Samuel Williams.
+
+module Metrics
+	# Represents a configuration for the metrics library.
+	class Config
+		DEFAULT_PATH = ENV.fetch("METRICS_CONFIG_DEFAULT_PATH", "config/metrics.rb")
+		
+		# Load the configuration from the given path.
+		# @parameter path [String] The path to the configuration file.
+		# @returns [Config] The loaded configuration.
+		def self.load(path)
+			config = self.new
+			
+			if File.exist?(path)
+				config.instance_eval(File.read(path), path)
+			end
+			
+			return config
+		end
+		
+		# Load the default configuration.
+		# @returns [Config] The default configuration.
+		def self.default
+			@default ||= self.load(DEFAULT_PATH)
+		end
+		
+		# Prepare the backend, e.g. by loading additional libraries or instrumentation.
+		def prepare
+		end
+		
+		# Require a specific metrics backend implementation.
+		def require_backend(env = ENV)
+			if backend = env["METRICS_BACKEND"]
+				begin
+					if require(backend)
+						Metrics.singleton_class.prepend(Backend::Interface)
+						
+						return true
+					end
+				rescue LoadError => error
+					warn "Unable to load metrics backend: #{backend.inspect}!"
+				end
+			end
+			
+			return false
+		end
+		
+		# Load the default configuration.
+		DEFAULT = self.default
+	end
+end

data/lib/metrics/provider.rb

@@ -35,6 +35,8 @@ module Metrics
 			
 			return provider
 		end
+		
+		Config::DEFAULT.prepare
 	else
 		def self.Provider(klass, &block)
 			# Metrics disabled.

data/lib/metrics/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2024, by Samuel Williams.
 
 module Metrics
-	VERSION = "0.12.0"
+	VERSION = "0.12.2"
 end

data/lib/metrics.rb

@@ -6,3 +6,7 @@
 require_relative "metrics/version"
 require_relative "metrics/provider"
 require_relative "metrics/tags"
+
+# @namespace
+module Metrics
+end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2021-2024, by Samuel Williams.  
+Copyright, 2021-2025, by Samuel Williams.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -19,6 +19,14 @@ Please see the [project documentation](https://socketry.github.io/metrics/) for
 
   - [Testing](https://socketry.github.io/metrics/guides/testing/index) - This guide explains how to write assertions in your test suite to validate `metrics` are being emitted correctly.
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/metrics/releases/index) for all releases.
+
+### v0.12.1
+
+  - [Introduce `Metrics::Config` to Expose `prepare` Hook](https://socketry.github.io/metrics/releases/index#introduce-metrics::config-to-expose-prepare-hook)
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,18 @@
+# Releases
+
+## v0.12.1
+
+### Introduce `Metrics::Config` to Expose `prepare` Hook
+
+The `metrics` gem uses aspect-oriented programming to wrap existing methods to emit metrics. However, while there are some reasonable defaults for emitting metrics, it can be useful to customize the behavior and level of detail. To that end, the `metrics` gem now optionally loads a `config/metrics.rb` which includes a `prepare` hook that can be used to load additional providers.
+
+``` ruby
+# config/metrics.rb
+
+def prepare
+	require 'metrics/provider/async'
+	require 'metrics/provider/async/http'
+end
+```
+
+The `prepare` method is called immediately after the metrics backend is loaded. You can require any provider you want in this file, or even add your own custom providers.

data.tar.gz.sig

@@ -1,3 +1,4 @@
-&�J��q�zm�IŐ�,+�>���v�P�@ǩ"����cN�˜0���(��$�e=?��ru<��(X��%�il�W�&"����6CY�����P�`;�BkE
-��ݗN��eR0P�l�U��y��QX$�@��]���F��
-`�{?<O�}���:l
+�\ᐾ2 �|W����zB��������jT|N�5Eb�J�<��䤅��.���mt�S��w;��_*o/�lS��s)r����/�P,�����ɐ?��J��T �dCW��]�0��7g`�9&�\6�6��Ufp0c���H�Re���Y뜁�<
+�9��1�Sf=��#d��7�`�؍֐{�Y�{�|�M�	�<$
+��C_e�6��28|���*�;�`��=�6�2�qSE�ʍ6{����x-��/6�)�����	�܀A>��[2ʸI���-ds|1|�!�5���;*��<bm�_��g��^�[	��'l��GmozT���_��|�|uA�Ԝ������hE9������r�D^��;�e��l	A<�
+�cm�l]=dJ%

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: metrics
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.12.2
 platform: ruby
 authors:
 - Samuel Williams
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -37,10 +36,8 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-10-12 00:00:00.000000000 Z
+date: 2025-03-07 00:00:00.000000000 Z
 dependencies: []
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -51,19 +48,20 @@ files:
 - lib/metrics/backend/capture.rb
 - lib/metrics/backend/console.rb
 - lib/metrics/backend/test.rb
+- lib/metrics/config.rb
 - lib/metrics/metric.rb
 - lib/metrics/provider.rb
 - lib/metrics/tags.rb
 - lib/metrics/version.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/metrics
 licenses:
 - MIT
 metadata:
   documentation_uri: https://socketry.github.io/metrics/
   source_code_uri: https://github.com/socketry/metrics.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -78,8 +76,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Application metrics and instrumentation.
 test_files: []

metadata.gz.sig

@@ -1,5 +1,2 @@
-O@�5��q�'�
-#�8�`���帟�u��K�TtT2�"��
-/�_�wý^S;�P���Xf[@Gմ�œC35�~��Ulⅈ����I�^�¾�Õ�7�Y�v5�̱�8S~�6h݂T�IA���)+O��
-��
-����86��16�/�M�����.�I-E|\�pT���^5�8K����4B��q���;ߣ
ӯq^���
+Y�H�޹����&�����?a�ܹ�<�抷���?���Y��z_���z^6��;�:H}����,�
�8�|N�j�n���k��%M�
+��)�j$7���*��"�ի�S�畹����ۂ�PMD��w�Ϭ0N�g�7s*���I��	�1������