graphql_connector 1.1.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf451963eb895b192df3959d06d56ea22588c2a38c284743f8289ecbebdc4e7e
-  data.tar.gz: 73b57eb9b9569feb90497f96eb286192cd96d08370a181f92ab15a8855b56294
+  metadata.gz: 4b8c2af2590f1daf462e0f348e64078c530a4c7f6833a7d8692e6bada0f11291
+  data.tar.gz: 52edb3725223b2538f91b1904fa57a071ab0b43b853f37f23242e1dbb8d7eb50
 SHA512:
-  metadata.gz: e41d9ba90e6c33af01647e08243600e19d8c0d412c7701f3d8e0d4c4d0cecd3e3b5b7312c881b8db3782ab28c911b2e5d7541f8bf655fef21e6b980923a65c55
-  data.tar.gz: 9f496a3930e93affe9401a2e7ea0217471d2438619126ba243854202696fba634ed5b592b2a6a87c78daeb592bc4e1a509d9948a7c6012e72b9105a1265c5d3b
+  metadata.gz: c82b787552cf4590bae68e4eb15103252a47660ba4a8b2d7645deb9e218034cadbca24feaf9ef610818106e322fc7916a91fdd3726d251e49c0051224666d3c2
+  data.tar.gz: 491988a32bc66f1d597d32dbf0164b5f5a23a87923ac6d4da3c0fbc8272de1b6721ba8657b35e99ad221a9bcb2860431964e22281fcba341da36f3f5dd49ba1e

data/.github/workflows/ci.yaml

@@ -0,0 +1,37 @@
+name: CI
+
+on: [push]
+
+jobs: 
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ['2.4.10', '2.5.9', '2.6.7', '2.7.3', '3.0.1']
+    name: "ruby ${{ matrix.ruby }}"
+    steps:
+      - uses: actions/checkout@v1
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install dependencies
+        run: |
+          gem install bundler
+          bundle install
+      - name: Run Test with rspec
+        run: bundle exec rspec spec
+  rubocop:
+    name: Rubocop
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7.3
+    - name: Install dependencies
+      run: |
+        gem install bundler
+        bundle install
+    - name: Build and test
+      run: |
+        bundle exec rubocop

data/CHANGELOG.md

@@ -1,3 +1,29 @@
+## 1.3.1 (2021-06-04)
+
+* add more specs to test headers and connectors
+* make the headers option optinal
+* update the readme to explain the connector functionality better
+
+## 1.3.0 (2021-06-02)
+
+* add the option to use a connector instead of init header for authorization
+  part of headers 
+
+## 1.2.1 (2021-05-25)
+
+* relax httparty dependency(`~> 0.17` => `~> 0.16`)
+
+## 1.2.0 (2020-12-22)
+
+### Features
+* Add `mutation` under server namespace and service class inclusion
+* See `README` for details
+
+## 1.1.1 (2020-5-04)
+
+### BugFix
+* Omit invalid `()` for empty conditions in `query` method
+
 ## 1.1.0 (2020-4-19)
 
 ### Features

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    graphql_connector (1.1.0)
-      httparty (~> 0.17)
+    graphql_connector (1.3.0)
+      httparty (~> 0.16)
 
 GEM
   remote: https://rubygems.org/
@@ -10,45 +10,46 @@ GEM
     ast (2.4.0)
     coderay (1.1.2)
     diff-lcs (1.3)
-    httparty (0.17.3)
+    httparty (0.18.1)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
-    jaro_winkler (1.5.3)
-    method_source (0.9.2)
+    jaro_winkler (1.5.4)
+    method_source (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2019.1009)
+    mime-types-data (3.2021.0225)
     multi_xml (0.6.0)
-    parallel (1.17.0)
-    parser (2.6.5.0)
+    parallel (1.19.1)
+    parser (2.7.1.1)
       ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
     rainbow (3.0.0)
