dryer_clients 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 444ea8835abfd4a2916e899334724404a51bf0a1c17fa8b5d53f2d85f182f498
+  data.tar.gz: fef7016f3011677d5e049484e94b9301de36fc78bb84ac015bad9546c8a7a276
+SHA512:
+  metadata.gz: 4d2eae4ef4347fa02cd488901182927561d78ec17ee683bc016bbff8e9dfb46811c660f6bf6f2bdff955c9c04781910def4e4f245dc8468b8d6b4e963e4aefb2
+  data.tar.gz: 82524d96f45ab440a097f2596d5496d1092143fe2a234a1f7a5feff1aad7695964c5a3c4e4d20a55d45ea3871c4dac440814803fe31225cec8bb8c34cb397b6b

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,52 @@
+# Dryer Clients
+A gem providing that generates an API client gem based on an api defintion.
+The API defintions depend heavily on [dry-validation](https://dry-rb.org/gems/dry-validation/1.8/) contracts
+for header/request/response validation
+
+## Installation
+add the following to you gemfile
+```
+gem "dryer_clients"
+```
+
+## Usage
+To generate a client gem for an API there are two steps:
+
+1. Define the api. [Check out the schema definition here.](./lib/dryer/clients/api_descriptions/description_schema.rb)
+Note that this is schema is a subset of the schema used by [dryer_routes](github.com/jbernie/dryer_routes),
+so any definition that works with the dryer_routes gem, will also work here.
+
+2. Generate your client. I set up mine as part of a rake task.
+```ruby
+Dryer::Clients::Gems::Create.call(
+  gem_name: 'my_special_gem_name,
+  output_directory: './generated/ruby_client,
+  api_description: './path_to_my_api_description_file',
+  contract_directory: './directory_where_all_my_dry-validation_contracts_are'
+)
+```
+
+When run, this will output a gem in the specified output directory. It can be published/used like any other
+ruby gem.
+
+### Caveats
+Due to the loosey goosey nature of how ruby handles module loading, when passing in
+the contract directory, make sure that there are no external dependencies outside of
+the files passed in (other than the dry-validation gem), otherwise you will get a
+'not found' error when the gem tries to load some class that is not included in the gem.
+
+## Development
+This gem is set up to be developed using [Nix](https://nixos.org/) and
+[ruby_gem_dev_shell](https://github.com/jbernie2/ruby_gem_dev_shell)
+Once you have nix installed you can run `make env` to enter the development
+environment and then `make` to see the list of available commands
+
+## Contributing
+Please create a github issue to report any problems using the Gem.
+Thanks for your help in making testing easier for everyone!
+
+## Versioning
+Dryer Clients follows Semantic Versioning 2.0 as defined at https://semver.org.
+
+## License
+This code is free to use under the terms of the MIT license.

data/dryer_clients.gemspec

@@ -0,0 +1,32 @@
+Gem::Specification.new do |spec|
+  spec.name                  = 'dryer_clients'
+  spec.version               = "0.1.0"
+  spec.authors               = ['John Bernier']
+  spec.email                 = ['john.b.bernier@gmail.com']
+  spec.summary               = 'Library that leverages dry contracts to generate API clients'
+  spec.description           = <<~DOC
+    Given a description of an API, generates a ruby client for that API.
+  DOC
+  spec.homepage              = 'https://github.com/jbernie2/dryer_clients'
+  spec.license               = 'MIT'
+  spec.platform              = Gem::Platform::RUBY
+  spec.required_ruby_version = '>= 3.0.0'
+  spec.files = Dir[
+    'dryer_clients.gemspec',
+    'README.md',
+    'LICENSE',
+    'CHANGELOG.md',
+    'lib/**/*.rb',
+    '.github/*.md',
+    'Gemfile'
+  ]
+
+  spec.add_dependency "zeitwerk", "~> 2.6"
+  spec.add_dependency "dry-validation", "~> 1.10"
+  spec.add_dependency "dry-monads", "~> 1.6"
+  spec.add_dependency "dryer_services", "~> 2.0"
+
+  spec.add_development_dependency "rspec", "~> 3.10"
+  spec.add_development_dependency "webmock", "~> 3.14"
+  spec.add_development_dependency "debug", "~> 1.8"
+end

data/lib/dryer/clients/api_descriptions/description_schema.rb

@@ -0,0 +1,83 @@
+require 'dry-validation'
+
+module Dryer
+  module Clients
+    module ApiDescriptions
+      class DescriptionSchema < Dry::Validation::Contract
+
+        params do
+          required(:url).filled(:string)
+          required(:actions).filled(:hash)
+        end
+
+        class ActionSchema < Dry::Validation::Contract
+          params do
+            required(:method).filled(:symbol)
+            optional(:request_contract)
+            optional(:url_parameters_contract)
+            optional(:headers_contract)
+            optional(:response_contracts).hash()
+          end
+
+          rule(:request_contract) do
+            unless valid_contract?(value)
+              key.failure('must be a dry-validation contract')
+            end
+          end
+
+          rule(:url_parameters_contract) do
+            unless valid_contract?(value)
+              key.failure('must be a dry-validation contract')
+            end
+          end
+
+          rule(:headers_contract) do
+            unless valid_contract?(value)
+              key.failure('must be a dry-validation contract')
+            end
+          end
+
+          rule(:response_contracts) do
+            values[:response_contracts].each do |key, value|
+              unless valid_contract?(value)
+                key(:response_contracts).failure(
+                  'must be a dry-validation contract'
+                )
+              end
+            end if values[:response_contracts]
+          end
+
+          def valid_contract?(value)
+            case value
+            when Class
+              value <= Dry::Validation::Contract
+            when String
+              begin
+                contract_class = Module.const_get(value)
+                contract_class <= Dry::Validation::Contract
+              rescue NameError => e
+                false
+              end
+            else
+                true
+            end
+          end
+        end
+
+        rule(:actions) do
+          values[:actions].each do |key, value|
+            res = ActionSchema.new.call(value)
+            if !res.success?
+              res.errors.to_h.each do |name, messages|
+                messages.each do |msg|
+                  key([key_name, name]).failure(msg)
+                end
+              end
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/dryer/clients/api_descriptions/resources/generate_name.rb

@@ -0,0 +1,26 @@
+require 'dryer_services'
+
+module Dryer
+  module Clients
+    module ApiDescriptions
+      module Resources
+        class GenerateName < Dryer::Services::SimpleService
+          def initialize(resource)
+            @resource = resource
+          end
+
+          def call
+            resource[:url]
+              .split("/")
+              .reject { |part| part.start_with?(":") }
+              .reject { |part| part.empty? }
+              .join("_")
+          end
+
+          attr_reader :resource
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/create.rb

@@ -0,0 +1,44 @@
+require 'dryer_services'
+
+module Dryer
+  module Clients
+    class Create < Dryer::Services::SimpleService
+
+      def initialize(*api_desc)
+        if api_desc.is_a?(Array) && api_desc[0].is_a?(Array)
+          @api_desc = api_desc[0]
+        else
+          @api_desc = api_desc || []
+        end
+      end
+
+      def call
+        validate_api_description.then do |errors|
+          if errors.empty?
+            GeneratedClients::Create.call(api_desc)
+          else
+            raise errors
+          end
+        end
+      end
+
+      private
+      attr_reader :api_desc
+
+      def validate_api_description
+        errors = api_desc.map do |r|
+          ApiDescriptions::DescriptionSchema.new.call(r)
+        end.select { |r| !r.errors.empty? }
+
+        if !errors.empty?
+          messages = errors.inject({}) do |messages, e|
+            messages.merge(e.errors.to_h)
+          end
+          messages
+        else
+          []
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/gems/api_description_files/create.rb

@@ -0,0 +1,72 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module ApiDescriptionFiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            gem_module_name:,
+            api_description:,
+            output_directory:
+          )
+            @gem_module_name = gem_module_name
+            @api_description = api_description
+            @output_directory = output_directory
+          end
+
+          def call
+            {
+              path: "#{output_directory}/api_description.rb",
+              contents: api_description_file_contents(stringify_class_names(api_description))
+            }
+          end
+
+          private
+          attr_reader :gem_module_name,
+            :output_directory,
+            :api_description
+
+          def api_description_file_contents(description)
+            <<~FILE
+            module #{gem_module_name}
+              class ApiDescription
+                def self.definition
+                  #{description}
+                end
+              end
+            end
+            FILE
+          end
+
+          def stringify_class_names(description)
+            case description
+            when Array
+              description.map { |h| stringify_hash(h) }
+            when Hash
+              [ stringify_hash(description) ]
+            end
+          end
+
+          def stringify_hash(hash)
+            hash.inject({}) do |acc, (key, value)|
+              acc[key] = case value
+                when Class
+                  "#{gem_module_name}::#{value.to_s}"
+                when Hash
+                  stringify_hash(value)
+                else
+                  value
+                end
+              acc
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/gems/client_files/create.rb

@@ -0,0 +1,54 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module ClientFiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            gem_module_name:,
+            output_directory:
+          )
+            @gem_module_name = gem_module_name
+            @output_directory = output_directory
+          end
+
+          def call
+            {
+              path: "#{output_directory}/client.rb",
+              contents: file_contents
+            }
+          end
+
+          private
+          attr_reader :gem_module_name,
+            :output_directory
+
+          def file_contents
+            <<~CLIENT
+              module #{gem_module_name}
+                class Client
+                  def initialize(base_url)
+                    @base_url = base_url
+                  end
+
+                  def client
+                    @client ||= Dryer::Clients::Create.call(
+                      ApiDescription.definition
+                    ).new(base_url)
+                  end
+
+                  attr_reader :base_url
+                end
+              end
+            CLIENT
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/gems/contract_files/create.rb

@@ -0,0 +1,56 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module ContractFiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            gem_module_name:,
+            input_directory:,
+            output_directory:
+          )
+            @gem_module_name = gem_module_name
+            @input_directory = input_directory
+            @output_directory = output_directory
+          end
+
+          def call
+            input_paths.map do |input|
+              contents = File.read(input)
+              {
+                path: output_path(input),
+                contents: encapsulate_in_gem_module(contents)
+              }
+            end
+          end
+
+          private
+          attr_reader :gem_module_name,
+            :input_directory,
+            :output_directory
+
+          def input_paths
+            Dir["#{input_directory}/**/*"].reject { |fn| File.directory?(fn) }
+          end
+
+          def output_path(input_path)
+            output_directory + input_path.gsub(input_directory, "")
+          end
+
+          def encapsulate_in_gem_module(file_contents)
+            <<~FILE
+            module #{gem_module_name}
+              #{file_contents}
+            end
+            FILE
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/gems/create.rb

