traces 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 389518e7025f63c5c99a5599000e12191ca8634b38f8d05ba727fe22b0fe3aa5
-  data.tar.gz: f8648d7990686c3abbd955f4b45869cf67c88e2b644da156e914bc2cac92087d
+  metadata.gz: f43a022f924d80549fb54edeb3624e67ff1bfbf682115a5a83ac721249b53806
+  data.tar.gz: a307c39fb5decf64d338c2c6f414744fbb4a7e6e523ba84182171d386e68f09a
 SHA512:
-  metadata.gz: a3d9834ff556a722bb7a82dae4c824c94888af648a70954ab2a7c720e26e622ce826262838016169388734b8f9beaa6c2b74cd0a4ea9a669295fce70ae41c61c
-  data.tar.gz: 4fd9a0b83fb293e04fec5ff91431ee55ac2a6fcb86609288795d4d22486cf51fdcb16ec21610487b6e99d9b5662ab30d0999360ce5aaf430408b75a56ae077b8
+  metadata.gz: 2fcb2d979a672924a6167753e9e3e9b4e7d75be028d14b0a623458c7d0a5a656859648ec1a728195dbacedcfcd3817474a37ac3778556a5920c6ace5bb598f28
+  data.tar.gz: 7b4fb88b6ebda8d3ad9cddc5e6132c9e2b50d669eb69f827383aceb4902b32334cb7bd7ab227e51a873881e3e8f98dbae39cef147ac924a2dcc98e701908513e

data/lib/traces/backend/console.rb

@@ -55,11 +55,11 @@ module Traces
 				# Trace the given block of code and log the execution.
 				# @parameter name [String] A useful name/annotation for the recorded span.
 				# @parameter attributes [Hash] Metadata for the recorded span.
-				def trace(name, attributes: {}, &block)
+				def trace(name, resource: self, attributes: {}, &block)
 					context = Context.nested(Fiber.current.traces_backend_context)
 					Fiber.current.traces_backend_context = context
 					
-					::Console.logger.info(self, name, attributes)
+					::Console.logger.info(resource, name, attributes)
 					
 					if block.arity.zero?
 						yield
@@ -74,13 +74,8 @@ module Traces
 				end
 				
 				# Get a trace context from the current execution scope.
-				# @parameter span [Span] An optional span from which to extract the context.
-				def trace_context(span = nil)
-					if span
-						span.context
-					else
-						Fiber.current.traces_backend_context
-					end
+				def trace_context
+					Fiber.current.traces_backend_context
 				end
 			end
 		end

data/lib/traces/backend/test.rb

@@ -44,11 +44,11 @@ module Traces
 				# @parameter value [Object] The metadata value. Should be coercable to a string.
 				def []= key, value
 					unless key.is_a?(String)
-						raise ArgumentError, "Invalid name!"
+						raise ArgumentError, "Invalid name (must be String): #{key.inspect}!"
 					end
 					
 					unless String(value)
-						raise ArgumentError, "Invalid value!"
+						raise ArgumentError, "Invalid value (must be String): #{value.inspect}!"
 					end
 				end
 			end
@@ -57,9 +57,14 @@ module Traces
 				# Trace the given block of code and validate the interface usage.
 				# @parameter name [String] A useful name/annotation for the recorded span.
 				# @parameter attributes [Hash] Metadata for the recorded span.
-				def trace(name, attributes: nil, &block)
+				def trace(name, resource: self.class.name, attributes: nil, &block)
 					unless name.is_a?(String)
-						raise ArgumentError, "Invalid name!"
+						raise ArgumentError, "Invalid name (must be String): #{name.inspect}!"
+					end
+					
+					if resource
+						# It should be convertable:
+						resource = resource.to_s
 					end
 					
 					context = Context.nested(Fiber.current.traces_backend_context)
@@ -79,13 +84,8 @@ module Traces
 				end
 				
 				# Get a trace context from the current execution scope.
-				# @parameter span [Span] An optional span from which to extract the context.
-				def trace_context(span = nil)
-					if span
-						span.context
-					else
-						Fiber.current.traces_backend_context
-					end
+				def trace_context
+					Fiber.current.traces_backend_context
 				end
 			end
 		end

data/lib/traces/backend.rb

@@ -23,10 +23,6 @@
 module Traces
 	# Require a specific trace backend.
 	def self.require_backend(env = ENV)
-		if const_defined?(:Backend)
-			raise RuntimeError, "Backend already required!"
-		end
-		
 		if backend = env['TRACES_BACKEND']
 			require(backend)
 		end

data/lib/traces/provider.rb

@@ -23,6 +23,11 @@
 require_relative 'backend'
 
 module Traces
+	# @returns [Boolean] Whether there is an active backend.
+	def self.enabled?
+		self.const_defined?(:Backend)
+	end
+	
 	# A module which contains tracing specific wrappers.
 	module Provider
 		def traces_provider
@@ -31,7 +36,7 @@ module Traces
 	end
 	
 	# Bail out if there is no backend configured.
-	if self.const_defined?(:Backend)
+	if self.enabled?
 		# Extend the specified class in order to emit traces.
 		def self.Provider(klass, &block)
 			klass.extend(Provider)

data/lib/traces/version.rb

@@ -21,5 +21,5 @@
 # THE SOFTWARE.
 
 module Traces
-	VERSION = "0.4.0"
+	VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: traces
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -36,7 +36,7 @@ cert_chain:
   RAOsIl+HOBTb252nx1kIRN5hqQx272AJCbCjKx8egcUQKffFVVCI0nye09v5CK+a
   HiLJ8VOFx6w=
   -----END CERTIFICATE-----
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -84,7 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Application instrumentation and tracing.