purple-client 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f4ca49f00bb4d5ec1c6e85735ba6234a59aba7d82f783f4344bbe903018ae65
-  data.tar.gz: b6d6a4f48c2a07196bbc89514fd163eee65ddf61b7d84aca83f57e4b1512224b
+  metadata.gz: 426284067d37937cf20cc78132fc5286f4d691ae66cb25177f01c7219e844667
+  data.tar.gz: e08e9819a221659f94b9bbb54b41aa59a23ee1bc7fb2b8ca829e5a8039173325
 SHA512:
-  metadata.gz: e3964e69833c7f37ac6c95c8461d8b8ac3815891ed681d1414a4bd8b908078f11be980c5dfef100fe7f98a65eb8ace3a5ab4c171f37c61c8b7c8508b5d56abbe
-  data.tar.gz: 2013f80e686a5c702f8b81f0e4497b333ef59560b8072dee468ef95c5f19b587a4eaf14dc3efcfa4f88f794539dec3fc1bb8360938237152e2461afb0973b142
+  metadata.gz: 0eb4508617a8198b6dd0cddfef087aabe63b65c4a8825bfe759caf379aa2a3adbb0b7705181363a937d2fa818b7d77458da4dcd244ba0da03ce2a0184d6df2cd
+  data.tar.gz: 22df3ed5def051f3a9fb372143a19e830276cd70a18756940ce1ec807b732273353788128c818fe5d3c303081b09d0904d9afd8bac281151e620d1a1e1ef4154

data/README.md

@@ -100,6 +100,36 @@ end
 PostsClient.user_posts(user_id: 7)
 ```
 
+### Callbacks with additional arguments
+
+```ruby
+class EventsClient < Purple::Client
+  domain 'https://api.example.com'
+
+  additional_callback_arguments :resource
+
+  callback do |url, params, headers, response, resource|
+    StoreEvent.call(url:, params:, headers:, response:, resource:)
+  end
+
+  path :events do
+    response :ok do
+      body :default
+    end
+    root_method :events
+  end
+end
+
+resource = SomeModel.find(1)
+EventsClient.events(resource:)
+```
+
+`additional_callback_arguments` lets you specify parameter names that will be
+extracted from the call and passed to your callback. In the example above the
+`resource` keyword argument is removed from the request parameters, but is
+available inside the callback so you can associate the stored event with a
+record of your choice.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then run

data/lib/purple/client.rb

@@ -69,9 +69,13 @@ module Purple
             kw_args[current_path.name] = value
           end
 
+          callback_arguments = additional_callback_arguments.map do |arg|
+            kw_args.delete(arg)
+          end
+
           params = current_path.request.params.call(**kw_args) if current_path.request.params.is_a?(Proc)
 
-          current_path.execute(params, kw_args, &block)
+          current_path.execute(params, kw_args, *callback_arguments, &block)
         end
       end
 
@@ -112,6 +116,14 @@ module Purple
           super
         end
       end
+
+      def additional_callback_arguments(*array)
+        if array.empty?
+          @additional_callback_arguments || []
+        else
+          @additional_callback_arguments = array
+        end
+      end
     end
   end
 end

data/lib/purple/path.rb

@@ -32,13 +32,21 @@ module Purple
           child.with(*args)
         end
 
-        child.children.any? ? child : child.execute(*args)
+        if child.children.any?
+          child
+        else
+          callback_arguments = additional_callback_arguments.map do |arg|
+            kw_args.delete(arg)
+          end
+
+          child.execute(*args, *callback_arguments)
+        end
       else
         super
       end
     end
 
-    def execute(params = {}, args = {})
+    def execute(params = {}, args = {}, *callback_arguments)
       headers = {
         'Accept' => 'application/json',
         'Content-Type' => 'application/json'
@@ -81,7 +89,7 @@ module Purple
                    {}
                  end
 
-        client.callback&.call(url, params, headers, JSON.parse(response.body))
+        client.callback&.call(url, params, headers, JSON.parse(response.body), *callback_arguments)
 
         if block_given?
           yield(resp_structure.status, object)

data/lib/purple/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Purple
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: purple-client
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Pavel Kalashnikov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 2025-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-initializer