@@ -0,0 +1,85 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      class Create < Dryer::Services::SimpleService
+        def initialize(
+          gem_name:,
+          output_directory:,
+          api_description:,
+          contract_directory:
+        )
+          @gem_name = gem_name
+          @output_directory = output_directory
+          @contract_directory = contract_directory
+          @api_description = api_description
+        end
+
+        def call
+          ContractFiles::Create.call(
+            gem_module_name: camelize(gem_name),
+            input_directory: contract_directory,
+            output_directory: contract_output_dir
+          ).append(
+            ApiDescriptionFiles::Create.call(
+              gem_module_name: camelize(gem_name),
+              api_description: api_description,
+              output_directory: dependencies_dir
+            ),
+            ClientFiles::Create.call(
+              gem_module_name: camelize(gem_name),
+              output_directory: dependencies_dir
+            ),
+            MainFiles::Create.call(
+                gem_name: gem_name,
+                gem_module_name: camelize(gem_name),
+                output_directory: lib_dir
+            ),
+            Gemfiles::Create.call(
+              output_directory: output_directory
+            )
+          ).then do |files|
+            gemspec = GemspecFiles::Create.call(
+              gem_name: gem_name,
+              output_directory: output_directory
+            )
+            File.exist?(gemspec[:path]) ? files : files.append(gemspec)
+          end.map do |file|
+            FileUtils.mkdir_p(File.dirname(file[:path]))
+            File.open(File.expand_path(file[:path]), "w") do |f|
+              f.write(file[:contents])
+            end
+          end
+
+          output_directory
+        end
+
+        private
+        attr_reader :api_description,
+          :gem_name,
+          :output_directory,
+          :contract_directory
+
+        def lib_dir
+          "#{output_directory}/lib"
+        end
+
+        def dependencies_dir
+          "#{lib_dir}/#{gem_name}"
+        end
+
+        def contract_output_dir
+          "#{dependencies_dir}/contracts"
+        end
+
+        def camelize(str)
+          str.split(/[\-_]/).map{|e| e.capitalize}.join
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/gems/gemfiles/create.rb

