eac_envs-http 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d855da8f92deffe9686e6f6f388334522c3e79f87c9239bd32e488e72c9e6259
+  data.tar.gz: cf49900f5908f11527516110dc0f6d325c290002a514c23008006fa68d36c939
+SHA512:
+  metadata.gz: e36804df28315e55d42c9c98cfb19a535cf6ba37d601029edde78ea377c077ba4f93ecc48ca02bae4e1e264c052503b79ac47e508404db4deaee1ca0ef0b6496
+  data.tar.gz: 1f556e7b101ece361ed3f06ae54c223bd7d99bd137779ea0b58e22af9c7e5f37fbb7d22f99500f86f4784cdc100907c2f4a7cec21de2c450a239b2859c1f77ce

data/lib/eac_envs/http/error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module EacEnvs
+  module Http
+    class Error < ::RuntimeError
+    end
+  end
+end

data/lib/eac_envs/http/request/body_field.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'eac_envs/http/request/body_field_value'
+require 'eac_ruby_utils/core_ext'
+require 'faraday/multipart/file_part'
+
+module EacEnvs
+  module Http
+    class Request
+      class BodyField
+        class << self
+          # @return [Array<EacEnvs::Http::Request::BodyField>]
+          def list_from_enumerable(enum)
+            hash = {}
+            enum.each do |v|
+              hash[v[0]] ||= []
+              hash[v[0]] << v[1]
+            end
+            list_from_hash(hash)
+          end
+
+          # @return [Array<EacEnvs::Http::Request::BodyField>]
+          def list_from_hash(hash)
+            hash.map { |k, v| new(k, v) }
+          end
+        end
+
+        common_constructor :key, :values do
+          self.key = key.to_s
+          self.values = (values.is_a?(::Array) ? values.to_a : [values])
+                        .map { |v| ::EacEnvs::Http::Request::BodyFieldValue.new(v) }
+        end
+
+        # @return [String]
+        def hash_key
+          key
+        end
+
+        # @return [Array]
+        def hash_value
+          values.map(&:to_faraday)
+        end
+
+        # @return [Boolean]
+        def with_file?
+          values.any?(&:file?)
+        end
+      end
+    end
+  end
+end

data/lib/eac_envs/http/request/body_field_value.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'eac_fs/file_info'
+require 'eac_ruby_utils/core_ext'
+require 'faraday'
+require 'faraday/multipart'
+
+module EacEnvs
+  module Http
+    class Request
+      class BodyFieldValue
+        common_constructor :value
+
+        def to_faraday
+          return value unless file?
+
+          ::Faraday::Multipart::FilePart.new(value, file_mime_type)
+        end
+
+        # @return [Boolean]
+        def file?
+          value.is_a?(::File)
+        end
+
+        # @return [String]
+        def file_mime_type
+          ::EacFs::FileInfo.new(value.path).mime_type
+        end
+      end
+    end
+  end
+end

data/lib/eac_envs/http/request/body_fields.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_envs/http/request/body_field'
+
+module EacEnvs
+  module Http
+    class Request
+      class BodyFields
+        common_constructor :source_body
+
+        # @return [Hash, nil]
+        def to_h
+          fields.if_present do |v|
+            v.each_with_object({}) { |e, a| a[e.hash_key] = e.hash_value }
+          end
+        end
+
+        # @return [Array<EacEnvs::Http::Request::BodyField>, nil]
+        def fields
+          source_body.if_present do |v|
+            next nil unless v.is_a?(::Enumerable)
+
+            if v.is_a?(::Hash)
+              ::EacEnvs::Http::Request::BodyField.list_from_hash(v)
+            else
+              ::EacEnvs::Http::Request::BodyField.list_from_enumerable(v)
+            end
+          end
+        end
+
+        # @return [Boolean]
+        def with_file?
+          fields.if_present(false) { |v| v.any?(&:with_file?) }
+        end
+      end
+    end
+  end
+end