-    rake (10.5.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.5)
+    rexml (3.2.5)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.2)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.3)
-    rubocop (0.75.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    rubocop (0.82.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      rexml
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
     ruby-progressbar (1.10.1)
-    unicode-display_width (1.6.0)
+    unicode-display_width (1.7.0)
 
 PLATFORMS
   ruby
@@ -57,9 +58,8 @@ DEPENDENCIES
   bundler (~> 2.0)
   graphql_connector!
   pry (~> 0.10)
-  rake (~> 10.0)
   rspec (~> 3.8)
   rubocop (~> 0.75)
 
 BUNDLED WITH
-   2.1.2
+   2.1.4

data/README.md

@@ -3,8 +3,7 @@
 
 [![Gem
 Version](https://badge.fury.io/rb/graphql_connector.svg)](https://badge.fury.io/rb/graphql_connector)
-[![Build
-Status](https://travis-ci.org/Garllon/graphql_connector.svg?branch=master)](https://travis-ci.org/Garllon/graphql_connector)
+[![CI](https://github.com/Garllon/graphql_connector/workflows/CI/badge.svg)](https://github.com/Garllon/graphql_connector/actions?query=workflow%3ACI)
 [![Maintainability](https://api.codeclimate.com/v1/badges/548db3cf0d078b379c84/maintainability)](https://codeclimate.com/github/Garllon/graphql_connector/maintainability)
 
 An easy connector to call your `graphql` server. Currently there is no schema
@@ -31,10 +30,31 @@ Or install it yourself as:
 You need to configure the `graphql_connector` first:
 ``` ruby
 GraphqlConnector.configure do |config|
-  config.add_server(name: 'Foo', uri: 'http://foo.com/api/graphql', headers: {})
+  config.add_server(name: 'Foo', uri: 'http://foo.com/api/graphql', headers: {}, connector: {})
+end
+```
+
+The connector is expecting that it contains a `base` connector instance and a
+`method` parameter as string, where it gets the token. WE expect that the
+method is a public method in your connector class. Currently like this:
+```ruby
+{ base: TokenAgent.new, method: 'get_authorization_header' }
+```
+
+Your method should return a hash like this:
+```ruby
+class TokenAgent
+   [...]
+   def get_authorization_header
+      [...]
+      { 'Authorization' => 'Token HERE' }
+   end
 end
 ```
 
+When you set a connector, it will override the setting in the headers for
+Authorization.
+
 For each graphql server you wish to query use `add_server`.
 
 Afterwards you will have the following options to fetch and/or mutate data with
@@ -42,6 +62,7 @@ one or many graphql servers:
 
 * `raw_query` --> [Examples](examples/raw_query_examples.rb)
 * `query` --> [Examples](examples/query_examples.rb)
+* `mutation` --> [Examples](examples/mutation_examples.rb)
 * `service class inclusion` --> [Examples](examples/departments_service_class_examples.rb)
 
 See the following sub sections for details
@@ -92,18 +113,31 @@ Example:
 
 ---
 
+### mutation
+
+Works in the same way as [query](#query)
+
+See also [here](examples/mutation_examples.rb) for example usage
+
 ### Service class inclusion
 
 This approach can be used to `graphqlize` **any** kind of ruby (service) class
-so that it has re-usable graphql query methods.
+so that it has re-usable graphql `query` and `mutation` **class methods**.
 
 * First add `extend GraphqlConnector::<server>::Query` in the the class(es) that should be `graphqlized`
-* Next for each mapping add a `add_query` or `add_raw_query` aliasing the graphql server type supports as follows:
-  * `add_query <alias>: <query type in graphql server>, params: [<any kind of query type params>], returns: [<selected_fields>]`
-  * `add_raw_query <alias>: <query string>, params: [<any kind of query type params>]`
-  * If <query type>/<query string> does not need them, omit `params`
 
-See also [here](examples/departments_service_class_examples.rb) for example usage as also in the following:
+* Then you can aliases as many graphql server types via `add_query` and/or `add_raw_query` and/or `add_mutation`:
+
+```ruby
+add_query <alias>: :<graphql_server_type>, params: [...], returns: [...]
+
+add_raw_query <alias>: 'query { ... }', params: [...]
+
+add_mutation <alias>: :<graphql_server_type>, params: [...], returns: [...]
+```
+* :grey_exclamation: If not needed omit `params`
+
+See also [here](examples/departments_service_class_examples.rb) and also here for complete example usage:
 
 ```ruby
 GraphqlConnector.configure do |config|
@@ -132,6 +166,10 @@ class Product
   add_query by_category_id: :products,
             params: :product_category,
             returns: [product_category: [:id, :name]]
+
+  add_mutation create: :createProduct,
+               params: [:name, :catgetoryId],
+               returns: [:id, :name]
 end
 
 Product.all
@@ -148,6 +186,9 @@ Product.by(id: 1, name: 'Demo Product')
 
 Product.by_category_id(product_category: { id: 10})
 => OpenStruct<product_category=<ProductCategory<id=10, name='Demo Category'>>
+
+Product.create(name: 'Another Product', catgetoryId: 10)
+=> OpenStruct<id=10, name='Another Product'>
 ```
 
 Also custom **class methods** can used to call any kind of `query` and do further selection instead:
@@ -167,6 +208,9 @@ Product.by_id(id: 1)
 => OpenStruct<id=1, name='Demo Product'>>
 ```
 
+:warning: Ensure that your custom **class method** never has the **same name** as an `<alias>` of `add_query`, `add_raw_query` or `add_mutation`. Otherwise the associated grapqhl query will not be performed because of [Ruby Open Class principle](https://ruby-lang.co/ruby-open-class/)
+
+
 Example for `raw_query`:
 
 ```ruby
@@ -188,6 +232,8 @@ Product.by(id: '1', name: 'Demo Product')
 
 ```
 
+:exclamation: There is no `add_raw_mutation` since `add_raw_query` does already cover such a case
+
 ## Development
 
 After checking out the repo, run

data/examples/departments_service_class_examples.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+# ! The following examples are used together with
+# ! https://github.com/sushie1984/rails-graphql-server
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
 uri = 'http://rails-graphql-server.herokuapp.com/api/graphql'
 GraphqlConnector.configure do |config|
   config.add_server(name: 'RailsGraphqlServer', uri: uri, headers: {})
@@ -27,6 +32,12 @@ class Department
                               }
                             }',
                 params: [:id]
+
+  # We use a nested 'input' as of convention for
+  # https://github.com/sushie1984/rails-graphql-server/blob/master/app/graphql/input_objects/department_attributes.rb
+  add_mutation create: :createDepartment,
+               params: :input,
+               returns: [department: %i[id name location]]
 end
 
 Department.all
@@ -36,3 +47,5 @@ Department.by_id(id: %w[1 2])
 Department.all_raw
 
 Department.by_id_raw(id: %w[1 2])
+
+Department.create(input: { attributes: { name: 'One', location: 'Berlin' } })

data/examples/mutation_examples.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+# ! The following examples are used together with
+# ! https://github.com/sushie1984/rails-graphql-server
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+uri = 'http://rails-graphql-server.herokuapp.com/api/graphql'
+GraphqlConnector.configure do |config|
+  config.add_server(name: 'RailsGraphqlServer', uri: uri, headers: {})
+end
+
+department_input = { attributes: { name: 'One', location: 'Berlin' } }
+return_fields = ['department': ['id', 'name', 'employees' => ['yearlySalary']]]
+GraphqlConnector::RailsGraphqlServer.mutation('createDepartment',
+                                              { input: department_input },
+                                              return_fields)

data/examples/query_examples.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+# ! The following examples are used together with
+# ! https://github.com/sushie1984/rails-graphql-server
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
 uri = 'http://rails-graphql-server.herokuapp.com/api/graphql'
 GraphqlConnector.configure do |config|
   config.add_server(name: 'RailsGraphqlServer', uri: uri, headers: {})

data/examples/raw_query_examples.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+# ! The following examples are used together with
+# ! https://github.com/sushie1984/rails-graphql-server
+# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
 GraphqlConnector.configure do |config|
   config.add_server(name: 'RailsGraphqlServer',
                     uri: 'http://rails-graphql-server.herokuapp.com/api/graphql',

data/graphql_connector.gemspec

@@ -31,11 +31,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'httparty', '~> 0.17'
+  spec.add_dependency 'httparty', '~> 0.16'
 
   spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'pry', '~> 0.10'
-  spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.8'
   spec.add_development_dependency 'rubocop', '~> 0.75'
 end

data/lib/graphql_connector.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
 require 'graphql_connector/version'
-require 'graphql_connector/query_builder'
+require 'graphql_connector/formatters/base_format'
+require 'graphql_connector/formatters/query_format'
+require 'graphql_connector/formatters/mutation_format'
 require 'graphql_connector/configuration'
 require 'graphql_connector/http_client'
 require 'graphql_connector/base_server_type'

data/lib/graphql_connector/base_server_type.rb

@@ -5,12 +5,11 @@ module GraphqlConnector
   # Class to wrap http_client calls under a specific namespaced class
   class BaseServerType
     class << self
-      def build(name, uri, headers)
+      def build(name, uri, headers = {}, connector = {})
         verify_new_client_type_for!(name)
-        base_class = class_with(uri, headers)
+        base_class = class_with(uri, headers, connector)
         base_object = GraphqlConnector.const_set(name, base_class)
-        inject_http_client(base_object)
-        inject_query_methods(base_object)
+        inject_http_client_delegations(base_object)
         create_service_class_module(base_object)
 
         base_object
@@ -40,30 +39,23 @@ module GraphqlConnector
         METHOD
       end
 
-      def class_with(uri, headers)
+      def class_with(uri, headers = {}, connector = {})
         Class.new do
-          attr_accessor :uri, :headers
-          @uri = uri
-          @headers = headers
+          attr_accessor :uri, :headers, :connector
+          @uri       = uri
+          @headers   = headers
+          @connector = connector
         end
       end
 
-      def inject_http_client(base_object)
+      def inject_http_client_delegations(base_object)
         base_object.instance_eval do
-          def http_client
-            @http_client ||= GraphqlConnector::HttpClient.new(@uri, @headers)
-          end
-        end
-      end
+          extend SingleForwardable
+          def_delegators :http_client, :query, :raw_query, :mutation
 
-      def inject_query_methods(base_object)
-        base_object.instance_eval do
-          def query(model, conditions, selected_fields)
-            http_client.query(model, conditions, selected_fields)
-          end
-
-          def raw_query(query_string, variables: {})
-            http_client.raw_query(query_string, variables: variables)
+          def http_client
+            @http_client ||=
+              GraphqlConnector::HttpClient.new(@uri, @headers, @connector)
           end
         end
       end

data/lib/graphql_connector/configuration.rb

@@ -9,8 +9,9 @@ module GraphqlConnector
       @base_server_types = {}
     end
 
-    def add_server(name:, uri:, headers:)
-      @base_server_types[name] = BaseServerType.build(name, uri, headers)
+    def add_server(name:, uri:, headers: {}, connector: {})
+      @base_server_types[name] =
+        BaseServerType.build(name, uri, headers, connector)
     end
 
     def reset!

data/lib/graphql_connector/formatters/base_format.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module GraphqlConnector
+  module Formatters
+    # Class that returns in query or mutation string format
+    class BaseFormat
+      def initialize(model, conditions, selected_fields)
+        @model = model
+        @conditions = conditions
+        @selected_fields = selected_fields
+      end
+
+      def create
+        <<-STRING
+        #{query_type} {
+          #{@model}#{arguments} {
+            #{parse_fields(@selected_fields)}
+          }
+        }
+        STRING
+      end
+
+      private
+
+      def arguments
+        conditions = @conditions.each_with_object([]) do |(key, value), array|
+          array << "#{key}: #{value_as_parameter(value)}"
+        end
+
+        return '' if conditions.empty?
+
+        "(#{conditions.join(', ')})"
+      end
+
+      def value_as_parameter(value)
+        case value
+        when Array
+          casted_values = value.map { |v| value_as_parameter(v) }
+          "[#{casted_values.join(',')}]"
+        when Hash
+          casted_values = value.map { |k, v| "#{k}: #{value_as_parameter(v)}" }
+          "{#{casted_values.join(',')}}"
+        else
+          scalar_types(value)
+        end
+      end
+
+      def scalar_types(value)
+        case value
+        when TrueClass, FalseClass, Integer, Float
+          value
+        else # fallback to string
+          '"' + value.to_s + '"'
+        end
+      end
+
+      def parse_fields(selected_fields)
+        results = selected_fields.map do |field|
+          case field
+          when Hash
+            handle_association(field)
+          else
+            field
+          end
+        end
+
+        results.join(' ')
+      end
+
+      def handle_association(hash)
+        hash.map do |key, fields|
+          "#{key} { #{parse_fields(fields)} }"
+        end
+      end
+
+      def query_type
+        raise 'query_type undefined'
+      end
+    end
+  end
+end

data/lib/graphql_connector/formatters/mutation_format.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module GraphqlConnector
+  module Formatters
+    # Class that returns in mutation string format
+    class MutationFormat < BaseFormat
+      private
+
+      def query_type
+        'mutation'
+      end
+    end
+  end
+end

data/lib/graphql_connector/formatters/query_format.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module GraphqlConnector
+  module Formatters
+    # Class that returns in query string format
+    class QueryFormat < BaseFormat
+      private
+
+      def query_type
+        'query'
+      end
+    end
+  end
+end

data/lib/graphql_connector/http_client.rb

@@ -3,25 +3,29 @@
 module GraphqlConnector
   # Wrapper class for HTTParty post query
   class HttpClient
-    def initialize(uri, headers)
+    def initialize(uri, headers = {}, connector = {})
       @uri = uri
       @headers = headers
+      @connector = connector
     end
 
     def query(model, conditions, selected_fields)
-      query_string = GraphqlConnector::QueryBuilder.new(model,
-                                                        conditions,
-                                                        selected_fields).create
+      query_string =
+        Formatters::QueryFormat.new(model, conditions, selected_fields).create
       parsed_body = raw_query(query_string)
-      result = parsed_body['data'][model.to_s]
-      return OpenStruct.new(result) unless result.is_a? Array
+      format_body(parsed_body['data'][model.to_s])
+    end
 
-      result.map { |entry| OpenStruct.new(entry) }
+    def mutation(model, inputs, selected_fields)
+      query_string =
+        Formatters::MutationFormat.new(model, inputs, selected_fields).create
+      parsed_body = raw_query(query_string)
+      format_body(parsed_body['data'][model.to_s])
     end
 
     def raw_query(query_string, variables: {})
       response = HTTParty.post(@uri,
-                               headers: @headers,
+                               headers: handle_headers,
                                body: { query: query_string,
                                        variables: variables })
       parsed_body = JSON.parse(response.body)
@@ -31,6 +35,19 @@ module GraphqlConnector
 
     private
 
+    def handle_headers
+      return @headers if @connector.empty?
+
+      @headers
+        .merge(@connector[:base].public_send(@connector[:method]))
+    end
+
+    def format_body(response_body)
+      return OpenStruct.new(response_body) unless response_body.is_a? Array
+
+      response_body.map { |entry| OpenStruct.new(entry) }
+    end
+
     def verify_response!(parsed_body)
       return unless parsed_body.key? 'errors'
 

data/lib/graphql_connector/service_classable/class_method_validator.rb

@@ -13,9 +13,9 @@ module GraphqlConnector
                                      .map(&:to_s)
                                      .include?(class_method_name.to_s)
 
-          error_msg = "The (raw_)add_query '#{class_method_name}: ... ' is "\
+          error_msg = "The method '#{class_method_name}: ... ' is "\
                       'already implemented within the context of '\
-                      "#{invoked_class} and therefore cannot be used!"
+                      "#{invoked_class} and therefore cannot be used again!"
           raise ClassMethodAlreadyImplementedError, error_msg
         end
 

data/lib/graphql_connector/service_classable/queryable.rb

@@ -38,6 +38,21 @@ module GraphqlConnector
         raw_query_keyword_method(class_method_name, query_string, params)
       end
 
+      def add_mutation(params: [], returns:, **method_to_query)
+        class_method_name = method_to_query.first[0]
+        query_type = method_to_query.first[1]
+        ReturnFieldsValidator.validate(returns)
+        ClassMethodValidator.validate_class_method(class_method_name, self)
+        ClassMethodValidator.validate_element_class_type(query_type, Symbol)
+
+        if params.empty?
+          return mutation_method(class_method_name, query_type, returns)
+        end
+
+        ParamsValidator.validate(params)
+        mutation_keyword_method(class_method_name, query_type, params, returns)
+      end
+
       private
 
       def query_method(class_method_name, query_type, return_fields)
@@ -71,6 +86,23 @@ module GraphqlConnector
           end
         METHOD
       end
+
+      def mutation_method(class_method_name, query_type, return_fields)
+        define_singleton_method class_method_name do
+          http_client.mutation(query_type, {}, return_fields.to_a)
+        end
+      end
+
+      def mutation_keyword_method(name, query_type, keywords, return_fields)
+        keywords = [keywords].flatten
+        instance_eval <<-METHOD, __FILE__, __LINE__ + 1
+          def #{name}(#{keywords.map { |keyword| "#{keyword}:" }.join(', ')})
+            http_client.mutation("#{query_type}",
+                                  #{CONDITIONS},
+                                  #{return_fields.to_a})
+          end
+        METHOD
+      end
     end
   end
 end

data/lib/graphql_connector/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GraphqlConnector
-  VERSION = '1.1.0'
+  VERSION = '1.3.1'
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: graphql_connector
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Garllon
 - sushie1984
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-04-20 00:00:00.000000000 Z
+date: 2021-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.16'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -53,20 +53,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.10'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -104,11 +90,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yaml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -117,6 +103,7 @@ files:
 - README.md
 - bin/console
 - examples/departments_service_class_examples.rb
+- examples/mutation_examples.rb
 - examples/query_examples.rb
 - examples/raw_query_examples.rb
 - graphql_connector.gemspec
@@ -124,8 +111,10 @@ files:
 - lib/graphql_connector/base_server_type.rb
 - lib/graphql_connector/configuration.rb
 - lib/graphql_connector/custom_attribute_error.rb
+- lib/graphql_connector/formatters/base_format.rb
+- lib/graphql_connector/formatters/mutation_format.rb
+- lib/graphql_connector/formatters/query_format.rb
 - lib/graphql_connector/http_client.rb
-- lib/graphql_connector/query_builder.rb
 - lib/graphql_connector/service_classable/class_method_validator.rb
 - lib/graphql_connector/service_classable/params_validator.rb
 - lib/graphql_connector/service_classable/queryable.rb
@@ -138,7 +127,7 @@ metadata:
   homepage_uri: https://github.com/Garllon/graphql_connector/blob/master/README.md
   source_code_uri: https://github.com/Garllon/graphql_connector
   changelog_uri: https://github.com/Garllon/graphql_connector/blob/master/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -153,8 +142,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.2.7
+signing_key:
 specification_version: 4
 summary: GraphQL client
 test_files: []

data/.travis.yml

@@ -1,10 +0,0 @@
----
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.4.9
-  - 2.5.7
-  - 2.6.5
-script:
-  - bundle exec rspec spec

data/lib/graphql_connector/query_builder.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-module GraphqlConnector
-  # create the graphql query_string out of the given attributes.
-  class QueryBuilder
-    def initialize(model, conditions, selected_fields)
-      @model            = model
-      @conditions       = conditions
-      @selected_fields  = selected_fields
-    end
-
-    def create
-      "query { #{main_filter} { #{parse_fields(@selected_fields)} } }"
-    end
-
-    private
-
-    def main_filter
-      conditions = @conditions.each_with_object([]) do |(key, value), array|
-        next if value.is_a? Hash # will be processed in #field_with_filter
-
-        array << "#{key}: #{value_as_parameter(value)}"
-      end
-
-      "#{@model}(#{conditions.join(', ')})"
-    end
-
-    def value_as_parameter(value)
-      case value
-      when TrueClass, FalseClass, Integer, Float
-        value
-      when Array
-        casted_values = value.map { |v| value_as_parameter(v) }
-        "[#{casted_values.join(',')}]"
-      else # fallback to string
-        '"' + value.to_s + '"'
-      end
-    end
-
-    def parse_fields(selected_fields)
-      results = selected_fields.map do |field|
-        case field
-        when Hash
-          handle_association(field)
-        else
-          field
-        end
-      end
-
-      results.join(' ')
-    end
-
-    def handle_association(hash)
-      hash.map do |key, fields|
-        "#{key} { #{parse_fields(fields)} }"
-      end
-    end
-  end
-end