linzer 0.7.6 → 0.7.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6970d4c0634d9f8ffdcbecae27ff0b20333ef8da90495370a53e36ce6a8d395a
-  data.tar.gz: 812c0af83a7714bb661cf9d3281dfceaa9561218f55f65147bbaa5b7eac15226
+  metadata.gz: fcae916cefddaddfc6fd6b58ab110eceda2225e5b525c984fa20eba378d80262
+  data.tar.gz: 896938aeafbca006f944a950bd0151df60f960ee7541ee98fe6aff2ffee9754f
 SHA512:
-  metadata.gz: 488084cc654361afeb20731c4d96f77ed3edd8a605f40461cbefde97a10302cb222e9dc2240370bd11e295341ce47fecc6dbc2dc1f05cb5e9fe7c33e9ba79878
-  data.tar.gz: e60676427d080d270abb2c1e4ba300480d668a2e2e07af794770fdf2e5c651d99965250fc24da715cb606121fb2404aaef84c1928ae53df4eb7a28e5e9dc502a
+  metadata.gz: 89b1873e0664d7048142c9a16fd5414f3f568eeb01a3396d194398efa59e9e1bd40596096a433be17fa6635be9850cb641cd48b79d8ac99efe21d128c822337f
+  data.tar.gz: 61a79c4ef12ae7fbf74da3c0d99786caaa010255d099bb7c73319308a86895a4b5d531254f4bd3a7f78fb15aec1cc96f01bb02f83fa45313bae0c8910ca45b1b

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [0.7.7] - 2025-07-08
+
+(No changes since the last beta release, this new stable release just
+bundles all the features/changes introduced during 0.7.7.beta1 release)
+
+- Introduce generic adapters for typical requests and responses.
+  This allows adapter classes to stop inheriting functionality from totally
+  unrelated implementations by relying on a saner hierarchy class.
+
+## [0.7.7.beta1] - 2025-07-07
+
+- Introduce generic adapters for typical requests and responses.
+  This allows adapter classes to stop inheriting functionality from totally
+  unrelated implementations by relying on a saner hierarchy class. 
+
 ## [0.7.6] - 2025-07-03
 
 - Fix a bug in the `Linzer::Message::Adapter::HTTPGem::Response` class where

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Miguel Landaeta <miguel@miguel.cc>
+Copyright (c) 2024-2025 Miguel Landaeta <miguel@miguel.cc>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/linzer/message/adapter/abstract.rb

@@ -16,8 +16,6 @@ module Linzer
           self.class.to_s.include?("Response")
         end
 
-        # XXX: attached request as specified in RFC has to be tested for Net::HTTP classes
-        # and custom HTTP message classes
         def attached_request?
           response? && !!@attached_request
         end

data/lib/linzer/message/adapter/generic/request.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module Linzer
+  class Message
+    module Adapter
+      module Generic
+        class Request < Abstract
+          def initialize(operation, **options)
+            @operation = operation
+            freeze
+          end
+
+          def header(name)
+            @operation[name]
+          end
+
+          def attach!(signature)
+            signature.to_h.each { |h, v| @operation[h] = v }
+            @operation
+          end
+
+          private
+
+          def derived(name)
+            unimplemented_method = 'Derived field "@method" lookup is not implemented!'
+            case name.value
+            when "@method"         then raise Error, unimplemented_method
+            when "@target-uri"     then @operation.uri.to_s
+            when "@authority"      then @operation.uri.authority.downcase
+            when "@scheme"         then @operation.uri.scheme.downcase
+            when "@request-target" then @operation.uri.request_uri
+            when "@path"           then @operation.uri.path
+            when "@query"          then "?%s" % String(@operation.uri.query)
+            when "@query-param"    then query_param(name)
+            end
+          end
+
+          def query_param(name)
+            param_name = name.parameters["name"]
+            return nil if !param_name
+            decoded_param_name = URI.decode_uri_component(param_name)
+            params = CGI.parse(@operation.uri.query)
+            URI.encode_uri_component(params[decoded_param_name]&.first)
+          end
+
+          def field(name)
+            has_tr = name.parameters["tr"]
+            return nil if has_tr # HTTP requests don't have trailer fields
+            value = @operation[name.value.to_s]
+            value.dup&.strip
+          end
+        end
+      end
+    end
+  end
+end

data/lib/linzer/message/adapter/generic/response.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Linzer
+  class Message
+    module Adapter
+      module Generic
+        class Response < Abstract
+          def initialize(operation, **options)
+            @operation = operation
+            attached_request = options[:attached_request]
+            @attached_request = attached_request ? Message.new(attached_request) : nil
+            validate_attached_request @attached_request if @attached_request
+            freeze
+          end
+
+          def header(name)
+            @operation[name]
+          end
+
+          def attach!(signature)
+            signature.to_h.each { |h, v| @operation[h] = v }
+            @operation
+          end
+
+          private
+
+          def derived(name)
+            raise Linzer::Error, "Sub-classes are required to implement this method!"
+          end
+
+          def field(name)
+            has_tr = name.parameters["tr"]
+            return nil if has_tr # is there a library actually supporting trailers?
+            value = @operation[name.value.to_s]
+            value.dup&.strip
+          end
+        end
+      end
+    end
+  end
+end

