faraday-xml 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d4bf34c7cdf9c459325cce7cc6c4571057eafa9d9d0f3937badf593a7edf4e0
-  data.tar.gz: 905237976614eba95b0a5ff2a5089c537ecc2d6f27c18e23a622e81d30ab7dba
+  metadata.gz: fd31db052ce943d7b8f60e8396449da83c134b70f3fe59f52e105edf1105f20d
+  data.tar.gz: 80348c82aa221ff79dbb488bf11b7df6adecbb877887165899a6d057197bc12d
 SHA512:
-  metadata.gz: a15dc8568124039c2297460033ab55447197358977523a2245d1e1470f44d0ce1f9602ff0998c8cb3f63a77c64bebf70ad3b20d5c8f956b0ffb32e270d175e15
-  data.tar.gz: 5805e36c1f2418ad1428eae2c1129feb54734fa321b0f5cbcc2e8cd34c2327f9a4189ec7888e6de3b031bbac353023f7749525a5772e5f265f3ed94d71d7f555
+  metadata.gz: 33acfe362ff340f1e39f40a1610c77b98ccd89d7b0e107625fd2d7fc4ef08ed52c34166a3903cdb64514f5861a7420d181495355572d772be0b697870fb5986f
+  data.tar.gz: 347b1ab466889029e44fb4cba75d5845bcf959544154d4fc8cb653a2988397f8a7edb19e4e7115d77594e83962ac07a017c0ab15f8fba76339fc3124b6676b23

data/CHANGELOG.md

@@ -1,7 +1,11 @@
 # Changelog
 
-## [Unreleased](https://github.com/gemhome/faraday-xml/compare/v0.1.0...main)
+## [Unreleased](https://github.com/gemhome/faraday-xml/compare/v0.2.0...main)
+
+## [0.2.0](https://github.com/gemhome/faraday-xml/compare/v0.1.0...v0.2.0)
+
+*   feat: simple Hash -> XML request encoder
 
 ## [0.1.0](https://github.com/gemhome/faraday-xml/blob/v0.1.0) (2023-01-12)
 
-*   Initial release.
+*   feat: Initial release.

data/README.md

@@ -37,7 +37,8 @@ conn = Faraday.new do |builder|
     "Accept" => "application/xml",
     "Content-Type" => "application/xml;charset=UTF-8",
   )
-
+  # or builder.use Faraday::XML::Request
+  builder.request :xml # encode Hash as XML
   # or builder.use Faraday::XML::Response
   builder.response :xml # decode response bodies from XML
 end