@@ -0,0 +1,38 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module Gemfiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            output_directory:
+          )
+            @output_directory = output_directory
+          end
+
+          def call
+            {
+              path: "#{output_directory}/Gemfile",
+              contents: file_contents
+            }
+          end
+
+          private
+          attr_reader :output_directory
+
+          def file_contents
+            <<~GEMFILE
+              source 'http://rubygems.org'
+              gemspec
+            GEMFILE
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/gems/gemspec_files/create.rb

@@ -0,0 +1,63 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module GemspecFiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            gem_name:,
+            output_directory:
+          )
+            @gem_name = gem_name
+            @output_directory = output_directory
+          end
+
+          def call
+            {
+              path: "#{output_directory}/#{gem_name}.gemspec",
+              contents: file_contents
+            }
+          end
+
+          private
+          attr_reader :gem_name,
+            :output_directory
+
+          def file_contents
+            <<~GEMSPEC
+              Gem::Specification.new do |spec|
+                spec.name                  = '#{gem_name}'
+                spec.version               = "0.0.1"
+                spec.authors               = ['']
+                spec.email                 = ['']
+                spec.summary               = 'Http client generated using dryer_clients gem'
+                spec.description           = <<~DOC
+                  An Http client generated from an API description using the dryer_clients gem
+                DOC
+                spec.license               = 'MIT'
+                spec.platform              = Gem::Platform::RUBY
+                spec.required_ruby_version = '>= 3.0.0'
+                spec.files = Dir[
+                  '#{gem_name}.gemspec',
+                  'README.md',
+                  'LICENSE',
+                  'CHANGELOG.md',
+                  'lib/**/*.rb',
+                  '.github/*.md',
+                  'Gemfile'
+                ]
+                spec.add_dependency "dryer_clients", "~> 0.0"
+                spec.add_dependency "zeitwerk", "~> 2.6"
+              end
+            GEMSPEC
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/gems/main_files/create.rb

@@ -0,0 +1,48 @@
+require "dryer_services"
+require "fileutils"
+require 'pathname'
+require "debug"
+
+module Dryer
+  module Clients
+    module Gems
+      module MainFiles
+        class Create < Dryer::Services::SimpleService
+          def initialize(
+            gem_name:,
+            gem_module_name:,
+            output_directory:
+          )
+            @gem_name = gem_name
+            @gem_module_name = gem_module_name
+            @output_directory = output_directory
+          end
+
+          def call
+            {
+              path: "#{output_directory}/#{gem_name}.rb",
+              contents: file_contents
+            }
+          end
+
+          private
+          attr_reader :gem_name, :gem_module_name, :output_directory
+
+          def file_contents
+            <<~MAIN
+              require "dryer_clients"
+              require "zeitwerk"
+              loader = Zeitwerk::Loader.for_gem
+              loader.setup
+
+              module #{gem_module_name}
+
+              end
+            MAIN
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/dryer/clients/generated_client.rb

@@ -0,0 +1,11 @@
+module Dryer
+  module Clients
+    class GeneratedClient
+      def initialize(base_url)
+        @base_url = base_url
+      end
+
+      attr_reader :base_url
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/create.rb

@@ -0,0 +1,28 @@
+require 'dryer_services'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      class Create < Dryer::Services::SimpleService
+        def initialize(api_desc)
+          @api_desc = api_desc
+        end
+
+        def call
+          api_desc.inject(Class.new(GeneratedClient)) do |client, resource|
+            resource_object = Resources::Create.call(resource)
+            client.send(
+              :define_method,
+              ApiDescriptions::Resources::GenerateName.call(resource)
+            ) do
+              resource_object.new(self.base_url)
+            end
+            client
+          end
+        end
+
+        attr_reader :api_desc
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/paths/variables/validate.rb

@@ -0,0 +1,41 @@
+require 'dryer_services'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      module Paths
+        module Variables
+          class Validate < Dryer::Services::ResultService
+
+            def initialize(path, path_variables)
+              @path = path
+              @path_variables = path_variables
+            end
+
+            def call
+              if path_variable_keys.length != path_variables.length
+                Failure(
+                  StandardError.new(
+                    <<~MSG
+                      Path #{path} requires #{path_variable_keys.length} variables,
+                      #{path_variables} contains #{path_variables.length}.
+                    MSG
+                  )
+                )
+              else
+                Success()
+              end
+            end
+
+            private
+            attr_reader :path, :path_variables
+
+            def path_variable_keys
+              path.scan(/:\w+/)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/request.rb

@@ -0,0 +1,56 @@
+require 'net/http'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      class Request
+        def initialize(
+          base_url:,
+          method:,
+          path:,
+          path_variables:,
+          headers:,
+          body:
+        )
+          @base_url = base_url
+          @method = method
+          @path = path
+          @path_variables = path_variables
+          @headers = headers
+          @body = body
+        end
+
+        def send
+          uri = URI(base_url)
+          Net::HTTP.start(
+            uri.host, uri.port, use_ssl: uri.scheme == "https"
+          ) do |http|
+            http.send_request(
+              method.to_s.upcase,
+              populated_path,
+              body.to_json,
+              headers
+            )
+          end
+        end
+        
+        private
+        attr_reader :base_url, :method, :path, :path_variables, :headers, :body
+
+        def populated_path
+          path_variable_keys.to_a.zip(path_variables).inject(path) do |path, (key, value)|
+            if key && value
+              path.sub(key.to_s, value.to_s)
+            else
+              path
+            end
+          end
+        end
+
+        def path_variable_keys
+          path.scan(/:\w+/)
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/requests/validate.rb

@@ -0,0 +1,63 @@
+require 'dryer_services'
+require 'dry-monads'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      module Requests
+        class Validate < Dryer::Services::ResultService
+          include Dry::Monads[:result, :do]
+
+          def initialize(
+            path_variables:,
+            path:,
+            headers:,
+            headers_contract:,
+            body:,
+            request_contract:,
+            url_parameters:,
+            url_parameters_contract:
+          )
+            @path = path
+            @path_variables = path_variables
+            @headers = headers
+            @headers_contract = headers_contract
+            @body = body
+            @request_contract = request_contract
+            @url_parameters = url_parameters
+            @url_parameters_contract = url_parameters_contract
+          end
+
+          def call
+            yield Paths::Variables::Validate.call(path, path_variables)
+            yield validate(headers, headers_contract)
+            yield validate(body, request_contract)
+            yield validate(url_parameters, url_parameters_contract)
+          end
+
+          private
+
+          def validate(payload, contract)
+            return Success() unless contract
+
+            result = contract.new.call(payload)
+            if result.errors.empty?
+              Success()
+            else
+              Failure(StandardError.new(result.errors.to_h))
+            end
+          end
+
+          attr_reader :path_variables,
+            :path,
+            :headers,
+            :headers_contract,
+            :body,
+            :request_contract,
+            :url_parameters,
+            :url_parameters_contract
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/resource.rb

@@ -0,0 +1,14 @@
+module Dryer
+  module Clients
+    module GeneratedClients
+      class Resource
+        def initialize(base_url)
+          @base_url = base_url
+        end
+
+        private
+        attr_reader :base_url
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/resources/create.rb

@@ -0,0 +1,85 @@
+require 'dryer_services'
+require 'dry-monads'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      module Resources
+        class Create < Dryer::Services::SimpleService
+          include Dry::Monads[:result, :do]
+
+          def initialize(config)
+            @config = config
+          end
+
+          def call
+            config[:actions].inject(Class.new(Resource)) do |resource, (action_name, action_config)|
+
+              # if I don't set a variable to the config it is not in scope
+              # for the method definition
+              resource_config = config
+              request_contract = get_contract(action_config[:request_contract])
+              headers_contract = get_contract(action_config[:headers_contract])
+              url_parameters_contract = get_contract(action_config[:url_parameters_contract])
+              response_contracts = get_contracts(action_config[:response_contracts])
+
+              resource.send(
+                :define_method,
+                action_name.to_sym
+              ) do |*path_variables, **options|
+                headers = options[:headers] || {}
+                body = options[:body] || {}
+                url_parameters = options[:url_parameters] || {}
+
+                Requests::Validate.call(
+                  path_variables: path_variables,
+                  headers: headers,
+                  body: body,
+                  url_parameters: url_parameters,
+                  request_contract: request_contract,
+                  headers_contract: headers_contract,
+                  url_parameters_contract: url_parameters_contract,
+                  path: action_config[:url] || resource_config[:url]
+                ).bind do |_|
+                  raw_response = Request.new(
+                    base_url: self.base_url,
+                    method: action_config[:method],
+                    path: action_config[:url] || resource_config[:url],
+                    path_variables: path_variables,
+                    headers: headers,
+                    body: body,
+                  ).send
+
+                  Responses::Create.call(
+                    raw_response: raw_response,
+                    response_contracts: action_config[:response_contracts]
+                  )
+                rescue URI::InvalidURIError => e
+                  Dry::Monads::Failure(e)
+                end
+              end
+              resource
+            end
+          end
+
+          attr_reader :config
+
+          def get_contracts(hash)
+            hash.inject({}) do |acc, (k,v)|
+              acc[k] = get_contract(v)
+            end
+          end
+
+          def get_contract(contract)
+            case contract
+            when String
+              Module.const_get(contract)
+            when Class
+              contract
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/response.rb

