purple-client 0.1.7.3 → 0.1.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08cd363a5b6e96500dde9beaa81ac46fdb282d6e6225d8ca19d4ba917c0b6f4f'
-  data.tar.gz: 3eb93db2b0b359bc7b455ce6282bcc02d1d50991fbd8578a0527388b785fd9e8
+  metadata.gz: 81f0cb64364ec0312d07b900ae67a2e65137d03818c6b3e2c1b8631221ea9a65
+  data.tar.gz: 7404f01d3ba5714093d62fbac16218b263f20c43d0b29391add9fd9833ccdb29
 SHA512:
-  metadata.gz: 2653930ab7bcb2855c8ff142d401ffb8b1c676f0ca579f66fb7a780f8cb45760afff1f7f60fbabe7573091c4a877e6e5ea4d8d31d26c9dafd41a8c4d2b953095
-  data.tar.gz: f2aacc6f3e1d6ca9b6661c5ad08be55f29b12061e1b037d30aca40ef7bb397ebb2b6ef88e6df772e66abf8bb7b61d6247d7d1980b35009d9f759d3bbd48504b5
+  metadata.gz: ab18072bf25f80e0ded0dc7d3f317230fb93e400cbc9a563bf0d6be68b3c166458bf94f39877eb6dc535bce4c1e8c962b002699e3f4e08702effee65ba86e397
+  data.tar.gz: ef5033eb7da7a10bf033583603906b31176a63222e95e5f18bbdcab613b4ac775d4cb76594419c796206d65680dfc836d88ffe8f62973b38ad867a81928a1c8d

data/README.md

@@ -121,6 +121,36 @@ end
 PostsClient.user_posts(user_id: 7)
 ```
 
+### Paths nested under parameters
+
+When a path segment is marked with `is_param: true`, any paths nested
+inside it will not have a `root_method` generated. Instead of calling a
+root method, you need to chain the segment methods manually.
+
+```ruby
+class BrowserClient < Purple::Client
+  domain 'https://api.example.com'
+
+  path :browser do
+    path :id, is_param: true do
+      path :web, method: :post do
+        response :ok do
+        end
+
+        response :bad_request do
+          body do |res|
+            puts res
+          end
+        end
+      end
+    end
+  end
+end
+
+# root_method :web will not work here
+BrowserClient.browser.id('123').web
+```
+
 ### Callbacks with additional arguments
 
 ```ruby
@@ -197,6 +227,30 @@ end
 CalendarClient.schedule
 ```
 
+### Allow blank fields
+
+Some APIs return keys that are present but contain `null` or empty string values.
+You can mark those fields with `allow_blank` so blank values do not raise
+validation errors.
+
+```ruby
+class ProfilesClient < Purple::Client
+  domain 'https://api.example.com'
+
+  path :profile do
+    response :ok do
+      body(
+        middle_name: { type: String, allow_blank: true },
+      )
+    end
+    root_method :profile
+  end
+end
+
+# The `middle_name` attribute may be blank or omitted in the response
+ProfilesClient.profile
+```
+
 ### Array responses
 
 When an endpoint returns an array of objects, you can use `:array_of` to
@@ -226,6 +280,43 @@ end
 MerchantsClient.merchants
 ```
 
+### Response body processing
+
+After the body structure is validated, you can supply a block to `body`
+to transform or handle the parsed response. This is useful for mapping
+error payloads to simpler return values or for normalizing data.
+
+```ruby
+class MessagesClient < Purple::Client
+  domain 'https://api.example.com'
+
+  path :messages do
+    response :unprocessable_entity do
+      structure = {
+        status: Integer,
+        type: String,
+        title: String,
+        detail: String
+      }
+
+      body(**structure) do |res|
+        case res.type
+        when 'errors/invalid_recipient'
+          :not_found
+        else
+          res
+        end
+      end
+    end
+    root_method :send_message
+  end
+end
+
+# Returns :not_found when the recipient is invalid, otherwise returns the
+# parsed response body.
+MessagesClient.send_message
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then run

data/lib/purple/path.rb

@@ -27,7 +27,7 @@ module Purple
       @param_value = args.first
     end
 
-    def method_missing(method_name, *args, &)
+    def method_missing(method_name, *args, **kw_args, &)
       if children.any? { |child| child.name == method_name }
         child = children.find { |child| child.name == method_name }
 
@@ -38,7 +38,7 @@ module Purple
         if child.children.any?
           child
         else
-          callback_arguments = additional_callback_arguments.map do |arg|
+          callback_arguments = client.additional_callback_arguments.map do |arg|
             kw_args.delete(arg)
           end
 

data/lib/purple/response.rb

@@ -12,6 +12,7 @@ class Purple::Response
   CODES = {
     ok: 200,
     created: 201,
+    accepted: 202,
     bad_request: 400,
     unauthorized: 401,
     unprocessable_entity: 422,

data/lib/purple/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: purple-client
 version: !ruby/object:Gem::Version
-  version: 0.1.7.3
+  version: 0.1.7.4
 platform: ruby
 authors:
 - Pavel Kalashnikov