lownode 0.5.5 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b68fa8f3dbf9758ac2e891d89ce312a9c4a8f36145896ee74bd2f0560665a8a6
-  data.tar.gz: 35393a675ce46a9ce662e30b337aa7aba83c695b160b1400526277fc2574d270
+  metadata.gz: b69423239598da8c8c0879744b80e05c45b57d5b7f8bc281bbb87dadb5054c92
+  data.tar.gz: 303f7cac2392a4f84c286e599ae27c673da899421c60970a75390b5d2b50c884
 SHA512:
-  metadata.gz: cab4b4836847914e458719b67c8737026481ba4ddc3978c30142f7df8107396c6e30c4a634e193760c74984e6615140ad39581f863aa15637b790ff0561411b9
-  data.tar.gz: 0c237cc521823800503aa2fefc220456db795c7d10194da9ab29dce656b3510c48752af9e4c1ada70dc36e9b6b32344ca2e2b3454c9d8febc6fe4da0ff509aba
+  metadata.gz: a53a9fb3bb5a2fdc045f21db55c5b7f31ccf08c4e9fd18bf50839ad82ea9320b347ee9bc97b00a0b99887b7c51a359dc187b12d6f184974e005f6fbc50ad6d91
+  data.tar.gz: 6f944d99e2de080df6657979ad3fb24c263bc13d51a8a52510bc5e6e3db42f2d420223cd8f66aec5700fa766fa3fb73a40a295284a0f9a45f12f57d694962deb

data/lib/templates/renderer.rb

@@ -6,8 +6,27 @@ require 'protocol/http'
 
 module Low
   module Templates
-    # Use the Method Factory pattern to ".render -> .new -> #initialize -> #render" a LowNode.
+    # Use the Method Factory pattern to ".render -> .new -> #initialize -> #render" a LowNode, and the same for its other actions.
     module Renderer
+      # Observers call actions on the node class, which the Method Factory pattern turns into the node's instance methods:
+      # ".receive -> .new -> #initialize -> #receive". Defining them up front avoids a method_missing lookup on every event.
+      ACTIONS = %i[render receive side_effect].freeze
+
+      # The HTTP verb actions, which a node has when it does "include Controller".
+      CONTROLLER_ACTIONS = %i[get query post put patch delete].freeze
+
+      # Accepts all arguments but only sends each method the arguments it takes, like initialize(limit:) and render(event:).
+      # Defined with "def" rather than "define_method" because a block with keyword arguments is slower to call.
+      def self.define_actions(mod, actions)
+        actions.each do |action|
+          mod.module_eval <<~RUBY, __FILE__, __LINE__ + 1
+            def #{action}(**kwargs)
+              response_event(body: action_body(:#{action}, kwargs), event: kwargs[:event])
+            end
+          RUBY
+        end
+      end
+
       # Antlers hook.
       # When render() contains RBX/Antlers then dirload builds a template to render with instead.
       # When lowevent is required then Antlers will send an event keyword argument as well.
@@ -33,18 +52,19 @@ module Low
         base.extend(ClassMethods)
       end
 
-      module ClassMethods
-        # Accepts all arguments but only sends each method the arguments it takes, like initialize(limit:) and render(event:).
-        def render(**kwargs)
-          # GOAL: Make return value configurable; ResponseEvent, Response, or body.
-          body = response_body(**kwargs)
-
-          return if body.nil? || body == ''
+      # Adds the HTTP verb actions to a node with "include Controller", so it can respond with "def get" and "def post".
+      module Controller
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
 
-          headers = Protocol::HTTP::Headers.new([['content-type', 'text/html']])
-          response = Protocol::HTTP::Response.new('HTTP/1.1', response_status(kwargs[:event]), headers, Protocol::HTTP::Body::Buffered.wrap(body.strip))
-          Low::Events::ResponseEvent.new(response:).tap(&:branch)
+        module ClassMethods
+          Renderer.define_actions(self, CONTROLLER_ACTIONS)
         end
+      end
+
+      module ClassMethods
+        Renderer.define_actions(self, ACTIONS)
 
         # Dirload hook.
         def template
@@ -58,16 +78,40 @@ module Low
 
         private
 
-        # Responses default to 200 but when rendering for a StatusEvent use that event's status code.
-        def response_status(event)
-          event.is_a?(Low::Events::StatusEvent) ? event.status.status_code : 200
-        end
+        # Only nodes that implement the action are initialized, so a "render" then "get" event initializes a "get" node once.
+        def action_body(action, kwargs)
+          template = action == :render && @template
+          return unless template || method_defined?(action)
 
-        def response_body(**kwargs)
           node = new(**Antlers::Keywords.accepted(instance_method(:initialize), kwargs))
-          return node.render_template(**kwargs) if @template
+          return node.render_template(**kwargs) if template
+
+          # The action is public, as method_defined? doesn't include private methods.
+          node.__send__(action, **Antlers::Keywords.accepted(node.method(action), kwargs))
+        end
+
+        # GOAL: Make return value configurable; ResponseEvent, Response, or body.
+        def response_event(body:, event:)
+          unless body.is_a?(String)
+            return body if body.is_a?(Low::Events::ResponseEvent)
+            return status_response_event(status_code: body.status_code) if body.is_a?(Low::Types::Status::StatusCode)
+          end
+          return if body.nil? || body == ''
 
-          node.render(**Antlers::Keywords.accepted(node.method(:render), kwargs))
+          headers = Protocol::HTTP::Headers.new([['content-type', 'text/html']])
+          response = Protocol::HTTP::Response.new('HTTP/1.1', response_status(event), headers, Protocol::HTTP::Body::Buffered.wrap(body.strip))
+          Low::Events::ResponseEvent.new(response:).tap(&:branch)
+        end
+
+        # Actions like "post" can return "Status[200]" to respond without a body.
+        def status_response_event(status_code:)
+          response = Protocol::HTTP::Response.new('HTTP/1.1', status_code, Protocol::HTTP::Headers.new, nil)
+          Low::Events::ResponseEvent.new(response:).tap(&:branch)
+        end
+
+        # Responses default to 200 but when rendering for a StatusEvent use that event's status code.
+        def response_status(event)
+          event.is_a?(Low::Events::StatusEvent) ? event.status.status_code : 200
         end
       end
     end

data/lib/version.rb

@@ -2,6 +2,6 @@
 
 module Low
   module Node
-    VERSION = '0.5.5'
+    VERSION = '0.5.6'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lownode
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
 platform: ruby
 authors:
 - maedi