traces 0.15.2 → 0.16.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cba8b363fbd6a0df7f971924f3b8d3f358bc5b91ea2eb57045716285081fc35
-  data.tar.gz: 612777384a90dbc375f1a349e8291cabd7bb8ebf77830075d29703e54d5f4d60
+  metadata.gz: a7dfd28d3152a61cde637263d62515e45dad6b3f67ed45feddb886677f9bdc0c
+  data.tar.gz: fae636690f466a2e83f81989c5791ba9bc4aeeb6809f2463e00cb200c99b241e
 SHA512:
-  metadata.gz: 162910bc810cdb69c55e6bb59354dd7b0859237a4cc47c5d1a4ce4ccb6cafee24913680d9f1d815540b4524941eb9fd8bcda7cd49bebcd3fbdac534708cb828e
-  data.tar.gz: 4e5432869b0470ae85fbee9d6efbc57130b07944f5960eb7ee4832a848068caf56445b5846434075206111262f17b12ce92564417ff56d90c3162ee5338f0bbc
+  metadata.gz: 5ea1e04a1d153839e8102ab204eec74c8e1ad92adab944fda1a2e2bb5e017fac7352daaf9fa95f05d79ad340dc6e36a148569636e8347998de862cf3e05a6671
+  data.tar.gz: 8c1fb7172e0280961705f64c950cd442b3d070400d78b5ae7e5b2e69537ecc877f7c5d34e3e03a6cf471755bf4f99d9243bcf2ee37ac4d46dc90d8203857208a

data/bake/traces/capture.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023-2025, by Samuel Williams.
+
+# Enable capturing traces.
+def capture
+	ENV["TRACES_BACKEND"] = "traces/backend/capture"
+	require "traces"
+end
+
+# Generate a list of traces that have been captured.
+def list
+	Traces::Backend::Capture.spans.sort_by!{|span| span.name}
+end

data/bake/traces/provider.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+# List available providers for traces from all loaded gems.
+def list
+	available = {}
+	
+	Gem.loaded_specs.each do |name, spec|
+		spec.require_paths.each do |require_path|
+			root = File.expand_path(require_path, spec.full_gem_path)
+			Dir.glob("traces/provider/**/*.rb", base: root).each do |path|
+				(available[name] ||= []) << path
+			end
+		end
+	end
+	
+	return available
+end

data/lib/traces/backend/capture.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2025, by Samuel Williams.
 
-require_relative '../context'
+require_relative "../context"
 
-require 'fiber'
+require "fiber"
 
 Fiber.attr_accessor :traces_backend_context
 

data/lib/traces/backend/console.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative '../context'
+require_relative "../context"
 
-require 'console'
-require 'fiber'
+require "console"
+require "fiber"
 
 Fiber.attr_accessor :traces_backend_context
 

data/lib/traces/backend/test.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative '../context'
+require_relative "../context"
 
-require 'fiber'
+require "fiber"
 
 Fiber.attr_accessor :traces_backend_context
 

data/lib/traces/backend.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2021-2025, by Samuel Williams.
 
-require_relative 'config'
+require_relative "config"
 
 module Traces
 	# The backend implementation is responsible for recording and reporting traces.

data/lib/traces/config.rb

@@ -33,7 +33,7 @@ module Traces
 		
 		# Require a specific traces backend implementation.
 		def require_backend(env = ENV)
-			if backend = env['TRACES_BACKEND']
+			if backend = env["TRACES_BACKEND"]
 				begin
 					if require(backend)
 						# We ensure that the interface methods replace any existing methods by prepending the module:

data/lib/traces/context.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require 'securerandom'
+require "securerandom"
 
 module Traces
 	# A generic representation of the current tracing context.
@@ -12,17 +12,17 @@ module Traces
 		# @parameter parent [String] The parent trace context.
 		# @parameter state [Array(String)] Any attached trace state.
 		def self.parse(parent, state = nil, **options)
