dbg_tags 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 269e2882bb82fb4a015a17417744067bcbdbd6b98a6f5e799f4f57a332b6eadf
-  data.tar.gz: 288f736d512ba40960086f54413d149b2b7558e5223cbf5ff545e15dab79b8f6
+  metadata.gz: a8e0401ca437e4c46fe63c0fa1aeb0a952e0bb26bb9470b72cf630201cc9e0fd
+  data.tar.gz: a148a7f14a0a8eeac1109f00ec9a8f0b768f391c2c218f1fc03fa3b61c8abed2
 SHA512:
-  metadata.gz: 072f1320bae3b4900d895370e17f717f125a721318a6e5a5bc393abef86507b18ca4de3c7b0f39ee4d12aa050dbd6829ceae3eb43bcdd44fe592b39da510114c
-  data.tar.gz: cfa63312d3ed1e16ab82d7e73737f6e87b5fe6df12dac8a11d8cec3ad6f0731c6029d43a223ed2d73e7cd2af9e07299175e2c5662854e6d725afaa51cce694ea
+  metadata.gz: 82fa4fd016e062e9901d306dc44597ddf6eaad44201721ea874228e59114eb371e4322d3799c6e1aab1fda467534490f32109fb26ff0aa09db48368e485ae3be
+  data.tar.gz: cb6d061257ee53ddb4962468aa03dd507499a4aebe400483818210b729c04c4af0eca967617fe8d594deead9500aef05ae068a7e379c38c8728b29ddc0113e9c

data/lib/dbg_tags.rb

@@ -190,28 +190,38 @@ module Tag
     private # class methods of Tag
 
     # @param value [Bool] Value to set
-    # Primarily for rspec stuff. Use {disable_fiber_local_state!} instead
-    def no_fiber_local_state= value
-      @no_fiber_local_state = value
-    end # Tag::no_fiber_local_state=
+    # Primarily for rspec stuff. Use {disable_thread_local_state} instead
+    def no_thread_local_state= value
+      @no_thread_local_state = value
+    end # Tag::no_thread_local_state=
 
     public # class methods of Tag
 
     # @return [Bool,nil] True if we should store global state inside the Tag class itself.
-    attr :no_fiber_local_state
-    alias no_fiber_local_state? no_fiber_local_state
+    attr :no_thread_local_state
+    alias no_thread_local_state? no_thread_local_state
+
+    # DEPRECATED
+    alias no_fiber_local_state? no_thread_local_state? # for B.C.
 
     # @return [Bool] True (the default) if we should store global state
-    # in each fiber/thread of the application.
-    def use_fiber_local_state?; !no_fiber_local_state? end
+    # in each thread of the application.
+    def use_thread_local_state?; !no_thread_local_state? end
+
+    # DEPRECATED
+    alias use_fiber_local_state? use_thread_local_state? # for B.C.
 
-    # @return [GlobalState] Either fiber local data (default) or truly global.
+    # @return [GlobalState] Either thread local data (default) or truly global.
     def global_state
-      if @no_fiber_local_state # testing undefined ivar here. But no warnings... That is good,
-          # at least for performance
+      if @no_thread_local_state
         @global_state ||= GlobalState.new
       else
-        Thread.current[:dbg_tags_global_state] ||= GlobalState.new
+        ct = Thread.current 
+        unless state = ct.thread_variable_get(:dbg_tags_global_state)
+          state = GlobalState.new
+          ct.thread_variable_set :dbg_tags_global_state, state
+        end
+        state
       end
     end # Tag::global_state
 
@@ -295,20 +305,23 @@ module Tag
     # @return [bool] Reflects explicit enable calls only. The :all feature is IGNORED
     def enabled? feature; (global_state.enabled[feature] || NONE) > NONE; end
 
-    # shortcut for no_fiber_local_state := true
-    # By default fiber local state is enabled but this means that
-    # 'enabling' of tags in some fiber does not work in others.
-    # Or more specific, that changing the Tag state outside of any fiber
-    # does not effect any fibers (already) created.
-    # Now it is possible to transfer data into the fiber using 'resume'
-    # but this is a hassle.
-    # So: when using threads leave this enabled, as it will cause race conditions.
-    # when using fibers, but no threads it is probably convenient to disable it.
-    def disable_fiber_local_state; self.no_fiber_local_state = true end
-
-    # shortcut for no_fiber_local_state := false
+    # shortcut for no_thread_local_state = true
+    # By default thread local state is enabled and this means that
+    # 'enabling' of tags in some thread does effect in others.
+    # So: when using threads leave this enabled, as it will cause race conditions
+    # otherwise.
+    # When not using threads, it is more efficient to disable it.
+    def disable_thread_local_state; self.no_thread_local_state = true end
+  
+    # DEPRECATED
+    alias disable_fiber_local_state disable_thread_local_state # for B.C.
+
+    # shortcut for no_thread_local_state := false
     # For rspec use mostly.
-    def enable_fiber_local_state; self.no_fiber_local_state = false end
+    def enable_thread_local_state; self.no_thread_local_state = false end
+
+    # DEPRECATED
+    alias enable_fiber_local_state enable_thread_local_state # for B.C.
 
   end # singleton class Tag
 end # module Tag