data/lib/eac_envs/http/request.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require 'eac_envs/http/response'
+require 'eac_ruby_utils/core_ext'
+require 'faraday'
+require 'faraday/multipart'
+
+module EacEnvs
+  module Http
+    class Request
+      BOOLEAN_MODIFIERS = %w[ssl_verify].freeze
+      COMMON_MODIFIERS = %w[auth body_data response_body_data_proc url verb].freeze
+      HASH_MODIFIERS = %w[header].freeze
+      MODIFIERS = COMMON_MODIFIERS + BOOLEAN_MODIFIERS + HASH_MODIFIERS.map(&:pluralize)
+
+      enable_immutable
+      immutable_accessor(*BOOLEAN_MODIFIERS, type: :boolean)
+      immutable_accessor(*COMMON_MODIFIERS, type: :common)
+      immutable_accessor(*HASH_MODIFIERS, type: :hash)
+
+      enable_listable
+      lists.add_symbol :verb, :get, :delete, :options, :post, :put
+
+      def basic_auth(username, password)
+        auth(::Struct.new(:username, :password).new(username, password))
+      end
+
+      # @return [Faraday::Connection]
+      def faraday_connection
+        ::Faraday.default_connection_options[:headers] = {}
+        ::Faraday::Connection.new(faraday_connection_options) do |conn|
+          if body_with_file?
+            conn.request :multipart, flat_encode: true
+          else
+            conn.request :url_encoded
+          end
+          auth.if_present { |v| conn.request :authorization, :basic, v.username, v.password }
+        end
+      end
+
+      # @return [Hash]
+      def faraday_connection_options
+        {
+          request: { params_encoder: Faraday::FlatParamsEncoder }, ssl: { verify: ssl_verify? }
+        }
+      end
+
+      # @return [Faraday::Response]
+      def faraday_response
+        conn = faraday_connection
+        conn.send(sanitized_verb, url) do |req|
+          req.headers = conn.headers.merge(headers)
+          sanitized_body_data.if_present { |v| req.body = v }
+        end
+      end
+
+      def response
+        ::EacEnvs::Http::Response.new(self)
+      end
+
+      # @return [Symbol]
+      def sanitized_verb
+        verb.if_present(VERB_GET) { |v| self.class.lists.verb.value_validate!(v) }
+      end
+
+      private
+
+      def body_fields
+        @body_fields ||= ::EacEnvs::Http::Request::BodyFields.new(body_data)
+      end
+
+      # @return [Boolean]
+      def body_with_file?
+        body_fields.with_file?
+      end
+
+      def sanitized_body_data
+        body_fields.to_h || body_data
+      end
+
+      require_sub __FILE__
+    end
+  end
+end

data/lib/eac_envs/http/response.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/hash/conversions'
+require 'eac_envs/http/error'
+require 'eac_ruby_utils/core_ext'
+require 'faraday'
+require 'json'
+
+module EacEnvs
+  module Http
+    class Response < ::StandardError
+      HEADER_LINE_PARSER = /\A([^:]+):(.*)\z/.to_parser do |m|
+        [m[1].strip, m[2].strip]
+      end
+
+      # https://www.w3.org/wiki/LinkHeader
+      LINKS_HEADER_NAME = 'Link'
+
+      # https://www.w3.org/wiki/LinkHeader
+      LINK_PARSER = /\A\<(.+)\>\s*;\s*rel\s*=\s*\"(.*)\"\z/.to_parser do |m|
+        [m[2], m[1]]
+      end
+
+      common_constructor :request
+      delegate :body_data_proc, to: :request
+
+      def body_data
+        r = performed.headers['Accept'].if_present(body_str) do |v|
+          method_name = "body_data_from_#{v.parameterize.underscore}"
+          respond_to?(method_name) ? send(method_name) : body_str
+        end
+        r = body_data_proc.call(r) if body_data_proc.present?
+        r
+      end
+
+      def body_data_or_raise
+        raise_unless_200
+
+        body_data
+      end
+
+      # @return [String]
+      def body_str
+        performed.body
+      end
+
+      def body_str_or_raise
+        raise_unless_200
+
+        body_str
+      end
+
+      def header(name)
+        hash_search(headers, name)
+      end
+
+      def headers
+        performed.header_str.each_line.map(&:strip)[1..-1].reject(&:blank?)
+                 .map { |header_line| HEADER_LINE_PARSER.parse!(header_line) }
+                 .to_h
+      end
+
+      def link(rel)
+        hash_search(links, rel)
+      end
+
+      def links
+        header(LINKS_HEADER_NAME).if_present({}) do |v|
+          v.split(',').map { |w| LINK_PARSER.parse!(w.strip) }.to_h
+        end
+      end
+
+      def raise_unless_200
+        return nil if status == 200
+
+        raise self
+      end
+
+      def status
+        performed.status.to_i
+      end
+
+      delegate :url, to: :request
+
+      def to_s
+        "URL: #{url}\nStatus: #{status}\nBody:\n\n#{body_str}"
+      end
+
+      private
+
+      def body_data_from_application_json
+        ::JSON.parse(body_str)
+      end
+
+      def body_data_from_application_xml
+        Hash.from_xml(body_str)
+      end
+
+      def hash_search(hash, key)
+        key = key.to_s.downcase
+        hash.each do |k, v|
+          return v if k.to_s.downcase == key
+        end
+        nil
+      end
+
+      def performed
+        @performed ||= request.faraday_response
+      rescue ::Faraday::Error
+        raise ::EacEnvs::Http::Error
+      end
+    end
+  end
+end

data/lib/eac_envs/http/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module EacEnvs
+  module Http
+    VERSION = '0.1.0'
+  end
+end

data/lib/eac_envs/http.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacEnvs
+  module Http
+    require_sub __FILE__
+  end
+end

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: eac_envs-http
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Put here the authors
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-03-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eac_fs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: eac_ruby_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.112'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.112'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+- !ruby/object:Gem::Dependency
+  name: aranha-parsers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+- !ruby/object:Gem::Dependency
+  name: eac_docker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: eac_ruby_gem_support
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/eac_envs/http.rb
+- lib/eac_envs/http/error.rb
+- lib/eac_envs/http/request.rb
+- lib/eac_envs/http/request/body_field.rb
+- lib/eac_envs/http/request/body_field_value.rb
+- lib/eac_envs/http/request/body_fields.rb
+- lib/eac_envs/http/response.rb
+- lib/eac_envs/http/version.rb
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: Put here de description.
+test_files: []