rspec-otel 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '081125f70f4963d1a9f414811abbbe65e0113a14131a0cc982a2ce9247b447c5'
-  data.tar.gz: ab28a32cc178212a05e0216ad84a6300eb4509c17537d4499df6d0b2dfa4fd30
+  metadata.gz: c2db5ebf1aa940bae5b290f6d6683e1f1bea754fc83e8eaf9997bb3971235244
+  data.tar.gz: 5c7b7ca60e93ca6ccf82479cfe3374c5420ab5be80484787c4cdc74ed67548cb
 SHA512:
-  metadata.gz: d867cbc82ace4ea550c9c14024dc91db343964d749a13075f9a947f4193cdfbbba434270ba85d6de01ae7cdfc919a5ad388a13d7dc903f9dbd06ed1ea4bde0f3
-  data.tar.gz: ff369cb3a9390130bdd354cc5ac99e7b0136525f8d39bb9c5fe793d2142843edc48a9556efe232b2b6397554561d1a17dfb2e39ae36fa6b2494a54af0ab23323
+  metadata.gz: f99a6e31d6acc0fc5dc26453690a7b66a6ed8352cc4790b26fccdad93dfa1692adaaa9f3f4fd5798c8d1e9084a8c509ebf1800936a3b4a1354ca3ddc6e9b701e
+  data.tar.gz: 12a5346b1eb3b3247d9d5d62e46aa1c4e3c13f891a0abdd72a2f2931e054f86bcc6d9634959faf65329689933af438075de259682b7357995bb596dfd8b5a008

data/README.md

@@ -37,7 +37,21 @@ RSpec.describe 'User API' do
   it 'emits a span' do
     expect do
       get :user, id: 1
-    end.to emit_span('GET /user').with_attributes({'user.id' => '1'})
+    end.to emit_span('GET /user')
+  end
+end
+```
+
+`emit_span` will also match a regular expression:
+
+```ruby
+require 'spec_helper'
+
+RSpec.describe 'User API' do
+  it 'emits a span' do
+    expect do
+      get :user, id: 1
+    end.to emit_span(/^GET /)
   end
 end
 ```
@@ -56,7 +70,22 @@ Several conditions can be added to the matcher:
 * `with_exception` - Will match only the spans that have the specified exception event.
 * `without_exception` - Will match only the spans that do not have the specified exception event.
 
-The `*_event` condition can be called multiple times with different events.
+_The `*_event` condition can be called multiple times with different events._
+
+
+### Disabling
+
+We wrap every example in a new OpenTelemetry SDK configuration by default, if you wish to disable this you can tag your example with `:rspec_otel_disable_tracing`:
+
+```ruby
+require 'spec_helper'
+
+RSpec.describe 'User API', :rspec_otel_disable_tracing do
+  it 'tests my code' do
+    expect(true).to be true
+  end
+end
+```
 
 ## Compatibility
 

data/lib/rspec_otel/matchers/emit_span.rb

@@ -7,9 +7,9 @@ module RspecOtel
 
       def initialize(name = nil)
         @name = name
-        @filters = [
-          ->(span) { span.name == name }
-        ]
+        @filters = []
+
+        add_name_filter
       end
 
       def matches?(block)
@@ -110,11 +110,11 @@ module RspecOtel
       end
 
       def failure_message
-        "expected span #{name} to have been emitted, but it couldn't be found"
+        "expected span #{failure_match_description} #{printable_name} to have been emitted, but it couldn't be found"
       end
 
       def failure_message_when_negated
-        "expected span #{name} to not have been emitted"
+        "expected span #{failure_match_description} #{printable_name} to not have been emitted"
       end
 
       def supports_block_expectations?
@@ -123,6 +123,35 @@ module RspecOtel
 
       private
 
+      def failure_match_description
+        case name
+        when String
+          'named'
+        when Regexp
+          'matching'
+        end
+      end
+
+      def printable_name
+        case name
+        when String
+          "'#{name}'"
+        when Regexp
+          name.inspect
+        end
+      end
+
+      def add_name_filter
+        @filters << lambda do |span|
+          case name
+          when String
+            span.name == name
+          when Regexp
+            span.name.match?(name)
+          end
+        end
+      end
+
       def exception_attributes(exception)
         attributes = {}
         unless exception.nil?

data/lib/rspec_otel/rspec.rb

@@ -3,16 +3,13 @@
 require 'rspec/core'
 
 RSpec.configure do |config|
-  config.before(:suite) do
-    span_processor = OpenTelemetry::SDK::Trace::Export::SimpleSpanProcessor.new(RspecOtel.exporter)
-
-    OpenTelemetry::SDK.configure do |c|
-      c.add_span_processor span_processor
-    end
-  end
-
   config.around(:each) do |example|
-    example.run
-    RspecOtel.exporter.reset
+    if example.metadata[:rspec_otel_disable_tracing]
+      example.run
+    else
+      RspecOtel.record do
+        example.run
+      end
+    end
   end
 end

data/lib/rspec_otel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RspecOtel
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 end

data/lib/rspec_otel.rb

@@ -1,11 +1,29 @@
 # frozen_string_literal: true
 
 require 'opentelemetry/sdk'
+require 'opentelemetry-test-helpers'
 
 module RspecOtel
   def self.exporter
     @exporter ||= OpenTelemetry::SDK::Trace::Export::InMemorySpanExporter.new
   end
+
+  def self.record
+    span_processor = OpenTelemetry::SDK::Trace::Export::SimpleSpanProcessor.new(exporter)
+
+    OpenTelemetry::SDK.configure do |c|
+      c.add_span_processor span_processor
+    end
+
+    yield
+  ensure
+    reset
+  end
+
+  def self.reset
+    OpenTelemetry::TestHelpers.reset_opentelemetry
+    @exporter = nil
+  end
 end
 
 require 'rspec_otel/matchers'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-otel
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Damien MATHIEU
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-23 00:00:00.000000000 Z
+date: 2024-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-test-helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-core
   requirement: !ruby/object:Gem::Requirement