gloo 4.2.1 → 4.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1776f8bb92860bc0338c79c0ce77a2a9eb06e22a68bf2007812c173280b109f6
-  data.tar.gz: 1beb107590b4f91bf964953c3808179ac3e0b1e2e35012ff02d7b5e0cb96a4d6
+  metadata.gz: 8433bf6ce21086f0a4ade5d45ef2c4bca77aa0d43edf087304a84b08d91ca49a
+  data.tar.gz: 0a9bb39b56d34eb411b617cd8260aaf42afc8574aa7535dc61eedef21d6fc593
 SHA512:
-  metadata.gz: 69d271ac18569be4d22bacabcdb6b5233c47c3be8db86057ed0833d0a09b028e45eca167b7e2b74a8a427ff07b1e2cb156926e3374228a05324668bd9a9c6b51
-  data.tar.gz: 113a69b5a18f303a67c363c2ddce2b22d325802e78db5e7490e5d3bf2a9f025caeba1c68cda163f0f195ae4e90fd145902256718fa1d5678704b725bf80e613e
+  metadata.gz: 80bf8f11fe5329c2475fe95839f995f6d6726f7c9798701a98d0ba80fe1bcfc3f0004c5c9fd34f931d65c8587542abdbdaba3e1bc5f0e554a91b44788690ef0f
+  data.tar.gz: 5fdecb6bfcfdf629db8f48cd7a8a8b41727d7461984d2131c697ba39e7e68113c87e5034b4ca165d67a7cb1a1ce1e693563eed0f4c2ff60c82b78c1ac05c511d

data/gloo.gemspec

@@ -46,7 +46,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'mysql2', '~> 0.5', '>= 0.5.3'
   spec.add_dependency 'sqlite3', '~> 1.4', '>= 1.4.2'
   spec.add_dependency 'os', '~> 1.1', '>= 1.1.4'
-  spec.add_dependency 'pg', '~> 1.5.4'
+  # spec.add_dependency 'pg', '~> 1.5.4'
   spec.add_dependency 'thin', '~> 1.8.2'
   spec.add_dependency 'redcarpet', '~> 3.6.0'
   spec.add_dependency 'bcrypt', '~> 3.1.20'

data/lib/VERSION

@@ -1 +1 @@
-4.2.1
+4.4.0

data/lib/VERSION_NOTES

@@ -1,3 +1,12 @@
+4.4.0 - 2025.07.30
+ - Adds form and fields
+ - Adds option to include image_tag and other asset tags in helper rendering.
+
+
+4.3.0 - 2025.07.02
+ - Removes postgres dependency (for now)
+
+
 4.2.1 - 2025.05.15
  - Fixes bug with begin and end month date messages
 

data/lib/gloo/objs/ctrl/function.rb

@@ -71,6 +71,22 @@ module Gloo
         return return_any ? return_any.value : nil
       end
 
+      #
+      # Get the params hash from the child object.
+      # Returns nil if there is none.
+      #
+      def params_hash
+        params_can = find_child PARAMS
+        return nil unless params_can
+
+        h = {}
+        params_can.children.each do |o|
+          h[ o.name ] = o.value
+        end
+
+        return h
+      end
+
 
       # ---------------------------------------------------------------------
       #    Children
@@ -156,7 +172,12 @@ module Gloo
 
         set_params args if args
         run_on_invoke
-        return_value = result
+
+        if @engine.running_app&.obj&.embedded_renderer 
+          return_value = @engine.running_app.obj.embedded_renderer.render result, params_hash
+        else
+          return_value = result
+        end
         @engine.heap.it.set_to return_value
         run_after_invoke
         

data/lib/gloo/objs/data/pg.rb

@@ -1,216 +1,216 @@
-# Author::    Eric Crane  (mailto:eric.crane@mac.com)
-# Copyright:: Copyright (c) 2023 Eric Crane.  All rights reserved.
-#
-# A Postgres database connection.
-#
-#   https://rubygems.org/gems/pg/versions/0.18.4
-#   https://github.com/ged/ruby-pg
-#   
-require 'pg'
-
-module Gloo
-  module Objs
-    class Pg < Gloo::Core::Obj
-
-      KEYWORD = 'postgres'.freeze
-      KEYWORD_SHORT = 'pg'.freeze
-
-      HOST = 'host'.freeze
-      DB = 'database'.freeze
-      USER = 'username'.freeze
-      PASSWD = 'password'.freeze
-
-      #
-      # The name of the object type.
-      #
-      def self.typename
-        return KEYWORD
-      end
-
-      #
-      # The short name of the object type.
-      #
-      def self.short_typename
-        return KEYWORD_SHORT
-      end
-
-      # ---------------------------------------------------------------------
-      #    Children
-      # ---------------------------------------------------------------------
-
-      #
-      # Does this object have children to add when an object
-      # is created in interactive mode?
-      # This does not apply during obj load, etc.
-      #
-      def add_children_on_create?
-        return true
-      end
-
-      #
-      # Add children to this object.
-      # This is used by containers to add children needed
-      # for default configurations.
-      #
-      def add_default_children
-        fac = @engine.factory
-        fac.create_string HOST, nil, self
-        fac.create_string DB, nil, self
-        fac.create_string USER, nil, self
-        fac.create_string PASSWD, nil, self
-      end
-
-      # ---------------------------------------------------------------------
-      #    Messages
-      # ---------------------------------------------------------------------
-
-      #
-      # Get a list of message names that this object receives.
-      #
-      def self.messages
-        return super + [ 'verify' ]
-      end
-
-      #
-      # SSH to the host and execute the command, then update result.
-      #
-      def msg_verify
-        return unless connects?
-
-        @engine.heap.it.set_to true
-      end
-
-      # ---------------------------------------------------------------------
-      #    DB functions (all database connections)
-      # ---------------------------------------------------------------------
-
-      #
-      # Open a connection and execute the SQL statement.
-      # Return the resulting data.
-      #
-      def query( sql, params = nil )
-        heads = []
-        data = []
-        client = pg_conn
-
-        if params
-          param_arr =  []
-          params.each do |p|
-            param_arr << { :value => p, :type => 0, :format => 0 }
-          end
-          rs = client.exec_params( sql, params )
-        else
-          rs = client.exec( sql )
-        end
-
-        if rs && ( rs.count > 0 )
-          rs[0].each do |name, val|
-            heads << name
-          end
-          rs.each_with_index do |row, index|
-            arr = []
-            row.each do |name, val|
-              arr << val
-            end
-            data << arr
-          end
-        end
-
-        return [ heads, data ]
-      end
-
-      # 
-      # Based on the result set, build a QueryResult object.
-      # 
-      def get_query_result( result )
-        return QueryResult.new result[0], result[1], @engine
-      end
-
-
-      # ---------------------------------------------------------------------
-      #    Private functions
-      # ---------------------------------------------------------------------
-
-      private
-
-      #
-      # Get the host from the child object.
-      # Returns nil if there is none.
-      #
-      def host_value
-        o = find_child HOST
-        return nil unless o
-
-        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
-        return o.value
-      end
-
-      #
-      # Get the Database name from the child object.
-      # Returns nil if there is none.
-      #
-      def db_value
-        o = find_child DB
-        return nil unless o
-
-        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
-        return o.value
-      end
-
-      #
-      # Get the Username from the child object.
-      # Returns nil if there is none.
-      #
-      def user_value
-        o = find_child USER
-        return nil unless o
-
-        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
-        return o.value
-      end
-
-      #
-      # Get the Password name from the child object.
-      # Returns nil if there is none.
-      #
-      def passwd_value
-        o = find_child PASSWD
-        return nil unless o
-
-        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
-        return o.value
-      end
-
-      #
-      # Try the connection and make sure it works.
-      # Returns true if we can establish a connection.
-      #
-      def connects?
-        begin
-          result = pg_conn.exec( "SELECT NOW()" )
-        rescue => e
-          @engine.log_exception e
-          @engine.heap.it.set_to false
-          return false
-        end
-        return true
-      end
-
-      # 
-      # Get the PG connection.
-      # 
-      def pg_conn
-        if host_value
-          conn = PG.connect(
-            host_value, 5432, '', '', 
-            db_value, 
-            user_value, 
-            passwd_value )
-        else
-          conn = PG.connect( dbname: db_value )
-        end
-      end
-
-    end
-  end
-end
+# # Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# # Copyright:: Copyright (c) 2023 Eric Crane.  All rights reserved.
+# #
+# # A Postgres database connection.
+# #
+# #   https://rubygems.org/gems/pg/versions/0.18.4
+# #   https://github.com/ged/ruby-pg
+# #   
+# require 'pg'
+
+# module Gloo
+#   module Objs
+#     class Pg < Gloo::Core::Obj
+
+#       KEYWORD = 'postgres'.freeze
+#       KEYWORD_SHORT = 'pg'.freeze
+
+#       HOST = 'host'.freeze
+#       DB = 'database'.freeze
+#       USER = 'username'.freeze
+#       PASSWD = 'password'.freeze
+
+#       #
+#       # The name of the object type.
+#       #
+#       def self.typename
+#         return KEYWORD
+#       end
+
+#       #
+#       # The short name of the object type.
+#       #
+#       def self.short_typename
+#         return KEYWORD_SHORT
+#       end
+
+#       # ---------------------------------------------------------------------
+#       #    Children
+#       # ---------------------------------------------------------------------
+
+#       #
+#       # Does this object have children to add when an object
+#       # is created in interactive mode?
+#       # This does not apply during obj load, etc.
+#       #
+#       def add_children_on_create?
+#         return true
+#       end
+
+#       #
+#       # Add children to this object.
+#       # This is used by containers to add children needed
+#       # for default configurations.
+#       #
+#       def add_default_children
+#         fac = @engine.factory
+#         fac.create_string HOST, nil, self
+#         fac.create_string DB, nil, self
+#         fac.create_string USER, nil, self
+#         fac.create_string PASSWD, nil, self
+#       end
+
+#       # ---------------------------------------------------------------------
+#       #    Messages
+#       # ---------------------------------------------------------------------
+
+#       #
+#       # Get a list of message names that this object receives.
+#       #
+#       def self.messages
+#         return super + [ 'verify' ]
+#       end
+
+#       #
+#       # SSH to the host and execute the command, then update result.
+#       #
+#       def msg_verify
+#         return unless connects?
+
+#         @engine.heap.it.set_to true
+#       end
+
+#       # ---------------------------------------------------------------------
+#       #    DB functions (all database connections)
+#       # ---------------------------------------------------------------------
+
+#       #
+#       # Open a connection and execute the SQL statement.
+#       # Return the resulting data.
+#       #
+#       def query( sql, params = nil )
+#         heads = []
+#         data = []
+#         client = pg_conn
+
+#         if params
+#           param_arr =  []
+#           params.each do |p|
+#             param_arr << { :value => p, :type => 0, :format => 0 }
+#           end
+#           rs = client.exec_params( sql, params )
+#         else
+#           rs = client.exec( sql )
+#         end
+
+#         if rs && ( rs.count > 0 )
+#           rs[0].each do |name, val|
+#             heads << name
+#           end
+#           rs.each_with_index do |row, index|
+#             arr = []
+#             row.each do |name, val|
+#               arr << val
+#             end
+#             data << arr
+#           end
+#         end
+
+#         return [ heads, data ]
+#       end
+
+#       # 
+#       # Based on the result set, build a QueryResult object.
+#       # 
+#       def get_query_result( result )
+#         return QueryResult.new result[0], result[1], @engine
+#       end
+
+
+#       # ---------------------------------------------------------------------
+#       #    Private functions
+#       # ---------------------------------------------------------------------
+
+#       private
+
+#       #
+#       # Get the host from the child object.
+#       # Returns nil if there is none.
+#       #
+#       def host_value
+#         o = find_child HOST
+#         return nil unless o
+
+#         o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+#         return o.value
+#       end
+
+#       #
+#       # Get the Database name from the child object.
+#       # Returns nil if there is none.
+#       #
+#       def db_value
+#         o = find_child DB
+#         return nil unless o
+
+#         o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+#         return o.value
+#       end
+
+#       #
+#       # Get the Username from the child object.
+#       # Returns nil if there is none.
+#       #
+#       def user_value
+#         o = find_child USER
+#         return nil unless o
+
+#         o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+#         return o.value
+#       end
+
+#       #
+#       # Get the Password name from the child object.
+#       # Returns nil if there is none.
+#       #
+#       def passwd_value
+#         o = find_child PASSWD
+#         return nil unless o
+
+#         o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+#         return o.value
+#       end
+
+#       #
+#       # Try the connection and make sure it works.
+#       # Returns true if we can establish a connection.
+#       #
+#       def connects?
+#         begin
+#           result = pg_conn.exec( "SELECT NOW()" )
+#         rescue => e
+#           @engine.log_exception e
+#           @engine.heap.it.set_to false
+#           return false
+#         end
+#         return true
+#       end
+
+#       # 
+#       # Get the PG connection.
+#       # 
+#       def pg_conn
+#         if host_value
+#           conn = PG.connect(
+#             host_value, 5432, '', '', 
+#             db_value, 
+#             user_value, 
+#             passwd_value )
+#         else
+#           conn = PG.connect( dbname: db_value )
+#         end
+#       end
+
+#     end
+#   end
+# end

data/lib/gloo/objs/web_svr/element.rb

@@ -226,6 +226,8 @@ module Gloo
             e = Gloo::Objs::Alias.resolve_alias( engine, e )
             if e.class == Element
               rendered_obj_content << e.send( render_ƒ )
+            elsif e.class == Form
+              rendered_obj_content << e.render
             elsif e
               data = render_thing e, render_ƒ, engine
               ( rendered_obj_content << data ) if data # e.render( render_ƒ )

data/lib/gloo/objs/web_svr/field.rb

@@ -0,0 +1,429 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2025 Eric Crane.  All rights reserved.
+#
+# An HTML Form Field.
+#
+# A Form Field is the definition of a form field, including label, type, etc.
+#
+
+module Gloo
+  module Objs
+    class Field < Gloo::Core::Obj
+
+      KEYWORD = 'field'.freeze
+      KEYWORD_SHORT = 'field'.freeze
+
+      # Form
+      NAME = 'name'.freeze
+      ID = 'id'.freeze
+      TYPE = 'type'.freeze
+      VALUE = 'value'.freeze
+      LABEL = 'label'.freeze
+      PLACEHOLDER = 'placeholder'.freeze
+      AUTOFOCUS = 'autofocus'.freeze
+      COLS = 'cols'.freeze
+      ROWS = 'rows'.freeze
+      DESCRIPTION = 'description'.freeze
+      CHECKED = 'checked'.freeze
+      OPTIONS = 'options'.freeze
+      
+      # Style attributes
+      FIELD_GROUP = 'field_group'.freeze
+      FIELD_LABEL = 'field_label'.freeze
+      FIELD_CONTROL = 'field_control'.freeze
+
+      #
+      # The name of the object type.
+      #
+      def self.typename
+        return KEYWORD
+      end
+
+      #
+      # The short name of the object type.
+      #
+      def self.short_typename
+        return KEYWORD_SHORT
+      end
+
+      # 
+      # Get the name for the form field.
+      # 
+      def name_value
+        o = find_child NAME
+
+        # If there is no child, use the obj's name
+        return self.name unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the type for the form field.
+      # For example, 'text', 'password', 'checkbox', etc.
+      #
+      def type_value
+        o = find_child TYPE
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the value for the form field.
+      #
+      def field_value
+        o = find_child VALUE
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the value tag for the form field.
+      #
+      def value_tag
+        value = field_value
+        return "value='#{value}'" if value
+        return ''
+      end
+
+      #
+      # Get the label for the form field.
+      #
+      def label_value
+        o = find_child LABEL
+
+        # If there is no child, use the obj's name
+        return self.name_value.capitalize unless o
+
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the label tag for the form field.
+      #
+      def label_tag
+        label = label_value
+        label_data = ''
+        if label
+          label_data = <<~HTML
+            <label class="#{field_label_styles}" for="#{name_value}">
+              #{label}
+            </label>
+          HTML
+        end
+        return label_data
+      end
+
+      #
+      # Get the placeholder for the form field.
+      #
+      def placeholder_value
+        o = find_child PLACEHOLDER
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the placeholder tag for the form field.
+      #
+      def placeholder_tag
+        placeholder = placeholder_value
+        return "placeholder='#{placeholder}'" if placeholder
+        return ''
+      end
+
+      # 
+      # Should this field autofocus?
+      # 
+      def autofocus?
+        o = find_child AUTOFOCUS
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return nil unless o
+        return o.value
+      end
+
+      #
+      # Get the autofocus tag for the form field.
+      #
+      def autofocus_tag
+        return "autofocus='autofocus'" if autofocus?
+        return ''
+      end
+
+      # 
+      # Get the cols for the form field.
+      # 
+      def cols_value
+        o = find_child COLS
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the cols tag for the form field.
+      #
+      def cols_tag
+        cols = cols_value
+        return "col-#{cols}" if cols
+        return ''
+      end
+
+      # 
+      # Get the rows for the form field.
+      # Only applies to textarea fields.
+      # 
+      def rows_value
+        o = find_child ROWS
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      #
+      # Get the rows tag for the form field.
+      # Only applies to textarea fields.
+      #
+      def rows_tag
+        rows = rows_value
+        return "rows='#{rows}'" if rows
+        return ''
+      end
+
+      #
+      # Get the description for the form field.
+      #
+      def description_value
+        o = find_child DESCRIPTION
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      # 
+      # Should this field be checked?
+      # 
+      def checked?
+        o = find_child CHECKED
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return nil unless o
+        return o.value
+      end
+
+      #
+      # Get the checked tag for the form field.
+      #
+      def checked_tag
+        return "checked='checked'" if checked?
+        return ''
+      end
+
+      # 
+      # Get options for the select list.
+      # 
+      def select_options
+        o = find_child OPTIONS
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return nil unless o
+
+        selected_value = field_value
+
+        options = ''
+        o.children.each do |child|
+          if selected_value == child.name || selected_value == child.value
+            selected = 'selected="selected"'
+          else
+            selected = ''
+          end
+          options += <<~HTML
+            <option value="#{child.name}" #{selected}>#{child.value}</option>
+          HTML
+        end
+        return options
+      end
+
+      # 
+      # Get the field group styles.
+      # 
+      def field_group_styles
+        o = find_child FIELD_GROUP
+        if o
+          o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+          return o ? o.value : ''
+        end
+        
+        return @styles[FIELD_GROUP] || ''
+      end
+
+      # 
+      # Get the field label styles.
+      # 
+      def field_label_styles
+        o = find_child FIELD_LABEL
+        if o
+          o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+          return o ? o.value : ''
+        end
+        
+        return @styles[FIELD_LABEL] || ''
+      end
+
+      # 
+      # Get the field control styles.
+      # 
+      def field_control_styles
+        o = find_child FIELD_CONTROL
+        if o
+          o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+          return o ? o.value : ''
+        end
+        
+        return @styles[FIELD_CONTROL] || ''
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Children
+      # ---------------------------------------------------------------------
+
+      #
+      # Does this object have children to add when an object
+      # is created in interactive mode?
+      # This does not apply during obj load, etc.
+      #
+      def add_children_on_create?
+        return true
+      end
+
+      #
+      # Add children to this object.
+      # This is used by containers to add children needed
+      # for default configurations.
+      #
+      def add_default_children
+        fac = @engine.factory
+
+        # Create attributes with ID and Classes
+        fac.create_string NAME, '', self
+        fac.create_string TYPE, 'text', self
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Messages
+      # ---------------------------------------------------------------------
+
+      #
+      # Get a list of message names that this object receives.
+      #
+      def self.messages
+        return super + [ 'render' ]
+      end
+
+      #
+      # Render the form field.
+      #
+      def msg_render
+        content = self.render
+        @engine.heap.it.set_to content 
+        return content
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Render
+      # ---------------------------------------------------------------------
+
+      # 
+      # Render the field, switch on type.
+      def render styles = {}
+        @styles = styles
+
+        case type_value
+        when 'text'
+          return render_text
+        when 'hidden'
+          return render_hidden
+        when 'textarea'
+          return render_textarea
+        when 'checkbox'
+          return render_checkbox
+        when 'search'
+          return render_text
+        when 'select'
+          return render_select
+        end
+      end
+
+      # 
+      # Render the hidden field as HTML.
+      # 
+      def render_hidden
+        return <<~HTML
+          <input type="hidden" #{value_tag} name="#{name_value}" id="#{name_value}" />
+        HTML
+      end
+
+      # 
+      # Render the text field as HTML.
+      # 
+      def render_text
+        return <<~HTML
+          <div class="#{field_group_styles} #{cols_tag}">
+            #{label_tag}
+            <input #{placeholder_tag} #{autofocus_tag} #{rows_tag}
+              class="#{field_control_styles}" 
+              type="#{type_value}" #{value_tag}
+              name="#{name_value}" id="#{name_value}" />
+          </div>
+        HTML
+      end
+
+      # 
+      # Render the textarea field as HTML.
+      # 
+      def render_textarea
+        return <<~HTML
+          <div class="#{field_group_styles} #{cols_tag}">
+            #{label_tag}
+            <textarea #{placeholder_tag} #{autofocus_tag} #{rows_tag}
+              class="#{field_control_styles}" 
+              name="#{name_value}" id="#{name_value}">#{field_value}</textarea>
+          </div>
+        HTML
+      end
+
+      # 
+      # Render the checkbox field as HTML.
+      # 
+      def render_checkbox
+        return <<~HTML
+          <div class="#{field_group_styles} #{cols_tag}">
+            #{label_tag}
+            <label class="checkbox #{field_control_styles}">
+              <input type="checkbox" 
+                #{checked_tag} value="true"
+                name="#{name_value}" id="#{name_value}" />
+                #{description_value}
+            </label>
+          </div>
+        HTML
+      end
+
+      # 
+      # Render the select field as HTML.
+      # 
+      def render_select
+        return <<~HTML
+          <div class="#{field_group_styles} #{cols_tag}">
+            #{label_tag}
+            <select class="#{field_control_styles}" 
+              name="#{name_value}" id="#{name_value}">
+              #{select_options}
+            </select>
+          </div>
+        HTML
+      end
+
+    end
+  end
+end

data/lib/gloo/objs/web_svr/form.rb

@@ -0,0 +1,271 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2025 Eric Crane.  All rights reserved.
+#
+# An HTML Form.
+#
+# A Form is the definition of a form, with a collection of form fields
+#
+
+module Gloo
+  module Objs
+    class Form < Gloo::Core::Obj
+
+      KEYWORD = 'form'.freeze
+      KEYWORD_SHORT = 'form'.freeze
+
+      # Form
+      NAME = 'name'.freeze
+      ID = 'id'.freeze
+      METHOD = 'method'.freeze
+      METHOD_DEFAULT = 'post'.freeze
+      ACTION = 'action'.freeze
+      CANCEL_PATH = 'cancel_path'.freeze
+      CONTENT = 'content'.freeze
+      STYLES = 'styles'.freeze
+
+
+      #
+      # The name of the object type.
+      #
+      def self.typename
+        return KEYWORD
+      end
+
+      #
+      # The short name of the object type.
+      #
+      def self.short_typename
+        return KEYWORD_SHORT
+      end
+
+      # 
+      # Get the name for the form.
+      # 
+      def name_value
+        o = find_child NAME
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+      
+      # 
+      # Get the method for the form.
+      # 'post' is the default.
+      # 
+      def method_value
+        o = find_child METHOD
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o.value || METHOD_DEFAULT
+      end
+
+      # 
+      # Get the action for the form.
+      # This is the path to POST to, for example.
+      # 
+      def action_value
+        o = find_child ACTION
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      # 
+      # Get the cancel path for the form.
+      # 
+      def cancel_path_value
+        o = find_child CANCEL_PATH
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o ? o.value : nil
+      end
+
+      # 
+      # Get all the form content, the collection of form fields.
+      # 
+      def form_content
+        o = find_child CONTENT
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+        return o
+      end
+
+      # 
+      # Get the styles for the form.
+      # Retuns styles in the form of a hash:
+      # { 'field_group' => 'form-group mt-3', … }
+      # 
+      def styles
+        style_h = {} 
+        o = find_child STYLES
+        return style_h unless o
+        o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+
+        o.children.each do |c|
+          style_h[ c.name ] = c.value
+        end
+
+        # puts "styles: #{style_h}"
+        return style_h
+      end
+
+      # 
+      # Get the form styles.
+      # Use the name if none is provided.
+      # 
+      def form_styles
+        return @styles['form'] || name_value
+      end
+
+      # 
+      # Get the submit button styles.
+      # 
+      def submit_button_styles
+        return @styles['submit'] || ''
+      end
+
+      # 
+      # Get the cancel button styles.
+      # 
+      def cancel_button_styles
+        return @styles['cancel'] || ''
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Children
+      # ---------------------------------------------------------------------
+
+      #
+      # Does this object have children to add when an object
+      # is created in interactive mode?
+      # This does not apply during obj load, etc.
+      #
+      def add_children_on_create?
+        return true
+      end
+
+      #
+      # Add children to this object.
+      # This is used by containers to add children needed
+      # for default configurations.
+      #
+      def add_default_children
+        fac = @engine.factory
+
+        # Create attributes with ID and Classes
+        fac.create_string NAME, '', self
+        fac.create_string METHOD, 'post', self
+        fac.create_string ACTION, '', self
+        fac.create_string CANCEL_PATH, '', self
+
+        fac.create_can CONTENT, self
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Messages
+      # ---------------------------------------------------------------------
+
+      #
+      # Get a list of message names that this object receives.
+      #
+      def self.messages
+        return super + [ 'render' ]
+      end
+
+      #
+      # Render the form and all contained fields.
+      #
+      def msg_render
+        content = self.render
+        @engine.heap.it.set_to content 
+        return content
+      end
+
+
+      # ---------------------------------------------------------------------
+      #    Render
+      # ---------------------------------------------------------------------
+
+      # 
+      # Open the form.
+      # 
+      def open_form
+        name = name_value
+
+        cancel_button = ""
+        if cancel_path_value
+          cancel_button = <<~HTML
+            <a class="#{cancel_button_styles}"
+              href="#{cancel_path_value}"> 
+              Cancel</a>
+          HTML
+        end
+        return <<~HTML
+          <form class='#{form_styles}'
+                id='#{name}'
+                method='#{method_value}'
+                action='#{action_value}'
+                accept-charset='UTF-8'>
+            <div class="actions">
+              <input type="submit" 
+                name="commit" 
+                value="Save" 
+                class="#{submit_button_styles}" 
+                data-disable-with="Saving..." />
+
+            #{cancel_button}
+            </div>
+        HTML
+      end
+
+      # 
+      # Close the form.
+      # 
+      def close_form
+        return "</form>"
+      end
+
+      # 
+      # Render the Form as HTML.
+      # 
+      def render
+        @styles = styles
+        return open_form + render_content + close_form
+      end
+
+      # 
+      # Render the element content using the specified render function.
+      # This is a recursive function (through one of the other render functions).
+      # 
+      def render_content 
+        fields = ""
+        field_can = form_content
+        return "" if field_can.nil?
+
+        field_can.children.each do |o|
+          o = Gloo::Objs::Alias.resolve_alias( @engine, o )
+          if o.class == Field
+            fields << o.render( @styles )
+          elsif o.class == Element
+            fields << o.render_html
+          elsif o
+            data = render_thing o
+            ( fields << data ) if data 
+          end
+        end
+
+        return fields
+      end
+
+      # 
+      # Render a string or other object.
+      # 
+      def render_thing e
+        begin
+          return e.render( 'render_html' )
+        rescue => e
+          @engine.log_exception e
+          return ''
+        end
+      end
+  
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo
 version: !ruby/object:Gem::Version
-  version: 4.2.1
+  version: 4.4.0
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-15 00:00:00.000000000 Z
+date: 2025-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -294,20 +294,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.4
-- !ruby/object:Gem::Dependency
-  name: pg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.5.4
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.5.4
 - !ruby/object:Gem::Dependency
   name: thin
   requirement: !ruby/object:Gem::Requirement
@@ -496,6 +482,8 @@ files:
 - lib/gloo/objs/web/teams.rb
 - lib/gloo/objs/web/uri.rb
 - lib/gloo/objs/web_svr/element.rb
+- lib/gloo/objs/web_svr/field.rb
+- lib/gloo/objs/web_svr/form.rb
 - lib/gloo/objs/web_svr/page.rb
 - lib/gloo/objs/web_svr/partial.rb
 - lib/gloo/objs/web_svr/svr.rb