kaze_client 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff98889c7d39f15fc54339f9751d5197b15d3c5ed8af54375382858cf76a431b
-  data.tar.gz: 8484f58d8443003290a8a165c640c936705ffb4c2b7a51188fa9b8486d6e672c
+  metadata.gz: fd31be1e3cb6ccd738c9646f50ad6096961f4b77f893373f38481f747a2c5442
+  data.tar.gz: 7f2081157ac8778d108e4629524e228ad67aaeabb38ad977b7eb362476d0e996
 SHA512:
-  metadata.gz: e0197299afa26f1a0a773f60e28f77c5d49b8a49930149f80e07cf7762311bdf7dd5c496df45e72c52d163b8e194ab57e7e94b97835449798db3f47f4a34e3bb
-  data.tar.gz: 76488d384368b10038eb5e126c846c29f6bac94d318f899528b4c8d9b001e2c637d9775b882f40dfaa33d5e06884477e0801d3fb24eb8fbadb0e3f1b5423a2bb
+  metadata.gz: 96c9f307c9d54f2d446d82e10f1ed795223a2679c3dc60dcc7dcfd1f3609bf90b78042552e34560fe2ef292ea35ec2f93a8dc744f12ba05dac7c4a76316417f7
+  data.tar.gz: 5645d82b34831f41eacd354e69a573a7e566c488dd6686e9b552e704953319c4733715bbe34e13efd9007af1e75ad122b9e6c33d5b3c923d312b4d37b8d17fc0

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.2.1] - 2022-06-17
+
+- Add methods and utilities to get and set data in the response.
+
 ## [0.2.0] - 2022-06-01
 
 - Allow to set the authentication token on the client skipping login step.

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    kaze_client (0.1.1p0)
+    kaze_client (0.2.0)
       httparty (~> 0.18, >= 0.18.1)
+      jsonpath (~> 1.1, >= 1.1.2)
 
 GEM
   remote: https://rubygems.org/
@@ -18,9 +19,12 @@ GEM
     io-console (0.5.11)
     irb (1.4.1)
       reline (>= 0.3.0)
+    jsonpath (1.1.2)
+      multi_json
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2022.0105)
+    multi_json (1.15.0)
     multi_xml (0.6.0)
     parallel (1.22.1)
     parser (3.1.2.0)

data/kaze_client.gemspec

@@ -32,5 +32,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_runtime_dependency 'httparty', '~> 0.18', '>= 0.18.1'
+  spec.add_runtime_dependency 'jsonpath', '~> 1.1', '>= 1.1.2'
   # spec.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/kaze_client/json_utils.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module KazeClient
+  # @author ciappa_m@modulotech.fr
+  # Utility methods to interact with JSON data
+  # @see KazeClient::Response
+  # @since 0.2.1
+  module JsonUtils
+    # Fetch nodes in given JSON
+    #
+    # @param json [KazeClient::Response,Hash,String] The JSON to analyze
+    # @param path [String] A JSONpath - https://goessner.net/articles/JsonPath/
+    # @return [Array] The nodes or data corresponding to the path
+    def self.fetch_nodes(json, path)
+      json = case json
+             when ::KazeClient::Response
+               json.parsed_response
+             when String
+               JSON.parse(json)
+             else
+               json
+             end
+
+      JsonPath.on(json, path)
+    end
+
+    # Fetch a node in given JSON
+    #
+    # @param json [KazeClient::Response,Hash,String] The JSON to analyze
+    # @param path [String] A JSONpath - https://goessner.net/articles/JsonPath/
+    # @return [Object,nil] The node or data corresponding to the path or nil
+    def self.fetch_node(json, path)
+      fetch_nodes(json, path).first
+    end
+  end
+end

data/lib/kaze_client/response.rb

@@ -30,5 +30,48 @@ module KazeClient
     def respond_to_missing?(method_name, include_private = false)
       %i[original_response parsed_response].include?(method_name) || super
     end
+
+    # Find the child whose id is the given one in this response
+    #
+    # @param id [String] The id of the child to find
+    # @return [Hash,nil] The child or nil if not found
+    # @see KazeClient::JsonUtils.fetch_node
+    def fetch_child(id)
+      ::KazeClient::JsonUtils.fetch_node(self, %{$..children[?(@['id'] == '#{id}')]})
+    end
+
+    # Find the first child with the given id and return the given field
+    #
+    # @param id [String] The id of the child to find
+    # @param field [String] The name of the searched field
+    # @return [Object,nil] The value of the field or nil if not found
+    # @see #fetch_child
+    def fetch_data_from_child(id, field: 'data')
+      fetch_child(id)&.[](field)
+    end
+
+    # Find all the widget in this response.
+    # Technically, it fetch all the children whose type is +widget_*+
+    #
+    # @return [Array] The list of widgets
+    # @see KazeClient::JsonUtils.fetch_nodes
+    def fetch_widgets
+      ::KazeClient::JsonUtils.fetch_nodes(self, %{$..children[?(@['type'] =~ /^widget_/)]})
+    end
+
+    # Find the first child with the given id and update value of the given field
+    # Does nothing when +id+ was not found.
+    # Add a field when +field+ is not found.
+    #
+    # @param id [String] The id of the child to find
+    # @param value [Object] The value to set on the field
+    # @param field [String] The name of the searched field
+    # @return [KazeClient::Response] The response itself for chaining
+    # @see #fetch_child
+    def update_data_in_child(id, value, field: 'data')
+      fetch_child(id)&.[]=(field.to_s, value)
+
+      self
+    end
   end
 end

data/lib/kaze_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KazeClient
-  VERSION = '0.2.0'
+  VERSION = '0.2.1'
 end

data/lib/kaze_client.rb

@@ -4,13 +4,15 @@
 require 'activesupport/blank'
 require 'activesupport/camelize'
 
-# Require HTTParty
+# Require third-part libraries
 require 'httparty'
+require 'jsonpath'
 
 # Require the version number
 require_relative 'kaze_client/version'
 
 # Require the different parts of the gem
+require_relative 'kaze_client/json_utils'
 require_relative 'kaze_client/errors'
 require_relative 'kaze_client/requests'
 require_relative 'kaze_client/response'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kaze_client
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Matthieu Ciappara
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-06-01 00:00:00.000000000 Z
+date: 2022-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -30,6 +30,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.18.1
+- !ruby/object:Gem::Dependency
+  name: jsonpath
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.2
 description: |
   This is the official Ruby client library for Kaze (https://www.kaze.so/) API.
 
@@ -68,6 +88,7 @@ files:
 - lib/kaze_client/error/not_found.rb
 - lib/kaze_client/error/unauthorized.rb
 - lib/kaze_client/errors.rb
+- lib/kaze_client/json_utils.rb
 - lib/kaze_client/request/request.rb
 - lib/kaze_client/request/requests/assign_performer_request.rb
 - lib/kaze_client/request/requests/create_job_request.rb