data/lib/linzer/message/adapter/http_gem/request.rb

@@ -4,11 +4,7 @@ module Linzer
   class Message
     module Adapter
       module HTTPGem
-        class Request < Linzer::Message::Adapter::NetHTTP::Request
-          def header(name)
-            @operation[name]
-          end
-
+        class Request < Generic::Request
           private
 
           def derived(name)

data/lib/linzer/message/adapter/http_gem/response.rb

@@ -1,14 +1,15 @@
 # frozen_string_literal: true
 
-# Example HTTP message adapter for HTTP::Response class from http ruby gem.
+# HTTP message adapter for HTTP::Response class from http ruby gem.
 # https://github.com/httprb/http
-# It's not required automatically to avoid making http gem a dependency.
+#
+# It's not loaded automatically to avoid making http gem a dependency.
 #
 module Linzer
   class Message
     module Adapter
       module HTTPGem
-        class Response < Linzer::Message::Adapter::NetHTTP::Response
+        class Response < Generic::Response
           private
 
           def derived(name)

data/lib/linzer/message/adapter/net_http/request.rb

@@ -1,54 +1,15 @@
 # frozen_string_literal: true
 
-require "cgi"
-
 module Linzer
   class Message
     module Adapter
       module NetHTTP
-        class Request < Abstract
-          def initialize(operation, **options)
-            @operation = operation
-            freeze
-          end
-
-          def header(name)
-            @operation[name]
-          end
-
-          def attach!(signature)
-            signature.to_h.each { |h, v| @operation[h] = v }
-            @operation
-          end
-
+        class Request < Generic::Request
           private
 
           def derived(name)
-            case name.value
-            when "@method"         then @operation.method
-            when "@target-uri"     then @operation.uri.to_s
-            when "@authority"      then @operation.uri.authority.downcase
-            when "@scheme"         then @operation.uri.scheme.downcase
-            when "@request-target" then @operation.uri.request_uri
-            when "@path"           then @operation.uri.path
-            when "@query"          then "?%s" % String(@operation.uri.query)
-            when "@query-param"    then query_param(name)
-            end
-          end
-
-          def query_param(name)
-            param_name = name.parameters["name"]
-            return nil if !param_name
-            decoded_param_name = URI.decode_uri_component(param_name)
-            params = CGI.parse(@operation.uri.query)
-            URI.encode_uri_component(params[decoded_param_name]&.first)
-          end
-
-          def field(name)
-            has_tr = name.parameters["tr"]
-            return nil if has_tr # HTTP requests don't have trailer fields
-            value = @operation[name.value.to_s]
-            value.dup&.strip
+            return @operation.method if name.value == "@method"
+            super
           end
         end
       end

data/lib/linzer/message/adapter/net_http/response.rb

@@ -4,24 +4,7 @@ module Linzer
   class Message
     module Adapter
       module NetHTTP
-        class Response < Abstract
-          def initialize(operation, **options)
-            @operation = operation
-            attached_request = options[:attached_request]
-            @attached_request = attached_request ? Message.new(attached_request) : nil
-            validate_attached_request @attached_request if @attached_request
-            freeze
-          end
-
-          def header(name)
-            @operation[name]
-          end
-
-          def attach!(signature)
-            signature.to_h.each { |h, v| @operation[h] = v }
-            @operation
-          end
-
+        class Response < Generic::Response
           private
 
           def derived(name)
@@ -29,14 +12,6 @@ module Linzer
             when "@status" then @operation.code.to_i
             end
           end
-
-          # XXX: this implementation is incomplete, e.g.: ;bs parameter is not supported yet
-          def field(name)
-            has_tr = name.parameters["tr"]
-            return nil if has_tr # Net::HTTP doesn't support trailers
-            value = @operation[name.value.to_s]
-            value.dup&.strip
-          end
         end
       end
     end

data/lib/linzer/message/adapter.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "adapter/abstract"
+require_relative "adapter/generic/request"
+require_relative "adapter/generic/response"
 require_relative "adapter/rack/common"
 require_relative "adapter/rack/request"
 require_relative "adapter/rack/response"

data/lib/linzer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Linzer
-  VERSION = "0.7.6"
+  VERSION = "0.7.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linzer
 version: !ruby/object:Gem::Version
-  version: 0.7.6
+  version: 0.7.7
 platform: ruby
 authors:
 - Miguel Landaeta
@@ -203,6 +203,8 @@ files:
 - lib/linzer/message.rb
 - lib/linzer/message/adapter.rb
 - lib/linzer/message/adapter/abstract.rb
+- lib/linzer/message/adapter/generic/request.rb
+- lib/linzer/message/adapter/generic/response.rb
 - lib/linzer/message/adapter/http_gem/request.rb
 - lib/linzer/message/adapter/http_gem/response.rb
 - lib/linzer/message/adapter/net_http/request.rb