traces-backend-open_telemetry 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a6e7b852d0e639afb7711bb341ff286b03c6551f93c7bad739d925e970bdf0b
-  data.tar.gz: 66e01999506279ab1934878f9728c54d71f0fa1bb2b79b9ae14043c6eaac85f7
+  metadata.gz: e827995b4fdb7c14068483b4a7796eb958378f4ad093c59f7d86be165d8b91f2
+  data.tar.gz: 1fa19c544b849a9a761ae757ec9198767432517106187d801d6f0e0f836522a1
 SHA512:
-  metadata.gz: d6ff7a3fd2e174c1ed038dae1c1bbb7cc76cfd9e1c61d46b3a3ec9f4d6c3b43266b6249e95fecd27b71c46799ddaa84e880f0f862f74f0d0a0a794f5310cedc3
-  data.tar.gz: ea506e7dc7d917947c0fbfdeb9e287a5b8abaa6d1b8b69668dbbb21234604214aed7ad6772311fdde90e9e9a25fa68612c879002b0f86a51893fb1c59c549da0
+  metadata.gz: 3d08dd5e72d329c9f114e7f10bad100144ca856f52d2e966cc52161a6cbf59c3c4bfa4ed4b5653e33c6c036f96ca6b4b71fa534ef944d5b68176a08623a0444c
+  data.tar.gz: d7115c5989a4ecb957a285382744b61e565cf9951668998cc0edd4596bd35507cde8f913b5fd34c95a2f2788d9891182d3f7e8e02462a3f68e0eeff33eff7091

data/lib/traces/backend/open_telemetry/interface.rb

@@ -21,17 +21,19 @@ module Traces
 				end
 				
 				def trace_context=(context)
-					span_context = ::OpenTelemetry::Trace::SpanContext.new(
-						trace_id: context.trace_id,
-						span_id: context.parent_id,
-						trace_flags: ::OpenTelemetry::Trace::TraceFlags.from_byte(context.flags),
-						tracestate: context.state,
-						remote: context.remote?
-					)
-					
-					span = ::OpenTelemetry::Trace.non_recording_span(span_context)
-					context = ::OpenTelemetry::Trace.context_with_span(span)
-					::OpenTelemetry::Context.attach(context)
+					if context
+						span_context = ::OpenTelemetry::Trace::SpanContext.new(
+							trace_id: context.trace_id,
+							span_id: context.parent_id,
+							trace_flags: ::OpenTelemetry::Trace::TraceFlags.from_byte(context.flags),
+							tracestate: context.state,
+							remote: context.remote?
+						)
+						
+						span = ::OpenTelemetry::Trace.non_recording_span(span_context)
+						context = ::OpenTelemetry::Trace.context_with_span(span)
+						::OpenTelemetry::Context.attach(context)
+					end
 				end
 				
 				def trace_context(span = ::OpenTelemetry::Trace.current_span)
@@ -51,6 +53,40 @@ module Traces
 						)
 					end
 				end
+				
+				def current_context
+					::OpenTelemetry::Context.current
+				end
+				
+				def with_context(context)
+					if block_given?
+						::OpenTelemetry::Context.with_current(context) do
+							yield
+						end
+					else
+						::OpenTelemetry::Context.attach(context)
+					end
+				end
+				
+				def inject(headers = nil, context = nil)
+					context ||= ::OpenTelemetry::Context.current
+					headers ||= Hash.new
+					
+					count = headers.count
+					
+					::OpenTelemetry.propagation.inject(headers, context: context)
+					
+					if count == headers.count
+						# No injection was performed, so return nil:
+						headers = nil
+					end
+					
+					return headers
+				end
+				
+				def extract(headers)
+					::OpenTelemetry.propagation.extract(headers)
+				end
 			end
 		end
 		

data/lib/traces/backend/open_telemetry/version.rb

@@ -6,7 +6,7 @@
 module Traces
 	module Backend
 		module OpenTelemetry
-			VERSION = "0.2.0"
+			VERSION = "0.3.0"
 		end
 	end
 end

data/readme.md

@@ -12,9 +12,25 @@ $ bundle add traces-backend-open_telemetry
 
 ## Usage
 
-``` shell
-$ TRACES_BACKEND=traces/backend/open_telemetry ./my_script.rb
-```
+Please see the [project documentation](https://github.com/socketry/traces-backend-open_telemetry) for more details.
+
+  - [Getting Started](https://github.com/socketry/traces-backend-open_telemetryguides/getting-started/index) - This guide explains how to get started with `traces-backend-open_telemetry` to send application traces to OpenTelemetry.
+
+## Releases
+
+Please see the [project releases](https://github.com/socketry/traces-backend-open_telemetryreleases/index) for all releases.
+
+### v0.3.0
+
+  - [New Context Propagation Interface](https://github.com/socketry/traces-backend-open_telemetryreleases/index#new-context-propagation-interface)
+
+### v0.2.0
+
+  - Prefer to use `Tracer#in_span`.
+
+### v0.1.0
+
+  - Complete implementation of traces backend for OpenTelemetry.
 
 ## Contributing
 

data/releases.md

@@ -0,0 +1,20 @@
+# Releases
+
+## v0.3.0
+
+### New Context Propagation Interface
+
+This release adds comprehensive support for OpenTelemetry's context propagation system, enabling efficient inter-process and intra-process tracing with full W3C compliance.
+
+  - `Traces.current_context` - Capture the current trace context for local propagation between execution contexts (threads, fibers).
+  - `Traces.with_context(context)` - Execute code within a specific trace context, with automatic restoration when used with blocks.
+  - `Traces.inject(headers = nil, context = nil)` - Inject W3C Trace Context and Baggage headers into a headers hash for distributed propagation.
+  - `Traces.extract(headers)` - Extract trace context from W3C Trace Context headers.
+
+## v0.2.0
+
+  - Prefer to use `Tracer#in_span`.
+
+## v0.1.0
+
+  - Complete implementation of traces backend for OpenTelemetry.

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: traces-backend-open_telemetry
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -37,7 +36,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-01-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -67,8 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.10'
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -78,12 +75,12 @@ files:
 - lib/traces/backend/open_telemetry/version.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/traces-backend-open_telemetry
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/socketry/traces-backend-open_telemetry.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -91,15 +88,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.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A traces backend for Open Telemetry.
 test_files: []

metadata.gz.sig

@@ -1,2 +1 @@
-��Y�yM�����t=�ܹJ)���rS��������L�b2�z�����-�����;k�jJ�|\T�D�zM=�j��]��tX5m�x�Q��߼��O[kɾ��~���ɕ�����syH��(�m��B.\O׊��8!�'�&4
-��J�!�/��V�͆�(g'ħ��"S{�F��5������m��o[C�
�x� #qN�x��H���9y\��:��ZG��k���T���Y�1vzm7&&|f.D�V#�֐01h�����SC�Q������|���]z�J\�[�i�qM^�v5/��eβ�9׮��r���ˈy��xp�q2�|�8���Q+��l!6+�g��N�x8B1R����Wdâ��f�LSr��UJq��
+BT�6�@�ۦ$ҩl�l*��<��!�M�ZR