data/spec/01_tag_spec.rb

@@ -255,7 +255,7 @@ describe 'tag' do
   end # context 'Nested levels'
 
   it 'has thread local data to prevent mix ups (tag_300)' do
-    Tag.enable_fiber_local_state # NOTE enabled by default, but other examples may botch it
+    Tag.enable_thread_local_state # NOTE enabled by default, but other examples may botch it
     t1 = Thread.new do
       Tag.enable threads: :trc do
         Tag.trc(:threads) {
@@ -275,7 +275,7 @@ describe 'tag' do
   end # it
 
   it 'each thread has a private tag system (tag_301)' do
-    Tag.enable_fiber_local_state # NOTE enabled by default, but other examples may botch it
+    Tag.enable_thread_local_state # NOTE enabled by default, but other examples may botch it
     executed = false
     Tag.enable threads: :trc do
       expect(Tag.enabled).to eq({threads: Tag::TRC})
@@ -297,12 +297,12 @@ describe 'tag' do
     expect(executed).to be true
   end # it
 
-  it 'each fiber has a private tag system (tag_302)' do
-    Tag.enable_fiber_local_state # NOTE enabled by default, but other examples may botch it
+  it 'each thread has a private tag system (tag_302)' do
+    Tag.enable_thread_local_state # NOTE enabled by default, but other examples may botch it
     executed = false
     Tag.enable threads: :trc do
       expect(Tag.enabled).to eq({threads: Tag::TRC})
-      t1 = Fiber.new do
+      t1 = Thread.new do
         expect(Tag.enabled).to eq({})
         Tag.enable threads: :log do
           expect(Tag.enabled).to eq({threads: Tag::LOG})
@@ -313,14 +313,14 @@ describe 'tag' do
           }
         end
       end 
-      t1.resume
+      t1.join
       expect(Tag.enabled).to eq({threads: Tag::TRC})
     end
     expect(executed).to be true
   end # it
 
-  it 'allows to disable fiber local state (tag_305)' do
-    Tag.disable_fiber_local_state
+  it 'Fibers share the tag state (tag_303)' do
+    Tag.enable_thread_local_state # NOTE enabled by default, but other examples may botch it
     executed = false
     Tag.enable threads: :trc do
       expect(Tag.enabled).to eq({threads: Tag::TRC})
@@ -337,17 +337,39 @@ describe 'tag' do
       end 
       t1.resume
       expect(Tag.enabled).to eq({threads: Tag::TRC})
+    end
+    expect(executed).to be true
+  end # it
+
+  it 'allows to disable thread local state (tag_305)' do
+    Tag.disable_thread_local_state
+    executed = false
+    Tag.enable threads: :trc do
+      expect(Tag.enabled).to eq({threads: Tag::TRC})
+      t1 = Thread.new do
+        expect(Tag.enabled).to eq({threads: Tag::TRC})
+        Tag.enable threads: :log do
+          expect(Tag.enabled).to eq({threads: Tag::LOG})
+          Tag.log(:threads) {
+            expect(Tag.inside?).to be true
+            executed = true
+            nil
+          }
+        end
+      end 
+      t1.join
+      expect(Tag.enabled).to eq({threads: Tag::TRC})
       expect(executed).to be true
     end
   end # it
 
-  it 'does allow restore_state to transfer state through a Fiber barrier (tag_310)' do
-    Tag.enable_fiber_local_state
+  it 'does allow restore_state to transfer state into a Thread (tag_310)' do
+    Tag.enable_thread_local_state
     did_something = false
     Tag.enable example: :dtl, fiber: :trc do
       state = Tag.state # same as Tag.enabled
       expect(state).to eq({example: Tag::DTL, fiber: Tag::TRC})
-      t1 = Fiber.new do
+      t1 = Thread.new do
         expect(Tag.state).to eq({})
         Tag.enable foo: :trc
         Tag.restore_state state do
@@ -355,18 +377,18 @@ describe 'tag' do
           did_something = true
         end
       end
-      t1.resume
+      t1.join
       expect(Tag.state).to eq({example: Tag::DTL, fiber: Tag::TRC})
     end # enable
     expect(did_something).to be true
   end # it
 
-  it 'does allow a nil-state to transfer state through a Fiber barrier (tag_311)' do
-    Tag.enable_fiber_local_state
+  it 'does allow a nil-state to transfer into a Thread (tag_311)' do
+    Tag.enable_thread_local_state
     did_something = false
     state = Tag.state
     expect(state).to eq({})
-    t1 = Fiber.new do
+    t1 = Thread.new do
       expect(Tag.state).to eq({})
       Tag.enable foo: :trc
       Tag.restore_state state do
@@ -374,7 +396,7 @@ describe 'tag' do
         did_something = true
       end
     end
-    t1.resume
+    t1.join
     expect(Tag.state).to eq({})
     expect(did_something).to be true
   end # it

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dbg_tags
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Eugene Brazwick
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-06 00:00:00.000000000 Z
+date: 2026-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -66,7 +66,7 @@ homepage: https://github.com/Eugene-Brazwick/dbg_tags
 licenses:
 - GPL-3.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -81,8 +81,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: a versatile dynamic debug tracing system
 test_files: