railscope 0.1.10 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '02218f15b1789991595d3aad2ee44e995246ac00be8cc2b10f3769c40b2305d5'
-  data.tar.gz: d17a705f4afc714006ca408a08342ba9798e993dc1ced98c6449ab36e913378d
+  metadata.gz: c7b44de114284ee8955d48c35c4966b45e8b798b1624d6a8abefb2212b9e4cd5
+  data.tar.gz: 44ba0061f1987733edf5a5dde93ce591fc9eb2ff63f3aae59854051313b59d84
 SHA512:
-  metadata.gz: d18a4366d4a67a0f1a84f7ef105b164551e02a85fadf20c540f25591b6b8504712410567967ef99400d3e6976568f87132bc974462693a8b74fc902fd922fde9
-  data.tar.gz: 4b0e0e2c93a415ce579f0f0b3983fd4937c9c9d1bf1c49c93294c318c76292da963d6a3aadd960afe49c980fb025cad3b5e8c88b2a6be2f01397a583ef8226ef
+  metadata.gz: 3b054e8e101d09dcd88c954eaf82452c9e18629398eb2270d2eddcd89769562eac8325a0c55c77505d5a1f2ecf5f2c7fa644d65e9eec318045c37832dbc3d92f
+  data.tar.gz: 9c7feb08613c99ef5fb206170dedb9e841a846e6d7077f4e06c8fa0673f19764f0ea5acff74da590e4879f7e78cb72213b9ceea35e76990f6b38e1aebabef26f

data/lib/railscope/context.rb

@@ -87,5 +87,30 @@ module Railscope
     end
 
     delegate :empty?, to: :@store
+
+    # Conditional recording: buffer entries until a trigger fires
+
+    def pending_entries
+      self[:pending_entries] ||= []
+    end
+
+    def triggered?
+      self[:triggered] == true
+    end
+
+    def trigger!
+      self[:triggered] = true
+    end
+
+    def buffer_entry(entry_data)
+      pending_entries << entry_data
+    end
+
+    def flush_pending!
+      pending_entries.each do |entry_data|
+        Railscope.storage.write(**entry_data)
+      end
+      pending_entries.clear
+    end
   end
 end

data/lib/railscope/middleware.rb

@@ -18,17 +18,20 @@ module Railscope
       # Capture response body for recording
       context = Context.current
       if context[:recording]
-        # Read body from env (where Rails stores the response)
-        body_content = extract_body_from_env(env)
-
-        context_data = {
-          batch_id: context.batch_id,
-          env: env,
-          headers: headers
-        }
-
-        # Update entry with response data
-        update_entry_async(context_data, body_content)
+        # In conditional mode, skip persistence if trigger never fired
+        unless Railscope.conditional_recording? && !context.triggered?
+          # Read body from env (where Rails stores the response)
+          body_content = extract_body_from_env(env)
+
+          context_data = {
+            batch_id: context.batch_id,
+            env: env,
+            headers: headers
+          }
+
+          # Update entry with response data
+          update_entry_async(context_data, body_content)
+        end
       end
 
       [status, headers, response]

data/lib/railscope/subscribers/base_subscriber.rb

@@ -29,7 +29,7 @@ module Railscope
 
         filtered_payload = Railscope.filter(payload.merge(context_payload))
 
-        Railscope.storage.write(
+        entry_data = {
           entry_type: entry_type,
           batch_id: context.batch_id,
           family_hash: family_hash,
@@ -37,7 +37,13 @@ module Railscope
           payload: filtered_payload,
           tags: (tags + context_tags).uniq,
           occurred_at: Time.current
-        )
+        }
+
+        if Railscope.conditional_recording? && !context.triggered?
+          context.buffer_entry(entry_data)
+        else
+          Railscope.storage.write(**entry_data)
+        end
       end
 
       # Generate a family hash for grouping similar entries

data/lib/railscope/subscribers/job_subscriber.rb

@@ -76,7 +76,12 @@ module Railscope
         # Also create a separate exception entry if job failed
         create_exception_entry!(job, exception_object) if exception_object
 
-        # Clear context after job completes
+        # In conditional mode: flush if triggered, otherwise entries are discarded with context
+        if Railscope.conditional_recording? && context.triggered?
+          # Response update for jobs is already in the entry payload, nothing extra needed
+        end
+
+        # Clear context after job completes (discards any unflushed buffer)
         Railscope::Context.clear!
       rescue StandardError => e
         Rails.logger.error("[Railscope] Failed to record job perform: #{e.message}")

data/lib/railscope/subscribers/model_subscriber.rb

@@ -42,6 +42,7 @@ module Railscope
         model_name = model.class.name
         return if model_name.nil?
         return if IGNORED_MODEL_PREFIXES.any? { |prefix| model_name.start_with?(prefix) }
+        return unless Railscope.should_track_model?(model_name)
 
         create_entry!(
           entry_type: "model",
@@ -50,6 +51,13 @@ module Railscope
           family_hash: build_family_hash(action, model),
           should_display_on_index: true
         )
+
+        # Conditional recording: flush buffered entries when trigger matches
+        if Railscope.conditional_recording? && !context.triggered? && Railscope.matches_trigger?(model_name, action)
+          context.trigger!
+          context.flush_pending!
+        end
+
         Rails.logger.debug("[Railscope] ModelSubscriber - entry created for #{model_name}")
       rescue StandardError => e
         Rails.logger.error("[Railscope] Failed to record model event: #{e.class}: #{e.message}")

data/lib/railscope/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railscope
-  VERSION = "0.1.10"
+  VERSION = "0.1.11"
 end

data/lib/railscope.rb

@@ -27,7 +27,8 @@ module Railscope
   STORAGE_REDIS = :redis
 
   class << self
-    attr_writer :retention_days, :redis, :storage_backend, :ignore_paths, :ignore_jobs, :ignore_commands
+    attr_writer :retention_days, :redis, :storage_backend, :ignore_paths, :ignore_jobs, :ignore_commands,
+                :ignore_models
     attr_accessor :authenticate_with
 
     def enabled=(value)
@@ -123,6 +124,43 @@ module Railscope
       ignore_commands.any? { |pattern| command_name.match?(pattern) }
     end
 
+    # Model filtering (blocklist)
+
+    def ignore_models
+      @ignore_models ||= []
+    end
+
+    def add_ignore_models(*model_names)
+      @ignore_models = ignore_models.concat(model_names.flatten.map(&:to_s)).uniq
+    end
+
+    def should_track_model?(model_name)
+      return false if model_name.nil?
+
+      ignore_models.none? { |pattern| model_name.match?(pattern) }
+    end
+
+    # Conditional recording: only persist a batch when a watched model event fires
+
+    def watch_triggers
+      @watch_triggers ||= []
+    end
+
+    def add_watch_trigger(model_name, on:)
+      actions = Array(on).map(&:to_s)
+      @watch_triggers = watch_triggers.push({ model: model_name.to_s, on: actions }).uniq
+    end
+
+    def conditional_recording?
+      watch_triggers.any?
+    end
+
+    def matches_trigger?(model_name, action)
+      watch_triggers.any? do |trigger|
+        model_name.match?(trigger[:model]) && trigger[:on].include?(action.to_s)
+      end
+    end
+
     def context
       Context.current
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: railscope
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.11
 platform: ruby
 authors:
 - Phelipe Tussolini
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -155,7 +155,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A debug assistant for Rails applications inspired by Laravel Telescope
 test_files: []