opentelemetry-propagator-b3 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13556a8ad4843308103d63e92356c269c87be42826bf0a026131b90eae0c0792
-  data.tar.gz: 9f7949588ae2a6b554b0bf3406acc05ce0c47008b06e83d3c0d04a9c23928ace
+  metadata.gz: d8bb36f87a6d784d8889edf5d733410b48567f33d4a4c41d40f750e5a36ac989
+  data.tar.gz: ebd953a02b5045be4a44bb18c5d6094cf3198523b8b905b86023bb6732c0e695
 SHA512:
-  metadata.gz: 8ff23eb11e5434e66be786ff15af0138f8d5c1a16cd7c852ce2f1a64262a2a7e561bd21201e72d3824b7a9ff6f691cd74fb41f6a349a5d50b9b8a9f03b072b3f
-  data.tar.gz: ba6f63d852685d0f651e0bb8512fea83ad357db2a5f925832e940acac773362f498eae5f39709a7aa1afe262e0279d5edf104f18df4846ba1d229c283de16990
+  metadata.gz: 2ddfc1c88bd19aa81b049d9ef832de04bc321dd0219a44b01937a656f6d6b14061b0a7b452067b9844dea537c9d73ba5e26ad5301870262cb82af05cafcbbeec
+  data.tar.gz: 31e80b987d02727a2daba0fd489605daed15881890726eec64422d77842700e7dc8ba00d49d0318bddc95427a0855366a72bdcfc2bea1fbb41615e13d1da2a04

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History: opentelemetry-propagator-b3
 
+### v0.17.0 / 2021-04-22
+
+* BREAKING CHANGE: Replace TextMapInjector/TextMapExtractor pairs with a TextMapPropagator.
+
+  [Check the propagator documentation](https://open-telemetry.github.io/opentelemetry-ruby/) for the new usage.
+
+* FIXED: Refactor propagators to add #fields 
+
 ### v0.16.0 / 2021-03-17
 
 * DOCS: Replace Gitter with GitHub Discussions 

data/lib/opentelemetry/propagator/b3.rb

@@ -31,28 +31,11 @@ module OpenTelemetry
       def debug?(context)
         context.value(DEBUG_CONTEXT_KEY)
       end
-
-      # @api private
-      # Convert an id from a hex encoded string to byte array, optionally left
-      # padding to the correct length. Assumes the input id has already been
-      # validated to be 16 or 32 characters in length.
-      def to_trace_id(hex_id)
-        if hex_id.length == 32
-          Array(hex_id).pack('H*')
-        else
-          [0, hex_id].pack('qH*')
-        end
-      end
-
-      # @api private
-      # Convert an id from a hex encoded string to byte array.
-      def to_span_id(hex_id)
-        Array(hex_id).pack('H*')
-      end
     end
   end
 end
 
 require_relative './b3/version'
+require_relative './b3/text_map_extractor'
 require_relative './b3/multi'
 require_relative './b3/single'

data/lib/opentelemetry/propagator/b3/multi.rb

@@ -4,8 +4,7 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-require_relative './multi/text_map_extractor'
-require_relative './multi/text_map_injector'
+require_relative './multi/text_map_propagator'
 
 # OpenTelemetry is an open source observability framework, providing a
 # general-purpose API, SDK, and related tools required for the instrumentation
@@ -18,30 +17,18 @@ module OpenTelemetry
   module Propagator
     # Namespace for OpenTelemetry B3 propagation
     module B3
-      # Namespace for OpenTelemetry b3 multi header encoding
+      # Namespace for OpenTelemetry B3 multi header encoding
       module Multi
         extend self
 
-        B3_TRACE_ID_KEY = 'X-B3-TraceId'
-        B3_SPAN_ID_KEY = 'X-B3-SpanId'
-        B3_SAMPLED_KEY = 'X-B3-Sampled'
-        B3_FLAGS_KEY = 'X-B3-Flags'
-        TEXT_MAP_EXTRACTOR = TextMapExtractor.new
-        TEXT_MAP_INJECTOR = TextMapInjector.new
+        TEXT_MAP_PROPAGATOR = TextMapPropagator.new
 
-        private_constant :B3_TRACE_ID_KEY, :B3_SPAN_ID_KEY, :B3_SAMPLED_KEY,
-                         :B3_FLAGS_KEY, :TEXT_MAP_INJECTOR, :TEXT_MAP_EXTRACTOR
+        private_constant :TEXT_MAP_PROPAGATOR
 
-        # Returns an extractor that extracts context in the B3 multi header
-        # format
-        def text_map_injector
-          TEXT_MAP_INJECTOR
-        end
-
-        # Returns an injector that injects context in the B3 multi header
-        # format
-        def text_map_extractor
-          TEXT_MAP_EXTRACTOR
+        # Returns a text map propagator that propagates context using the
+        # B3 multi header format.
+        def text_map_propagator
+          TEXT_MAP_PROPAGATOR
         end
       end
     end

data/lib/opentelemetry/propagator/b3/multi/text_map_propagator.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# OpenTelemetry is an open source observability framework, providing a
+# general-purpose API, SDK, and related tools required for the instrumentation
+# of cloud-native software, frameworks, and libraries.
+#
+# The OpenTelemetry module provides global accessors for telemetry objects.
+# See the documentation for the `opentelemetry-api` gem for details.
+module OpenTelemetry
+  # Namespace for OpenTelemetry propagator extension libraries
+  module Propagator
+    # Namespace for OpenTelemetry B3 propagation
+    module B3
+      # Namespace for OpenTelemetry B3 multi header encoding
+      module Multi
+        # Propagates trace context using the B3 multi header format
+        class TextMapPropagator
+          include TextMapExtractor
+
+          FIELDS = [B3_TRACE_ID_KEY, B3_SPAN_ID_KEY, B3_SAMPLED_KEY, B3_FLAGS_KEY].freeze
+
+          private_constant :FIELDS
+
+          # Inject trace context into the supplied carrier.
+          #
+          # @param [Carrier] carrier The mutable carrier to inject trace context into
+          # @param [Context] context The context to read trace context from
+          # @param [optional Setter] setter If the optional setter is provided, it
+          #   will be used to write context into the carrier, otherwise the default
+          #   text map setter will be used.
+          def inject(carrier, context: Context.current, setter: Context::Propagation.text_map_setter)
+            span_context = Trace.current_span(context).context
+            return unless span_context.valid?
+
+            setter.set(carrier, B3_TRACE_ID_KEY, span_context.hex_trace_id)
+            setter.set(carrier, B3_SPAN_ID_KEY, span_context.hex_span_id)
+
+            if B3.debug?(context)
+              setter.set(carrier, B3_FLAGS_KEY, '1')
+            elsif span_context.trace_flags.sampled?
+              setter.set(carrier, B3_SAMPLED_KEY, '1')
+            else
+              setter.set(carrier, B3_SAMPLED_KEY, '0')
+            end
+
+            nil
+          end
+
+          # Returns the predefined propagation fields. If your carrier is reused, you
+          # should delete the fields returned by this method before calling +inject+.
+          #
+          # @return [Array<String>] a list of fields that will be used by this propagator.
+          def fields
+            FIELDS
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/propagator/b3/single.rb

@@ -4,8 +4,7 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-require_relative './single/text_map_extractor'
-require_relative './single/text_map_injector'
+require_relative './single/text_map_propagator'
 
 # OpenTelemetry is an open source observability framework, providing a
 # general-purpose API, SDK, and related tools required for the instrumentation
@@ -18,26 +17,18 @@ module OpenTelemetry
   module Propagator
     # Namespace for OpenTelemetry B3 propagation
     module B3
-      # Namespace for OpenTelemetry b3 single header encoding
+      # Namespace for OpenTelemetry B3 single header encoding
       module Single
         extend self
 
-        B3_CONTEXT_KEY = 'b3'
-        TEXT_MAP_EXTRACTOR = TextMapExtractor.new
-        TEXT_MAP_INJECTOR = TextMapInjector.new
+        TEXT_MAP_PROPAGATOR = TextMapPropagator.new
 
-        private_constant :B3_CONTEXT_KEY, :TEXT_MAP_INJECTOR, :TEXT_MAP_EXTRACTOR
+        private_constant :TEXT_MAP_PROPAGATOR
 
-        # Returns an extractor that extracts context in the B3 single header
-        # format
-        def text_map_injector
-          TEXT_MAP_INJECTOR
-        end
-
-        # Returns an injector that injects context in the B3 single header
-        # format
-        def text_map_extractor
-          TEXT_MAP_EXTRACTOR
+        # Returns a text map propagator that propagates context using the
+        # B3 single header format.
+        def text_map_propagator
+          TEXT_MAP_PROPAGATOR
         end
       end
     end

data/lib/opentelemetry/propagator/b3/single/text_map_propagator.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# OpenTelemetry is an open source observability framework, providing a
+# general-purpose API, SDK, and related tools required for the instrumentation
+# of cloud-native software, frameworks, and libraries.
+#
+# The OpenTelemetry module provides global accessors for telemetry objects.
+# See the documentation for the `opentelemetry-api` gem for details.
+module OpenTelemetry
+  # Namespace for OpenTelemetry propagator extension libraries
+  module Propagator
+    # Namespace for OpenTelemetry B3 propagation
+    module B3
+      # Namespace for OpenTelemetry b3 single header encoding
+      module Single
+        # Propagates trace context using the b3 single header format
+        class TextMapPropagator
+          include TextMapExtractor
+
+          FIELDS = [B3_CONTEXT_KEY].freeze
+
+          private_constant :FIELDS
+
+          # Inject trace context into the supplied carrier.
+          #
+          # @param [Carrier] carrier The mutable carrier to inject trace context into
+          # @param [Context] context The context to read trace context from
+          # @param [optional Setter] setter If the optional setter is provided, it
+          #   will be used to write context into the carrier, otherwise the default
+          #   text map setter will be used.
+          def inject(carrier, context: Context.current, setter: Context::Propagation.text_map_setter)
+            span_context = Trace.current_span(context).context
+            return unless span_context.valid?
+
+            sampling_state = if B3.debug?(context)
+                               'd'
+                             elsif span_context.trace_flags.sampled?
+                               '1'
+                             else
+                               '0'
+                             end
+
+            b3_value = "#{span_context.hex_trace_id}-#{span_context.hex_span_id}-#{sampling_state}"
+
+            setter.set(carrier, B3_CONTEXT_KEY, b3_value)
+            nil
+          end
+
+          # Returns the predefined propagation fields. If your carrier is reused, you
+          # should delete the fields returned by this method before calling +inject+.
+          #
+          # @return [Array<String>] a list of fields that will be used by this propagator.
+          def fields
+            FIELDS
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/propagator/b3/text_map_extractor.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# OpenTelemetry is an open source observability framework, providing a
+# general-purpose API, SDK, and related tools required for the instrumentation
+# of cloud-native software, frameworks, and libraries.
+#
+# The OpenTelemetry module provides global accessors for telemetry objects.
+# See the documentation for the `opentelemetry-api` gem for details.
+module OpenTelemetry
+  # Namespace for OpenTelemetry propagator extension libraries
+  module Propagator
+    # Namespace for OpenTelemetry B3 propagation
+    module B3
+      # Extracts trace context using the b3 single or multi header formats, favouring b3 single header.
+      module TextMapExtractor
+        B3_CONTEXT_REGEX = /\A(?<trace_id>(?:[0-9a-f]{16}){1,2})-(?<span_id>[0-9a-f]{16})(?:-(?<sampling_state>[01d](?![0-9a-f])))?(?:-(?<parent_span_id>[0-9a-f]{16}))?\z/.freeze
+        B3_TRACE_ID_REGEX = /\A(?:[0-9a-f]{16}){1,2}\z/.freeze
+        B3_SPAN_ID_REGEX = /\A[0-9a-f]{16}\z/.freeze
+        SAMPLED_VALUES = %w[1 true].freeze
+
+        B3_CONTEXT_KEY = 'b3'
+        B3_TRACE_ID_KEY = 'X-B3-TraceId'
+        B3_SPAN_ID_KEY = 'X-B3-SpanId'
+        B3_SAMPLED_KEY = 'X-B3-Sampled'
+        B3_FLAGS_KEY = 'X-B3-Flags'
+
+        private_constant :B3_CONTEXT_REGEX, :B3_TRACE_ID_REGEX, :B3_SPAN_ID_REGEX, :SAMPLED_VALUES
+        private_constant :B3_CONTEXT_KEY, :B3_TRACE_ID_KEY, :B3_SPAN_ID_KEY, :B3_SAMPLED_KEY, :B3_FLAGS_KEY
+
+        # Extract trace context from the supplied carrier. The b3 single header takes
+        # precedence over the multi-header format.
+        # If extraction fails, the original context will be returned.
+        #
+        # @param [Carrier] carrier The carrier to get the header from
+        # @param [optional Context] context Context to be updated with the trace context
+        #   extracted from the carrier. Defaults to +Context.current+.
+        # @param [optional Getter] getter If the optional getter is provided, it
+        #   will be used to read the header from the carrier, otherwise the default
+        #   text map getter will be used.
+        #
+        # @return [Context] context updated with extracted baggage, or the original context
+        #   if extraction fails
+        def extract(carrier, context: Context.current, getter: Context::Propagation.text_map_getter)
+          extract_b3_single_header(carrier, context, getter) || extract_b3_multi_header(carrier, context, getter) || context
+        end
+
+        private
+
+        def extract_b3_single_header(carrier, context, getter)
+          match = getter.get(carrier, B3_CONTEXT_KEY)&.match(B3_CONTEXT_REGEX)
+          return unless match
+
+          debug = match['sampling_state'] == 'd'
+          sampled = debug || match['sampling_state'] == '1'
+          extracted_context(match['trace_id'], match['span_id'], sampled, debug, context)
+        end
+
+        def extract_b3_multi_header(carrier, context, getter)
+          trace_id_hex = getter.get(carrier, B3_TRACE_ID_KEY)
+          return unless B3_TRACE_ID_REGEX.match?(trace_id_hex)
+
+          span_id_hex = getter.get(carrier, B3_SPAN_ID_KEY)
+          return unless B3_SPAN_ID_REGEX.match?(span_id_hex)
+
+          sampled = getter.get(carrier, B3_SAMPLED_KEY)
+          flags = getter.get(carrier, B3_FLAGS_KEY)
+
+          debug = flags == '1'
+          sampled = debug || SAMPLED_VALUES.include?(sampled)
+          extracted_context(trace_id_hex, span_id_hex, sampled, debug, context)
+        end
+
+        def extracted_context(trace_id_hex, span_id_hex, sampled, debug, context)
+          span_context = Trace::SpanContext.new(
+            trace_id: to_trace_id(trace_id_hex),
+            span_id: to_span_id(span_id_hex),
+            trace_flags: to_trace_flags(sampled),
+            remote: true
+          )
+
+          span = Trace::Span.new(span_context: span_context)
+          context = B3.context_with_debug(context) if debug
+          Trace.context_with_span(span, parent_context: context)
+        end
+
+        def to_trace_flags(sampled)
+          if sampled
+            Trace::TraceFlags::SAMPLED
+          else
+            Trace::TraceFlags::DEFAULT
+          end
+        end
+
+        # Convert an id from a hex encoded string to byte array, optionally left
+        # padding to the correct length. Assumes the input id has already been
+        # validated to be 16 or 32 characters in length.
+        def to_trace_id(hex_id)
+          if hex_id.length == 32
+            Array(hex_id).pack('H*')
+          else
+            [0, hex_id].pack('qH*')
+          end
+        end
+
+        # Convert an id from a hex encoded string to byte array.
+        def to_span_id(hex_id)
+          Array(hex_id).pack('H*')
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/propagator/b3/version.rb

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Propagator
     module B3
-      VERSION = '0.16.0'
+      VERSION = '0.17.0'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-propagator-b3
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-22 00:00:00.000000000 Z
+date: 2021-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -136,20 +136,19 @@ files:
 - lib/opentelemetry-propagator-b3.rb
 - lib/opentelemetry/propagator/b3.rb
 - lib/opentelemetry/propagator/b3/multi.rb
-- lib/opentelemetry/propagator/b3/multi/text_map_extractor.rb
-- lib/opentelemetry/propagator/b3/multi/text_map_injector.rb
+- lib/opentelemetry/propagator/b3/multi/text_map_propagator.rb
 - lib/opentelemetry/propagator/b3/single.rb
-- lib/opentelemetry/propagator/b3/single/text_map_extractor.rb
-- lib/opentelemetry/propagator/b3/single/text_map_injector.rb
+- lib/opentelemetry/propagator/b3/single/text_map_propagator.rb
+- lib/opentelemetry/propagator/b3/text_map_extractor.rb
 - lib/opentelemetry/propagator/b3/version.rb
 homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-propagator-b3/v0.16.0/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-propagator-b3/v0.17.0/file.CHANGELOG.html
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/propagator/b3
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-propagator-b3/v0.16.0
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-propagator-b3/v0.17.0
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -165,7 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: B3 Context Propagation Extension for the OpenTelemetry framework

data/lib/opentelemetry/propagator/b3/multi/text_map_extractor.rb

@@ -1,98 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-# OpenTelemetry is an open source observability framework, providing a
-# general-purpose API, SDK, and related tools required for the instrumentation
-# of cloud-native software, frameworks, and libraries.
-#
-# The OpenTelemetry module provides global accessors for telemetry objects.
-# See the documentation for the `opentelemetry-api` gem for details.
-module OpenTelemetry
-  # Namespace for OpenTelemetry propagator extension libraries
-  module Propagator
-    # Namespace for OpenTelemetry B3 propagation
-    module B3
-      # Namespace for OpenTelemetry b3 multi header encoding
-      module Multi
-        # Extracts context from carriers in the b3 single header format
-        class TextMapExtractor
-          B3_TRACE_ID_REGEX = /\A(?:[0-9a-f]{16}){1,2}\z/.freeze
-          B3_SPAN_ID_REGEX = /\A[0-9a-f]{16}\z/.freeze
-          SAMPLED_VALUES = %w[1 true].freeze
-          DEBUG_FLAG = '1'
-          private_constant :B3_TRACE_ID_REGEX, :B3_SPAN_ID_REGEX, :SAMPLED_VALUES, :DEBUG_FLAG
-
-          # Returns a new TextMapExtractor that extracts b3 context using the
-          # specified getter
-          #
-          # @param [optional Getter] default_getter The default getter used to read
-          #   headers from a carrier during extract. Defaults to a
-          #   {OpenTelemetry::Context:Propagation::TextMapGetter} instance.
-          # @return [TextMapExtractor]
-          def initialize(default_getter = Context::Propagation.text_map_getter)
-            @default_getter = default_getter
-          end
-
-          # Extract b3 context from the supplied carrier and set the active span
-          # in the given context. The original context will be returned if b3
-          # cannot be extracted from the carrier.
-          #
-          # @param [Carrier] carrier The carrier to get the header from.
-          # @param [Context] context The context to be updated with extracted context
-          # @param [optional Getter] getter If the optional getter is provided, it
-          #   will be used to read the header from the carrier, otherwise the default
-          #   getter will be used.
-          # @return [Context] Updated context with active span derived from the header, or the original
-          #   context if parsing fails.
-          def extract(carrier, context, getter = nil)
-            getter ||= @default_getter
-
-            trace_id_hex = getter.get(carrier, B3_TRACE_ID_KEY)
-            return context unless valid_trace_id?(trace_id_hex)
-
-            span_id_hex = getter.get(carrier, B3_SPAN_ID_KEY)
-            return context unless valid_span_id?(span_id_hex)
-
-            sampled = getter.get(carrier, B3_SAMPLED_KEY)
-            flags = getter.get(carrier, B3_FLAGS_KEY)
-
-            context = B3.context_with_debug(context) if flags == DEBUG_FLAG
-
-            span_context = Trace::SpanContext.new(
-              trace_id: B3.to_trace_id(trace_id_hex),
-              span_id: B3.to_span_id(span_id_hex),
-              trace_flags: to_trace_flags(sampled, flags),
-              remote: true
-            )
-
-            span = Trace::Span.new(span_context: span_context)
-            Trace.context_with_span(span, parent_context: context)
-          rescue OpenTelemetry::Error
-            context
-          end
-
-          private
-
-          def to_trace_flags(sampled, b3_flags)
-            if b3_flags == DEBUG_FLAG || SAMPLED_VALUES.include?(sampled)
-              Trace::TraceFlags::SAMPLED
-            else
-              Trace::TraceFlags::DEFAULT
-            end
-          end
-
-          def valid_trace_id?(trace_id)
-            B3_TRACE_ID_REGEX.match?(trace_id)
-          end
-
-          def valid_span_id?(span_id)
-            B3_SPAN_ID_REGEX.match?(span_id)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/propagator/b3/multi/text_map_injector.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-module OpenTelemetry
-  # Namespace for OpenTelemetry propagator extension libraries
-  module Propagator
-    # Namespace for OpenTelemetry B3 propagation
-    module B3
-      # Namespace for OpenTelemetry b3 single header encoding
-      module Multi
-        # Injects context into carriers using the b3 single header format
-        class TextMapInjector
-          # Returns a new TextMapInjector that injects b3 context using the
-          # specified setter
-          #
-          # @param [optional Setter] default_setter The default setter used to
-          #   write context into a carrier during inject. Defaults to a
-          #   {OpenTelemetry::Context:Propagation::TextMapSetter} instance.
-          # @return [TextMapInjector]
-          def initialize(default_setter = Context::Propagation.text_map_setter)
-            @default_setter = default_setter
-          end
-
-          # Set the span context on the supplied carrier.
-          #
-          # @param [Context] context The active Context.
-          # @param [optional Setter] setter If the optional setter is provided, it
-          #   will be used to write context into the carrier, otherwise the default
-          #   setter will be used.
-          # @return [Object] the carrier with context injected
-          def inject(carrier, context, setter = nil)
-            span_context = Trace.current_span(context).context
-            return unless span_context.valid?
-
-            setter ||= @default_setter
-            setter.set(carrier, B3_TRACE_ID_KEY, span_context.hex_trace_id)
-            setter.set(carrier, B3_SPAN_ID_KEY, span_context.hex_span_id)
-
-            if B3.debug?(context)
-              setter.set(carrier, B3_FLAGS_KEY, '1')
-            elsif span_context.trace_flags.sampled?
-              setter.set(carrier, B3_SAMPLED_KEY, '1')
-            else
-              setter.set(carrier, B3_SAMPLED_KEY, '0')
-            end
-
-            carrier
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/propagator/b3/single/text_map_extractor.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-# OpenTelemetry is an open source observability framework, providing a
-# general-purpose API, SDK, and related tools required for the instrumentation
-# of cloud-native software, frameworks, and libraries.
-#
-# The OpenTelemetry module provides global accessors for telemetry objects.
-# See the documentation for the `opentelemetry-api` gem for details.
-module OpenTelemetry
-  # Namespace for OpenTelemetry propagator extension libraries
-  module Propagator
-    # Namespace for OpenTelemetry B3 propagation
-    module B3
-      # Namespace for OpenTelemetry b3 single header encoding
-      module Single
-        # Extracts context from carriers in the b3 single header format
-        class TextMapExtractor
-          B3_CONTEXT_REGEX = /\A(?<trace_id>(?:[0-9a-f]{16}){1,2})-(?<span_id>[0-9a-f]{16})(?:-(?<sampling_state>[01d](?![0-9a-f])))?(?:-(?<parent_span_id>[0-9a-f]{16}))?\z/.freeze
-          SAMPLED_VALUES = %w[1 d].freeze
-
-          # Returns a new TextMapExtractor that extracts b3 context using the
-          # specified getter
-          #
-          # @param [optional Getter] default_getter The default getter used to read
-          #   headers from a carrier during extract. Defaults to a
-          #   {OpenTelemetry::Context:Propagation::TextMapGetter} instance.
-          # @return [TextMapExtractor]
-          def initialize(default_getter = Context::Propagation.text_map_getter)
-            @default_getter = default_getter
-          end
-
-          # Extract b3 context from the supplied carrier and set the active span
-          # in the given context. The original context will be returned if b3
-          # cannot be extracted from the carrier.
-          #
-          # @param [Carrier] carrier The carrier to get the header from.
-          # @param [Context] context The context to be updated with extracted context
-          # @param [optional Getter] getter If the optional getter is provided, it
-          #   will be used to read the header from the carrier, otherwise the default
-          #   getter will be used.
-          # @return [Context] Updated context with active span derived from the header, or the original
-          #   context if parsing fails.
-          def extract(carrier, context, getter = nil)
-            getter ||= @default_getter
-            header = getter.get(carrier, B3_CONTEXT_KEY)
-            return context unless (match = header.match(B3_CONTEXT_REGEX))
-
-            span_context = Trace::SpanContext.new(
-              trace_id: B3.to_trace_id(match['trace_id']),
-              span_id: B3.to_span_id(match['span_id']),
-              trace_flags: to_trace_flags(match['sampling_state']),
-              remote: true
-            )
-
-            span = Trace::Span.new(span_context: span_context)
-            context = B3.context_with_debug(context) if match['sampling_state'] == 'd'
-            Trace.context_with_span(span, parent_context: context)
-          rescue OpenTelemetry::Error
-            context
-          end
-
-          private
-
-          def to_trace_flags(sampling_state)
-            if SAMPLED_VALUES.include?(sampling_state)
-              Trace::TraceFlags::SAMPLED
-            else
-              Trace::TraceFlags::DEFAULT
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/propagator/b3/single/text_map_injector.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-module OpenTelemetry
-  # Namespace for OpenTelemetry propagator extension libraries
-  module Propagator
-    # Namespace for OpenTelemetry B3 propagation
-    module B3
-      # Namespace for OpenTelemetry b3 single header encoding
-      module Single
-        # Injects context into carriers using the b3 single header format
-        class TextMapInjector
-          # Returns a new TextMapInjector that injects b3 context using the
-          # specified setter
-          #
-          # @param [optional Setter] default_setter The default setter used to
-          #   write context into a carrier during inject. Defaults to a
-          #   {OpenTelemetry::Context:Propagation::TextMapSetter} instance.
-          # @return [TextMapInjector]
-          def initialize(default_setter = Context::Propagation.text_map_setter)
-            @default_setter = default_setter
-          end
-
-          # Set the span context on the supplied carrier.
-          #
-          # @param [Context] context The active Context.
-          # @param [optional Setter] setter If the optional setter is provided, it
-          #   will be used to write context into the carrier, otherwise the default
-          #   setter will be used.
-          # @return [Object] the carrier with context injected
-          def inject(carrier, context, setter = nil)
-            span_context = Trace.current_span(context).context
-            return unless span_context.valid?
-
-            sampling_state = if B3.debug?(context)
-                               'd'
-                             elsif span_context.trace_flags.sampled?
-                               '1'
-                             else
-                               '0'
-                             end
-
-            b3_value = "#{span_context.hex_trace_id}-#{span_context.hex_span_id}-#{sampling_state}"
-
-            setter ||= @default_setter
-            setter.set(carrier, B3_CONTEXT_KEY, b3_value)
-            carrier
-          end
-        end
-      end
-    end
-  end
-end