console_think_twice 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a6b253a3a4ae99d15459e9c03389d8939e9a9851372c2b7eadab198564ec7f1
-  data.tar.gz: '09efc4fd77651863aff72c3f578dc27ce30074cd96c190bd6a8da882c7b42e58'
+  metadata.gz: 236302689b1695ddb978506ea4a90c043c8cf03edb179b35ff053655c275297a
+  data.tar.gz: 84aab44ed6323c6fbbaa6cc1b2ef6872320335cd4cb8dbf6e86efb03f509a879
 SHA512:
-  metadata.gz: 3071ebb09d7533f2c733b487b94cfba26d895bf39ca9efd5a76718afdb703051f32c6fd34e1b4fdeccc7d171e7401a261315d2919ffde8542eb50a0c2ac9e5be
-  data.tar.gz: 9c2f40efb4837679488438af2f4d46169d75cca4e3410802a349d871f59effdcda4484792c3596f2d776031d2c9ff1a13c03637d2be2312c350bc20dcbc5f49e
+  metadata.gz: 979ca9fbfa8533b0945653fc1207de763b4a80ddaac372acf37201d2ed0f4074c3686040d670d6b67ac3873ee408bf954935772e9b17e389e6a832a8cdd46817
+  data.tar.gz: 0e8e48c246db11faf5ab091e623789ef4b06253ddcf8e77bc8555df0e96310cb3e0835a79f849f8a565f73a65950617546e46f8ee91bec37e1ca29ad0e458580

data/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-09-01
+
+### Added
+
+- `config.ignored_classes` leaves the classes you name unguarded, for tables that are
+  cleared as a matter of routine — `SolidCache::Entry`, say. Takes names or classes,
+  covers subclasses, and compares names rather than resolving them, so a class that is not
+  loaded, or not in this app at all, can be listed.
+
 ## [0.2.0] - 2026-08-26
 
 ### Fixed
@@ -49,6 +58,7 @@ Initial release.
 - Non-interactive input refuses rather than assuming yes.
 - Configurable via `ConsoleThinkTwice.configure`, or turned off with `CONSOLE_THINK_TWICE=0`.
 
-[Unreleased]: https://github.com/agomezcampero/console-think-twice/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/agomezcampero/console-think-twice/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/agomezcampero/console-think-twice/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/agomezcampero/console-think-twice/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/agomezcampero/console-think-twice/releases/tag/v0.1.0

data/README.md

@@ -76,6 +76,8 @@ are suppressed for the duration of a confirmed call, so you are asked exactly on
 `collection.delete(record)` — which unlinks the record rather than destroying it, unless the
 association says `dependent: :destroy`.
 
+Classes listed in `config.ignored_classes` are not guarded either — see below.
+
 Active Record also destroys records itself, as one step of a call that is about something
 else: a record marked `_destroy` by `accepts_nested_attributes_for`, or the old record a
 `has_one` assignment discards. Those do not prompt. They are already covered by whatever you
@@ -97,6 +99,7 @@ ConsoleThinkTwice.configure do |config|
   config.enabled = Rails.env.production?      # default: true, unless CONSOLE_THINK_TWICE is 0/false/no/off
   config.label = "production (europe)"        # shown in the prompt; defaults to Rails.env,
                                               # set nil or false to leave it out
+  config.ignored_classes = %w[SolidCache::Entry]  # left unguarded; default: none
   config.affirmative_answers = %w[y yes si]   # default: %w[y yes]
   config.interactive = true                   # default: auto-detected from config.input.tty?
   config.input = $stdin
@@ -104,6 +107,20 @@ ConsoleThinkTwice.configure do |config|
 end
 ```
 
+### Classes to leave alone
+
+Some tables are cleared as a matter of routine — job records, cache entries, whatever your
+app treats as scratch. Being asked about those is noise, and noise teaches you to answer `y`
+without reading. List them and the guard stays out of the way:
+
+```ruby
+config.ignored_classes = %w[SolidCache::Entry SolidQueue::Job]
+```
+
+Classes work as well as names, and a subclass of a listed class is ignored too. Names are
+compared rather than resolved, so listing a class that this app does not have, or has not
+autoloaded yet, is fine.
+
 Set `CONSOLE_THINK_TWICE=0` in the environment to turn the guard off without touching
 code. `ConsoleThinkTwice.disable!` turns it off for the rest of the current session and
 `ConsoleThinkTwice.enable!` turns it back on; setting `config.enabled` takes effect straight

data/lib/console_think_twice/configuration.rb

@@ -21,6 +21,27 @@ module ConsoleThinkTwice
       @output || $stdout
     end
 
+    # Classes the guard leaves alone. Bookkeeping tables that are cleared as a matter of
+    # routine — `SolidCache::Entry`, say — are noise to be asked about, and being asked
+    # about them teaches you to answer y without reading. Takes names or classes, and a
+    # subclass of a listed class is ignored too.
+    #
+    # Names are compared rather than resolved, so a class can be listed before it is
+    # autoloaded, or listed in an initializer shared by apps that do not all have it.
+    def ignored_classes=(classes)
+      @ignored_classes = Array(classes).map(&:to_s)
+    end
+
+    def ignored_classes
+      @ignored_classes ||= []
+    end
+
+    def ignores?(model)
+      return false if ignored_classes.empty?
+
+      inheritance_chain(model).any? { |name| ignored_classes.include?(name) }
+    end
+
     def enabled?
       return @enabled unless @enabled.nil?
 
@@ -43,5 +64,15 @@ module ConsoleThinkTwice
 
       ::Rails.env.to_s if defined?(::Rails) && ::Rails.respond_to?(:env)
     end
+
+    private
+
+    # The model's own name and the names of the models it inherits from, so that ignoring a
+    # class ignores its subclasses. Stops at Active Record itself, which every model shares.
+    def inheritance_chain(model)
+      Enumerator.produce(model, &:superclass)
+        .take_while { |klass| klass && klass != ::ActiveRecord::Base }
+        .map(&:name)
+    end
   end
 end

data/lib/console_think_twice/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ConsoleThinkTwice
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/console_think_twice.rb

@@ -82,7 +82,7 @@ module ConsoleThinkTwice
     # saves a COUNT and is the only way to size a call like `books.destroy(a, b)` that names
     # its records rather than describing them.
     def guard(target, action:, force:, count: nil)
-      return yield if !active? || suppressed?
+      return yield if !active? || suppressed? || ignored?(target)
 
       # Active Record's own work is confirmed by whatever the user typed to set it off, so it
       # runs suppressed rather than merely unguarded: `destroy!` re-enters as `destroy`, and
@@ -101,6 +101,10 @@ module ConsoleThinkTwice
 
     private
 
+    def ignored?(target)
+      configuration.ignores?(model_of(target))
+    end
+
     # True when Active Record itself made this call as one step of an operation already under
     # way: a record being removed by `accepts_nested_attributes_for`, a `has_one` being
     # replaced, a collection destroying the records it was handed. Those run inside the

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: console_think_twice
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Agustin Gomez
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-27 00:00:00.000000000 Z
+date: 2026-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord