lownode 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: baff3ab2842de9d3e8a395ab89cb68bac58bbd0916f55981cfd53f71d44c3cf8
+  data.tar.gz: 508ba8d387fbc7a94002a5e3f5d405c42d78c4d6763f3522f715cd200737a0cb
+SHA512:
+  metadata.gz: b5685b9ac1b58d7f29fc0c557b14ed25ef9c75576e72f71552b4974199d465e2da12818fe71a0f73008059493797ca1a42ccc2dd19c3a3078e3eb54c5a44a2dc
+  data.tar.gz: bb79da2d930fc5a743952eb8ac4a9864a4a44d92abf05cf7385306d458ee36ad5d6c5b81bffd69645abf14952de66e506eba845afeb9efd4b4879065a54cd7e3

data/lib/lownode.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'observers'
+require 'lowtype'
+require 'lowevent'
+require 'lowloop' # TODO: ResponseFactory should be done in LowLoop, which is where the class lives already anyway.
+
+require_relative 'templates/renderer'
+
+class LowNode
+  extend Observers
+
+  include LowType
+  include Low::Events
+  include Low::Types
+  include Low::Templates::Renderer
+
+  attr_reader :event
+
+  def initialize(event: nil)
+    @event = event
+  end
+
+  # TODO: Rename "handle" method/action to more specific "route" and maybe split out into module too.
+  def handle(event:)
+    nil
+  end
+
+  class << self
+    def handle(event:)
+      new(event:).handle(event:)
+    end
+
+    def inherited(child)
+      child.include LowType
+      increase_count
+    end
+
+    def count
+      @count ||= 0
+    end
+
+    def increase_count
+      @count = count + 1
+    end
+  end
+end

data/lib/templates/renderer.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative 'template'
+
+module Low
+  module Templates
+    # Use the Method Factory pattern to ".render -> .new -> #initialize -> #render" a LowNode.
+    module Renderer
+      # 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.
+      def render_template(parent_binding: nil, slot_node: nil, props: {}, event: nil, **kwargs)
+        template = self.class.template
+
+        # NOTE: We currently set local variables on this local binding, not the receiver's binding.
+        # TODO: Should we create an "instance_binding" method on LowNode and use that binding instead?
+        current_binding = binding
+
+        template.params.each do |param|
+          # The event keyword is already a local variable on this binding.
+          next if param == :event
+
+          variable = props[param] || kwargs[param] || raise(ArgumentError, "Missing argument: '#{param}'")
+          current_binding.local_variable_set(param, variable)
+        end
+
+        template.engine.render(ast: template.ast, current_binding:, parent_binding:, slot_node:)
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        # Accepts all arguments but only sends arguments required by the sub class.
+        def render(**)
+          # GOAL: Make return value configurable; ResponseEvent, Response, or body.
+          body = response_body(**)
+
+          return if body.nil? || body == ''
+
+          # TODO: ResponseFactory should be done in LowLoop, which is where the class lives already anyway.
+          response = Low::ResponseFactory.html(body:)
+          Low::Events::ResponseEvent.new(response:).tap(&:branch)
+        end
+
+        # Dirload hook.
+        def template
+          @template
+        end
+
+        # Dirload hook.
+        def build_template(template:, params:, engine:, namespace:)
+          @template = Template.new(template:, params:, engine:, namespace:)
+        end
+
+        private
+
+        def response_body(**kwargs)
+          node = new(**kwargs)
+
+          return node.render_template(**kwargs) if @template
+          return node.render(**kwargs) if node.method(:render).arity > 0
+
+          node.render
+        end
+      end
+    end
+  end
+end

data/lib/templates/template.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Low
+  module Templates
+    class Template
+      attr_reader :template, :params, :namespace, :engine, :ast
+
+      def initialize(template:, params:, namespace:, engine:)
+        @template = template
+        @params = params
+        @namespace = namespace
+
+        @engine = engine
+        @ast = engine.ast(template:, namespace:)
+      end
+    end
+  end
+end

data/lib/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Low
+  module Node
+    VERSION = '0.5.2'
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: lownode
+version: !ruby/object:Gem::Version
+  version: 0.5.2
+platform: ruby
+authors:
+- maedi
+bindir: exe
+cert_chain: []
+date: 2026-10-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lowevent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: lowloop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: lowtype
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: antlers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: observers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- maediprichard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/lownode.rb
+- lib/templates/renderer.rb
+- lib/templates/template.rb
+- lib/version.rb
+homepage: https://github.com/low-rb/lownode
+licenses: []
+metadata:
+  homepage_uri: https://github.com/low-rb/lownode
+  source_code_uri: https://github.com/low-rb/lownode/src/branch/main
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Flexible building blocks
+test_files: []