backburner 1.9.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad41e83594bda50d1b504a4e0e5777c477e5586dc88faddbbad476a81afb34d4
-  data.tar.gz: f53ac6873638f40f627bbcd1326f50fbd642e5454bce2c083b809cdc6904863b
+  metadata.gz: 38f2e1a84e114710eb8a1e2e6e61e6fe1683c6e06963c69c065511b59ec41390
+  data.tar.gz: 89a22694c1cd5b1957b4cd6ad287bc8905166588723421c1b0cedbdc2b37ecb0
 SHA512:
-  metadata.gz: '0384db95f53944823490c2105948153c8aac2d0fb5e8268c8c6f82895ae722bf293bb93f7a0536967a9ad91a138d37f02d92f4f2b0e6860a749cb830065dd668'
-  data.tar.gz: 1e6cbde19cd41a7540346d5d66af0537af1fc53baec32466790217b0643b610cbd7d17f8ea74b1ed6aedd55a26c152d798df86f4ef6b21ac11b5bc848db9d175
+  metadata.gz: 8113a36c15482093961ac7d3e9fee24f30b9d549bc32f7553b518056dea93ab389a848975dd80c112e77aa68dc2c7fd11bfa7b51cdb015a410795e1b4b9ea8cc
+  data.tar.gz: 8165aac92f55de2d5e6d15ad1ac91266c37f9355a1d8e6e8a3bf878f5af94028e7ecba8b2b69955c957d9cf61d908ebe8980208f977511a27f56e7440c4bc485

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## Version 1.9.1 (Nov 5 2026)
+
+* Faster hook lookup: finding a job class's hooks (`before_enqueue`, `before_perform` and the others) no longer lists every method each class has, so Backburner's own work per job is lighter: enqueueing takes about 30-40% less time and working a job about 15-30% less (more with Active Support loaded), measured with no-op jobs against a local beanstalkd. The same hooks run, in the same order
+
 ## Version 1.9.0 (Nov 1 2026)
 
 * The gem now ships only `lib/`, `bin/`, `README.md`, `HOOKS.md`, `CHANGELOG.md` and `LICENSE` (no tests, examples or CI files), and its rubygems.org page links the source, the changelog and the issue tracker. **Behaviour change for the gem's owners:** pushing a release to rubygems.org now requires MFA (`rubygems_mfa_required`); the release workflow's trusted publishing is unaffected. **What to do:** owners who push by hand need MFA enabled on their rubygems.org account

data/lib/backburner/hooks.rb

@@ -46,8 +46,53 @@ module Backburner
       #   # => ['before_enqueue_foo', 'before_enqueue_bar']
       #
       def find_hook_events(hookable, event)
-        (hookable.methods - Object.methods).grep(/^#{event}/).sort
+        pattern = HOOK_PATTERNS[event] || /^#{event}/
+        (class_hook_events(hookable, pattern) || (hookable.methods - Object.methods).grep(pattern)).sort
       end
+
+      # The names (hookable.methods - Object.methods).grep(pattern) gives for a class, without listing every method
+      # each class has: a class's methods are looked up in its own modules (its singleton class, its superclasses'
+      # and the modules they extend) and then in Object's, so a name none of its own modules define is looked up
+      # as on Object, and Object.methods has it too. nil for anything else (an instance, a module, a class that
+      # doesn't end in Object's modules, or a class or Object that doesn't list its methods with Kernel's own public
+      # #methods).
+      def class_hook_events(hookable, pattern)
+        return unless Class === hookable
+        singleton = SINGLETON_CLASS.bind_call(hookable)
+        object = SINGLETON_CLASS.bind_call(Object)
+        return unless kernel_listing?(singleton) && kernel_listing?(object)
+        ancestors = ANCESTORS.bind_call(singleton)
+        objects = ANCESTORS.bind_call(object)
+        own = ancestors.size - objects.size
+        return unless own > 0 && ancestors.last(objects.size) == objects
+        # a name the class lists is public or protected where it is looked up, so one of them lists it
+        names = ancestors.first(own).flat_map { |mod| INSTANCE_METHODS.bind_call(mod, false).grep(pattern) }
+        names.uniq.select { |name| listed?(singleton, name) && !listed?(object, name) }
+      end
+
+      # Whether an object whose singleton class is `singleton` lists its methods with Kernel's own public #methods
+      def kernel_listing?(singleton)
+        return false unless PUBLIC_METHOD_DEFINED.bind_call(singleton, :methods)
+        listing = INSTANCE_METHOD.bind_call(singleton, :methods)
+        listing.owner.equal?(Kernel) && listing.original_name == :methods && listing.source_location.nil?
+      end
+
+      # Whether an object whose singleton class is `singleton` lists the method in #methods (a public or protected one)
+      def listed?(singleton, name)
+        PUBLIC_METHOD_DEFINED.bind_call(singleton, name) || PROTECTED_METHOD_DEFINED.bind_call(singleton, name)
+      end
+
+      # The patterns of the events Backburner triggers, compiled once
+      HOOK_PATTERNS = %i[before_enqueue after_enqueue before_perform around_perform after_perform on_failure on_bury
+        on_retry on_reconnect].to_h { |event| [event, /^#{event}/] }.freeze
+
+      # Kernel's and Module's own reflection, whatever a class or module defines for itself
+      SINGLETON_CLASS = Kernel.instance_method(:singleton_class)
+      ANCESTORS = Module.instance_method(:ancestors)
+      INSTANCE_METHODS = Module.instance_method(:instance_methods)
+      INSTANCE_METHOD = Module.instance_method(:instance_method)
+      PUBLIC_METHOD_DEFINED = Module.instance_method(:public_method_defined?)
+      PROTECTED_METHOD_DEFINED = Module.instance_method(:protected_method_defined?)
     end
   end # Hooks
 end # Backburner

data/lib/backburner/version.rb

@@ -1,3 +1,3 @@
 module Backburner
-  VERSION = "1.9.0"
+  VERSION = "1.9.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: backburner
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.1
 platform: ruby
 authors:
 - Nathan Esquenazi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-01 00:00:00.000000000 Z
+date: 2026-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: beaneater