-			version, trace_id, parent_id, flags = parent.split('-')
+			version, trace_id, parent_id, flags = parent.split("-")
 			
-			if version == '00'
+			if version == "00"
 				flags = Integer(flags, 16)
 				
 				if state.is_a?(String)
-					state = state.split(',')
+					state = state.split(",")
 				end
 				
 				if state
-					state = state.map{|item| item.split('=')}.to_h
+					state = state.map{|item| item.split("=")}.to_h
 				end
 				
 				self.new(trace_id, parent_id, flags, state, **options)

data/lib/traces/provider.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative 'backend'
+require_relative "backend"
 
 module Traces
 	# @returns [Boolean] Whether there is an active backend.

data/lib/traces/version.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
 module Traces
-	VERSION = "0.15.2"
+	VERSION = "0.16.2"
 end

data/lib/traces.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative 'traces/version'
-require_relative 'traces/provider'
+require_relative "traces/version"
+require_relative "traces/provider"
 
 # @namespace
 module Traces

data/license.md

@@ -1,7 +1,8 @@
 # MIT License
 
-Copyright, 2021-2024, by Samuel Williams.  
+Copyright, 2021-2025, by Samuel Williams.  
 Copyright, 2022, by Felix Yan.  
+Copyright, 2024, by Zach Taylor.  
 
 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

@@ -23,6 +23,10 @@ Please see the [project documentation](https://socketry.github.io/traces/) for m
 
 Please see the [project releases](https://socketry.github.io/traces/releases/index) for all releases.
 
+### v0.16.0
+
+  - Introduce `traces:provider:list` command to list all available trace providers.
+
 ### v0.14.0
 
   - [Introduce `Traces::Config` to Expose `prepare` Hook](https://socketry.github.io/traces/releases/index#introduce-traces::config-to-expose-prepare-hook)

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.16.0
+
+  - Introduce `traces:provider:list` command to list all available trace providers.
+
 ## v0.14.0
 
 ### Introduce `Traces::Config` to Expose `prepare` Hook

metadata

@@ -1,11 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: traces
 version: !ruby/object:Gem::Version
-  version: 0.15.2
+  version: 0.16.2
 platform: ruby
 authors:
 - Samuel Williams
 - Felix Yan
+- Zach Taylor
 bindir: bin
 cert_chain:
 - |
@@ -37,12 +38,14 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-02-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- bake/traces/capture.rb
+- bake/traces/provider.rb
 - lib/traces.rb
 - lib/traces/backend.rb
 - lib/traces/backend/capture.rb
@@ -68,14 +71,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Application instrumentation and tracing.
 test_files: []

metadata.gz.sig

@@ -1,4 +1,5 @@
-wMe/E-C�
-����*U�"��L�z�����0���B��i��A]w�
-�����
�4�S3'���9�!s�=e02�{a ����ߒy_D���i4(DE�'��-A��Q=��Պk�ruz�^��(�W�
-�*���*Ki&*�k���SRP���Ega�}d^$%�%�k�0�g^b���&�Y���r s8����8���`�{N�쟵�~�%�ǐ5�;
-�����,Cѷ
+���"1(�hy5Y��<���*niSK'˾��3oܾ�Ô�S��۞kE�%�f�x �Wш�6
+I��&hs�9�1�mH�&��0Mo�p@L��E® .���Ϣ�gt����b1�._�x
+�#nB�#�y������9�ڂ��]��YN)~�!o.TB��sw$�a�2"	����d�2Q�p�؃{E�h3�-��$F�Q+T3͗;�$�J�� �m�j���~�T=�C%ж����"Ja���䬻�\V��dy(��J,˭�7Ę�g�7�ꪴm{��ܤ��fΰ/�Dȥ���7@xo���:5B����W{{-V��(d
+���f�
+�1_K��}�-�)�?�t�Mh����QDŽ