gl_command 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11a5d5ab9dd4a28700cb671153c1a757612f5b735194a28ad22f8be660a09250
-  data.tar.gz: a3a351134af335563ee6e970d5920d08e52f2b4375cef1c8adc87e555bd1e64f
+  metadata.gz: b0e88d785a51d72653d8691d86236df3791dadaa84b46a548895e045509e1428
+  data.tar.gz: 582d39e38c74b40ac251dd91071fe602a8860f6ecda15a7ece244e21541352d1
 SHA512:
-  metadata.gz: 4344a62dca3bccad299425f9d22db05ca7e3062518c0f4a0c3b1be2d3708de8ccb3d310380c5a4eb73b515a21c4866c8b3385f9ee18c23e9389fd49e9afb8803
-  data.tar.gz: '08c842fe87ac92bc793fad76498e0b12ecc772a8d5385fea2d5c34670115ba40a17545227e572a5ce1bcee9b3bc6c52f2e70f59e45a8755a871b93ebe3d344a2'
+  metadata.gz: e8758b174cdf1f76a4b35d466876a8fbaa848f2546628ea777e7db594a1221a3ca9db2c31f0be77a6d58c62a739f62294e23e63050ed76bd48ca85fcbbfcdb0b
+  data.tar.gz: ed20e53cb69da3c59f2919e7f89c505d2470a9fa44138fdd9334c12c6bebcb1c89dd34a9598b9f33a0c0a29ea875fefa7f10c89e16a2d0cfe07fb1bcb133c392

data/lib/gl_command/callable.rb

@@ -6,7 +6,7 @@ require 'gl_command/validatable'
 
 module GLCommand
   class Callable
-    DEFAULT_OPTS = { raise_errors: false, skip_unknown_parameters: true }.freeze
+    DEFAULT_OPTS = { raise_errors: false, skip_unknown_parameters: true, in_chain: false }.freeze
     RESERVED_WORDS = (DEFAULT_OPTS.keys + GLCommand::ChainableContext.reserved_words).sort.freeze
 
     class << self
@@ -25,7 +25,8 @@ module GLCommand
 
         # DEFAULT_OPTS contains skip_unknown_parameters: true - so it raises on call
         # (rather than in context initialize) to make errors more legible
-        opts = DEFAULT_OPTS.merge(raise_errors: args.delete(:raise_errors)).compact
+        opts = DEFAULT_OPTS.merge(raise_errors: args.delete(:raise_errors),
+                                  in_chain: args.delete(:in_chain)).compact
         # args are passed in in perform_call(args) so that invalid args raise in a legible place
         new(build_context(**args.merge(opts))).perform_call(args)
       end
@@ -70,7 +71,7 @@ module GLCommand
         (arguments + returns).uniq
       end
 
-      # Used internally by GLCommand (probably don't reference them in your own GLCommands)
+      # Used internally by GLCommand (probably don't reference in your own GLCommands)
       # is true in GLCommand::Chainable
       def chain?
         false
@@ -106,7 +107,9 @@ module GLCommand
 
     def perform_call(args)
       raise_for_invalid_args!(**args)
+      instrument_command(:before_call)
       call_with_callbacks
+      instrument_command(:after_call)
       raise_unless_chained_or_skipped if self.class.chain? # defined in GLCommand::Chainable
       context.failure? ? handle_failure : context
     rescue StandardError => e
@@ -133,6 +136,11 @@ module GLCommand
 
     private
 
+    # trigger: [:before_call, :after_call, :before_rollback]
+    def instrument_command(trigger)
+      # Override where gem is used if you want to instrument commands
+    end
+
     # rubocop:disable Metrics/AbcSize
     def handle_failure(e = nil)
       context.error ||= e
@@ -159,9 +167,7 @@ module GLCommand
     rescue GLCommand::CommandNoNotifyError
       raise context.error # makes CommandNoNotifyError the cause
     end
-    # rubocop:enable Metrics/AbcSize
 
-    # rubocop:disable Metrics/AbcSize
     def call_with_callbacks
       GLExceptionNotifier.breadcrumbs(data: { context: context.inspect }, message: self.class.to_s)
       validate_validatable! # defined in GLCommand::Validatable
@@ -186,6 +192,8 @@ module GLCommand
     def call_rollbacks
       return if defined?(@rolled_back) # Not sure this is required
 
+      instrument_command(:before_rollback)
+
       @rolled_back = true
 
       chain_rollback if self.class.chain? # defined in GLCommand::Chainable

data/lib/gl_command/chainable.rb

@@ -41,7 +41,7 @@ module GLCommand
 
       commands.map do |command|
         cargs = context.chain_arguments_and_returns.slice(*command.arguments)
-                       .merge(context.opts_hash)
+                       .merge(context.opts_hash).merge(in_chain: true)
 
         result = command.call(**cargs)
         context.assign_parameters(skip_unknown_parameters: true, **result.returns)

data/lib/gl_command/context.rb

@@ -7,9 +7,10 @@ require 'active_support/core_ext/module'
 module GLCommand
   class Context
     def initialize(klass, raise_errors: false, skip_unknown_parameters: false,
-                   **arguments_and_returns)
+                   in_chain: false, **arguments_and_returns)
       @klass = klass
       @raise_errors = raise_errors.nil? ? false : raise_errors
+      @in_chain = in_chain
       @klass.arguments_and_returns.each { |key| singleton_class.class_eval { attr_accessor key } }
       initialize_chain_context(**arguments_and_returns) if chain?
       assign_parameters(skip_unknown_parameters:, **arguments_and_returns)
@@ -30,6 +31,10 @@ module GLCommand
       false
     end
 
+    def in_chain?
+      @in_chain
+    end
+
     def returns
       @klass.returns.index_with { |rattr| send(rattr) }
     end

data/lib/gl_command/version.rb

@@ -1,3 +1,3 @@
 module GLCommand
-  VERSION = '1.0.1'.freeze
+  VERSION = '1.1.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gl_command
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Give Lively
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-19 00:00:00.000000000 Z
+date: 2024-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord