brut 0.0.12 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4a8d9c6476f751982a2345085bfdd965f2d9c630abfecdfb01b42f7dc85fa5c
-  data.tar.gz: 554d00b1d8c973f6692779adefcd6081779f32a9424247113fa7e2727bb1a939
+  metadata.gz: 8e8b01889cc06839d9cca47e021c8b781e6f21417b08ba0658d55697285bb061
+  data.tar.gz: 4d1bf20dac16e8e6322402aa364f886235140028e53f8aa313ddc6d3b2de81c6
 SHA512:
-  metadata.gz: f3a02d1b337cc42ab78542013711b30ac6e846523b963dd840f620649454f9d1e904e406b171418a7b37ffbbe5f1cfe7dea12b7e24139dde2f148e99f588d173
-  data.tar.gz: c939f0b8bdcd92091e93f497d36e63d79eeb7bf70ed36068c29b2bcd5baeb201e05f20848d7a35db012214b400833c4a27fa2ddb3b3bc82a457614effc65fafa
+  metadata.gz: 77c38b80c31452da7db8ef80ce2532aa1d3193257193d70625135d23af01695cc5f0c3f46568988bcf0c02849af8b8f9f3f166f9065445efd90a160c1e3206c0
+  data.tar.gz: e36fa4f081d48518cf941d0e0323cde04a6370082e0a594da73221f65c1f319d29df29c7cbd5663f30b2da2776fa8ec24295a16cc55b41b94c6f1096590282f7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.0.12)
+    brut (0.0.13)
       concurrent-ruby
       i18n
       irb

data/lib/brut/front_end/generic_response.rb

@@ -0,0 +1,33 @@
+# A generic response to use when no built-in Brut construct will suffice. 
+# This mirrors the response a Rack server is intended to produce, and serves 
+# as merely a typed wrapper around that kind of response for the purposes of 
+# understanding the intention of whoever is returning this.
+#
+# Once created, {#to_ary} will convert this into the array that Rack requires.
+class Brut::FrontEnd::GenericResponse
+  # Create a generic response.  
+  #
+  # @param [Brut::FrontEnd::HttpStatus|number] http_status the status to send. If omitted, a 200 is used.
+  # Note that this value must be a valid HTTP status.
+  # @param [Hash<String|String>] headers hash of headers to send with the response.
+  # @param [String|Array<String>|IO|Enumerable] response_body the body of the response. This is passed
+  # through directly to the underlying Rack server so it should be whatever Rack expects, which is generally
+  # something that responds to `each`.
+  def initialize(http_status: 200, headers: {}, response_body:)
+    @response_body = response_body
+    @headers       = headers
+    @http_status   = Brut::FrontEnd::HttpStatus.new(http_status.to_i)
+  end
+
+  # Return this as an array suitable for use as a Rack response.
+  #
+  # @return [Array{String,3}] the response_body, headers, and http_status
+  def to_ary
+    [
+      @http_status.to_i,
+      @headers,
+      @response_body,
+    ]
+  end
+  alias deconstruct to_ary
+end

data/lib/brut/front_end/handler.rb

@@ -19,6 +19,8 @@ module Brut::FrontEnd
     # * Array of two items, with the first being an Instance of {Brut::FrontEnd::Component} and the second being an {Brut::FrontEnd::HttpStatus} -  renders that component or page, but responds with the given HTTP status. Useful for Ajax requests that don't return 200, but do return useful content.
     # * Instance of {Brut::FrontEnd::HttpStatus} - returns just that status code. Typically you would do this by calling {Brut::FrontEnd::HandlingResults#http_status}
     # * Instance of {Brut::FrontEnd::Download} - sends a file download to the browser.
+    # * Instance of {Brut::FrontEnd::GenericResponse} - sends itself as the rack response. Use this only if
+    # you cannot use one of the other options
     #
     # @return [URI|Brut::FrontEnd::Component,Array,Brut::FrontEnd::HttpStatus,Brut::FrontEnd::Download]
     def handle(**)

data/lib/brut/front_end/request_context.rb

@@ -177,6 +177,8 @@ private
         args[name] = route
       elsif !request_params.nil? && (request_params[name.to_s] || request_params[name.to_sym])
         args[name] = RichString.new(request_params[name.to_s] || request_params[name.to_sym]).to_s_or_nil
+      elsif name == :raw_params
+        args[name] = request_params || {}
       elsif type == :keyreq
         request_params_message = if request_params.nil?
                                    "no request params provied"

data/lib/brut/sinatra_helpers.rb

@@ -203,6 +203,8 @@ module Brut::SinatraHelpers
             http_status.to_i
           in Brut::FrontEnd::Download => download
             [ 200, download.headers, download.data ]
+          in Brut::FrontEnd::GenericResponse => response
+            response.to_ary
           else
             raise NoMatchingPatternError, "Result from #{handler.class}'s handle! method was a #{result.class}, which cannot be used to understand the response to generate"
           end

data/lib/brut/version.rb

@@ -1,4 +1,4 @@
 module Brut
   # @!visibility private
-  VERSION = "0.0.12"
+  VERSION = "0.0.13"
 end

data/lib/brut.rb

@@ -36,6 +36,7 @@ module Brut
     autoload(:HandlingResults, "brut/front_end/handling_results")
     autoload(:HttpMethod, "brut/front_end/http_method")
     autoload(:HttpStatus, "brut/front_end/http_status")
+    autoload(:GenericResponse, "brut/front_end/generic_response")
     autoload(:Middleware, "brut/front_end/middleware")
     autoload(:Middlewares, "brut/front_end/middleware")
     autoload(:Page, "brut/front_end/page")

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: brut
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.0.13
 platform: ruby
 authors:
 - David Bryant Copeland
 bindir: exe
 cert_chain: []
-date: 2025-04-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: irb
@@ -518,6 +518,7 @@ files:
 - lib/brut/front_end/forms/select_input.rb
 - lib/brut/front_end/forms/select_input_definition.rb
 - lib/brut/front_end/forms/validity_state.rb
+- lib/brut/front_end/generic_response.rb
 - lib/brut/front_end/handler.rb
 - lib/brut/front_end/handlers/csp_reporting_handler.rb
 - lib/brut/front_end/handlers/instrumentation_handler.rb
@@ -610,7 +611,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.6.7
 specification_version: 4
 summary: NOT YET RELEASED - Web Framework Built around Ruby, Web Standards, Simplicity,
   and Object-Orientation