data/lib/faraday/xml/request.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module Faraday
+  module XML
+    # Request middleware that encodes the body as XML.
+    #
+    # Processes only requests with matching Content-type or those without a type.
+    # If a request doesn't have a type but has a body, it sets the Content-type
+    # to XML MIME-type.
+    #
+    # Doesn't try to encode bodies that already are in string form.
+    class Request < Middleware # rubocop:disable Metrics/ClassLength
+      MIME_TYPE = 'application/xml'
+      MIME_TYPE_REGEX = %r{^application/(vnd\..+\+)?xml$}.freeze
+
+      def initialize(app = nil, options = {})
+        super(app)
+        @encoder_options = options.fetch(:encoder_options, {})
+      end
+
+      def on_request(env)
+        match_content_type(env) do |data|
+          env[:body] = encode(data)
+        end
+      end
+
+      def encoder
+        @encoder ||= nil
+        if @encoder.nil?
+          @encoder = set_encoder
+          @encoder && test_encoder
+        end
+        @encoder or raise 'Missing dependencies Builder'
+      end
+
+      private
+
+      def encode(data)
+        encoder.call(data)
+      end
+
+      def test_encoder
+        encode({ success: true })
+      end
+
+      def set_encoder
+        @encoder ||= # rubocop:disable Naming/MemoizedInstanceVariableName
+          begin
+            require 'builder'
+            lambda do |parameter_hash|
+              parameters_as_xml(parameter_hash)
+            end
+          rescue LoadError # rubocop:disable Lint/SuppressedException
+          end
+      end
+
+      def match_content_type(env)
+        return unless process_request?(env)
+
+        env[:request_headers][CONTENT_TYPE] ||= MIME_TYPE
+        yield env[:body] unless env[:body].respond_to?(:to_str)
+      end
+
+      def process_request?(env)
+        type = request_type(env)
+        body?(env) && (type.empty? || type.match?(MIME_TYPE_REGEX))
+      end
+
+      def body?(env)
+        (body = env[:body]) && !(body.respond_to?(:to_str) && body.empty?)
+      end
+
+      def request_type(env)
+        type = env[:request_headers][CONTENT_TYPE].to_s
+        type = type.split(';', 2).first if type.index(';')
+        type
+      end
+
+      def parameters_as_xml(parameter_hash) # rubocop:disable Metrics/MethodLength
+        xml_markup = build_xml_markup(skip_instruct: true)
+        parameter_hash.each_pair do |key, value|
+          key = key.to_s
+          if _parameter_as_xml?(value)
+            xml_markup.tag!(key) do
+              xml = _parameter_as_xml(value)
+              xml_markup << xml
+            end
+          else
+            xml_markup.tag!(key, _parameter_as_xml(value))
+          end
+        end
+        xml_markup.target!
+      end
+
+      def _parameter_as_xml?(value)
+        case value
+        when Hash, Array then true
+        else false
+        end
+      end
+
+      def _parameter_as_xml(value)
+        case value
+        when Hash
+          parameters_as_xml(value) # recursive case
+        when Array
+          _parameter_as_list_xml(value) # recursive case
+        else
+          value.to_s.encode(xml: :text) # end case
+        end
+      end
+
+      def _parameter_as_list_xml(array_of_hashes)
+        xml_markup = build_xml_markup(skip_instruct: true)
+        array_of_hashes.each do |value|
+          xml_markup << parameters_as_xml(value) # recursive case
+        end
+        xml_markup.target!
+      end
+
+      def build_xml_markup(**options)
+        # https://github.com/rails/rails/blob/86fd8d0143b1a0578b359f4b86fea94c718139ae/activesupport/lib/active_support/builder.rb
+        # https://github.com/rails/rails/blob/86fd8d0143b1a0578b359f4b86fea94c718139ae/activesupport/lib/active_support/core_ext/hash/conversions.rb
+        require 'builder'
+        options.merge!(@encoder_options)
+        options[:indent] = 2 unless options.key?(:indent)
+        xml_markup = ::Builder::XmlMarkup.new(**options)
+        if !options.delete(:skip_instruct) # rubocop:disable Style/NegatedIf
+          xml_markup.instruct! :xml, version: '1.0', encoding: 'UTF-8'
+        end
+        xml_markup
+      end
+    end
+  end
+end

data/lib/faraday/xml/response.rb

@@ -10,7 +10,6 @@ module Faraday
         @content_types = Array(options.fetch(:content_type, /\bxml$/))
         @preserve_raw = options.fetch(:preserve_raw, false)
       end
-      ruby2_keywords :initialize if respond_to?(:ruby2_keywords, true)
 
       # @param env [Faraday::Env] the environment of the response being processed.
       def on_complete(env)

data/lib/faraday/xml/version.rb

@@ -2,6 +2,6 @@
 
 module Faraday
   module XML
-    VERSION = '0.1.0'
+    VERSION = '0.2.0'
   end
 end

data/lib/faraday/xml.rb

@@ -1,11 +1,17 @@
 # frozen_string_literal: true
 
+require_relative 'xml/request'
 require_relative 'xml/response'
 require_relative 'xml/version'
 
 module Faraday
   # The Faraday::XML middleware main module
   module XML
+    # Load middleware with
+    #   conn.use Faraday::XML::Request
+    #   or
+    #   conn.request :xml
+    Faraday::Request.register_middleware(xml: Faraday::XML::Request)
     # Load middleware with
     #   conn.use Faraday::XML::Response
     #   or

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: faraday-xml
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Benjamin Fleischer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-13 00:00:00.000000000 Z
+date: 2023-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -155,6 +155,7 @@ files:
 - LICENSE.md
 - README.md
 - lib/faraday/xml.rb
+- lib/faraday/xml/request.rb
 - lib/faraday/xml/response.rb
 - lib/faraday/xml/version.rb
 homepage: https://github.com/gemhome/faraday-xml
@@ -162,8 +163,8 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/gemhome/faraday-xml/issues
-  changelog_uri: https://github.com/gemhome/faraday-xml/blob/v0.1.0/CHANGELOG.md
-  documentation_uri: http://www.rubydoc.info/gems/faraday-xml/0.1.0
+  changelog_uri: https://github.com/gemhome/faraday-xml/blob/v0.2.0/CHANGELOG.md
+  documentation_uri: http://www.rubydoc.info/gems/faraday-xml/0.2.0
   homepage_uri: https://github.com/gemhome/faraday-xml
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/gemhome/faraday-xml