@@ -0,0 +1,22 @@
+module Dryer
+  module Clients
+    module GeneratedClients
+      class Response
+        def initialize(raw_response:, errors:)
+          @raw_response = raw_response
+          @errors = errors
+        end
+
+        def code
+          raw_response.code
+        end
+
+        def body
+          raw_response.body
+        end
+
+        attr_reader :raw_response, :errors
+      end
+    end
+  end
+end

data/lib/dryer/clients/generated_clients/responses/create.rb

@@ -0,0 +1,61 @@
+require 'dryer_services'
+
+module Dryer
+  module Clients
+    module GeneratedClients
+      module Responses
+        class Create < Dryer::Services::ResultService
+          def initialize(
+            raw_response:,
+            response_contracts:
+          )
+            @raw_response = raw_response
+            @response_contracts = response_contracts
+          end
+
+          def call
+            errors = validation_errors(
+              raw_response.body,
+              response_contracts[raw_response.code]
+            )
+
+            if errors.empty?
+              Success(
+                Response.new(
+                  raw_response: raw_response,
+                  errors: errors
+                )
+              )
+            else
+              Failure(
+                StandardError.new({
+                  code: raw_response.code,
+                  body: raw_response.body,
+                  errors: errors.to_h
+                })
+              )
+            end
+          end
+
+          private
+          def validation_errors(payload, contract)
+            if contract.nil?
+              []
+            elsif is_json?(payload)
+              contract.new.call(JSON.parse(payload)).errors
+            end
+          end
+
+          def is_json?(str)
+            JSON.parse(str)
+            true
+          rescue JSON::ParserError, TypeError => e
+            false
+          end
+
+          attr_reader :raw_response, :response_contracts
+        end
+      end
+    end
+  end
+end

data/lib/dryer/clients.rb

@@ -0,0 +1,25 @@
+require "zeitwerk"
+require "rubygems"
+
+module Dryer
+  module Clients
+    def self.version
+      Gem::Specification::load(
+        "./dryer_clients.gemspec"
+      ).version
+    end
+
+    def self.loader
+      @loader ||= Zeitwerk::Loader.new.tap do |loader|
+        root = File.expand_path("..", __dir__)
+        loader.tag = "dryer_clients"
+        loader.inflector = Zeitwerk::GemInflector.new("#{root}/dryer_clients.rb")
+        loader.push_dir(root)
+        loader.ignore(
+          "#{root}/dryer_clients.rb",
+        )
+      end
+    end
+    loader.setup
+  end
+end

data/lib/dryer_clients.rb

@@ -0,0 +1 @@
+require_relative "./dryer/clients.rb"

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: dryer_clients
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- John Bernier
+autorequire:
+bindir: bin
+cert_chain: []
+date: 1980-01-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: dry-validation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: dry-monads
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: dryer_services
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.14'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: 'Given a description of an API, generates a ruby client for that API.
+
+  '
+email:
+- john.b.bernier@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- README.md
+- dryer_clients.gemspec
+- lib/dryer/clients.rb
+- lib/dryer/clients/api_descriptions/description_schema.rb
+- lib/dryer/clients/api_descriptions/resources/generate_name.rb
+- lib/dryer/clients/create.rb
+- lib/dryer/clients/gems/api_description_files/create.rb
+- lib/dryer/clients/gems/client_files/create.rb
+- lib/dryer/clients/gems/contract_files/create.rb
+- lib/dryer/clients/gems/create.rb
+- lib/dryer/clients/gems/gemfiles/create.rb
+- lib/dryer/clients/gems/gemspec_files/create.rb
+- lib/dryer/clients/gems/main_files/create.rb
+- lib/dryer/clients/generated_client.rb
+- lib/dryer/clients/generated_clients/create.rb
+- lib/dryer/clients/generated_clients/paths/variables/validate.rb
+- lib/dryer/clients/generated_clients/request.rb
+- lib/dryer/clients/generated_clients/requests/validate.rb
+- lib/dryer/clients/generated_clients/resource.rb
+- lib/dryer/clients/generated_clients/resources/create.rb
+- lib/dryer/clients/generated_clients/response.rb
+- lib/dryer/clients/generated_clients/responses/create.rb
+- lib/dryer_clients.rb
+homepage: https://github.com/jbernie2/dryer_clients
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.22
+signing_key:
+specification_version: 4
+summary: Library that leverages dry contracts to generate API clients
+test_files: []