cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/{objectified_html_tags → objectified/html_tags}/window.rb

@@ -2,24 +2,29 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === Cyberweb::ObjectifiedHtmlTags::Window
+# === Cyberweb::Objectified::HtmlTags::Window
+#
+# This class simply represents a <div> tag right now. It does, however
+# had, also have code elements such as horizontal_separator(), to
+# increase compatibility to GTK, which ultimately inspired its
+# creation.
 # =========================================================================== #
-# require 'cyberweb/objectified_html_tags/window.rb'
+# require 'cyberweb/objectified/html_tags/window.rb'
 # =========================================================================== #
-require 'cyberweb/objectified_html_tags/base.rb'
+require 'cyberweb/objectified/html_tags/base.rb'
 
 module Cyberweb
 
-module ObjectifiedHtmlTags
+module Objectified::HtmlTags
 
-class Window < Base # === Cyberweb::ObjectifiedHtmlTags::Window
+class Window < Base # === Cyberweb::Objectified::HtmlTags::Window
 
   # ========================================================================= #
   # === initialize
   #
   # Usage example:
   #
-  #   Cyberweb::ObjectifiedHtmlTags::Window.new(i)
+  #   Cyberweb::Objectified::HtmlTags::Window.new(i)
   #
   # ========================================================================= #
   def initialize(use_this_text = '')
@@ -47,12 +52,12 @@ class Window < Base # === Cyberweb::ObjectifiedHtmlTags::Window
   # ========================================================================= #
   def rebuild_the_result
     @result = '<div'.dup
-    unless @css_style.empty?
-      @result << return_css_style(@css_style)
+    unless css_style?.empty?
+      @result << return_css_style(css_style?)
     end
     @result << '>'+"\n"
     @result << @content.to_s
-    @result << '</div>'+"\n"  
+    @result << "\n</div>\n"  
   end
 
   # ========================================================================= #
@@ -75,5 +80,5 @@ end; end; end
 
 if __FILE__ == $PROGRAM_NAME
   alias e puts
-  e Cyberweb::ObjectifiedHtmlTags::Window.new('hey there')
+  e Cyberweb::Objectified::HtmlTags::Window.new('hey there')
 end

data/lib/cyberweb/objectified/mask/README.md

@@ -0,0 +1,8 @@
+This directory will include a helper-module that can be included by
+other classes if they want to make use of "oop_" related HTML tags.
+That helper-module is defined in the file mask.rb.
+
+An additional .rb file exists, called compatibility_to_html_tags.rb.
+That .rb file contains code that will alias methods such as "h2"
+onto "oop_h2". That way we could, in theory, transition completely
+into objectified-HTML tags powering a web-application in Cyberweb.

data/lib/cyberweb/objectified/mask/compatibility_to_html_tags.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::Objectified::Mask::CompatibilityToHtmlTags
+#
+# This small module exists solely for compatibility towards HTML tags.
+# =========================================================================== #
+# require 'cyberweb/objectified/mask/compatibility_to_html_tags.rb'
+# include Cyberweb::Objectified::Mask::CompatibilityToHtmlTags
+# =========================================================================== #
+module Cyberweb
+
+module Objectified
+
+module Mask
+
+module CompatibilityToHtmlTags # === Cyberweb::Objectified::Mask::CompatibilityToHtmlTags
+
+  require 'cyberweb/objectified/mask/mask.rb'
+  include ::Cyberweb::Objectified::Mask
+
+  require 'cyberweb/constants/constants.rb'
+
+  # ========================================================================= #
+  # Batch-alias all known HTML tags next:
+  # ========================================================================= #
+  REGISTERED_HTML_TAGS.each {|this_html_tag|
+    alias_method this_html_tag, "oop_#{this_html_tag}".to_sym
+  }
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  require 'cyberweb/requires/require_objectified_html_tags_files.rb'
+  Cyberweb.require_objectified_html_tags_files
+  include Cyberweb::Objectified::Mask::CompatibilityToHtmlTags
+  e h2 'OK','mars2em','some_id','color: green'
+end

data/lib/cyberweb/objectified/mask/mask.rb

@@ -0,0 +1,490 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::Objectified::Mask                                  (mask tag)
+#
+# This helper-module adds various "oop_" named helper methods that can
+# be used directly to describe a web-page in an OOP-centric manner.
+# =========================================================================== #
+# require 'cyberweb/objectified/mask/mask.rb'
+# include Cyberweb::Objectified::Mask
+# =========================================================================== #
+module Cyberweb
+
+module Objectified
+
+module Mask # === Cyberweb::Objectified::Mask
+
+  # ========================================================================= #
+  # === html_img
+  # ========================================================================= #
+  def html_img(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Img.new(i)
+  end; alias html_image html_img # === html_image
+       alias oop_image  html_img # === oop_image
+       alias oop_img    html_img # === oop_img
+
+  # ========================================================================= #
+  # === html_head
+  #
+  # This method will ultimately represent a HTML <head> tag.
+  # ========================================================================= #
+  def html_head(i = ARGV)
+    i = i.join(' ').strip if i.is_a? Array
+    return Cyberweb::Objectified::HtmlTags::Head.new(i)
+  end; alias oop_head html_head # === oop_head
+
+  # ========================================================================= #
+  # === html_h1
+  # ========================================================================= #
+  def html_h1(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H1.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h1 html_h1 # === oop_h1
+
+  # ========================================================================= #
+  # === html_h2
+  # ========================================================================= #
+  def html_h2(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H2.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h2 html_h2 # === oop_h2
+
+  # ========================================================================= #
+  # === html_h3
+  # ========================================================================= #
+  def html_h3(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H3.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h3 html_h3 # === oop_h3
+
+  # ========================================================================= #
+  # === html_h4
+  # ========================================================================= #
+  def html_h4(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H4.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h4 html_h4 # === oop_h4
+
+  # ========================================================================= #
+  # === html_h5
+  # ========================================================================= #
+  def html_h5(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H5.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h5 html_h5 # === oop_h5
+
+  # ========================================================================= #
+  # === html_h6
+  # ========================================================================= #
+  def html_h6(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil
+    )
+    return Cyberweb::Objectified::HtmlTags::H6.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end; alias oop_h6 html_h6 # === oop_h6
+
+  # ========================================================================= #
+  # === html_a                                                        (a tag)
+  # ========================================================================= #
+  def html_a(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::A.new(i)
+  end; alias oop_a html_a # === oop_a
+
+  # ========================================================================= #
+  # === html_ul
+  # ========================================================================= #
+  def html_ul(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Ul.new(i)
+  end; alias oop_ul html_ul # === oop_ul
+
+  # ========================================================================= #
+  # === html_abbr
+  # ========================================================================= #
+  def html_abbr(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Abbr.new(i)
+  end; alias oop_abbr html_abbr # === oop_abbr
+
+  # ========================================================================= #
+  # === html_blockquote
+  # ========================================================================= #
+  def html_blockquote(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Blockquote.new(i)
+  end; alias oop_blockquote html_blockquote # === oop_blockquote
+
+  # ========================================================================= #
+  # === html_form
+  # ========================================================================= #
+  def html_form(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Form.new(i)
+  end; alias oop_form html_form # === oop_form
+
+  # ========================================================================= #
+  # === html_p
+  # ========================================================================= #
+  def html_p(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::P.new(i)
+  end; alias oop_p html_p # === oop_p
+
+  # ========================================================================= #
+  # === html_body
+  # ========================================================================= #
+  def html_body(i = '')
+    return Cyberweb::Objectified::HtmlTags::Body.new(i)
+  end; alias oop_body html_body # === oop_body
+
+  # ========================================================================= #
+  # === html_cite
+  # ========================================================================= #
+  def html_cite(i = '')
+    return Cyberweb::Objectified::HtmlTags::Cite.new(i)
+  end; alias oop_cite html_cite # === oop_cite
+
+  # ========================================================================= #
+  # === html_meta
+  # ========================================================================= #
+  def html_meta(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Meta.new(i)
+  end; alias oop_meta html_meta # === oop_meta
+
+  # ========================================================================= #
+  # === html_span
+  # ========================================================================= #
+  def html_span(i = '')
+    return Cyberweb::Objectified::HtmlTags::Span.new(i)
+  end; alias oop_span html_span # === oop_span
+
+  # ========================================================================= #
+  # === html_figure
+  # ========================================================================= #
+  def html_figure(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Figure.new(i)
+  end; alias oop_figure html_figure # === oop_figure
+
+  # ========================================================================= #
+  # === html_embed
+  # ========================================================================= #
+  def html_embed(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Embed.new(i)
+  end; alias oop_embed html_embed # === oop_embed
+
+  # ========================================================================= #
+  # === html_table
+  # ========================================================================= #
+  def html_table(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Table.new(i)
+  end; alias oop_table html_table # === oop_table
+
+  # ========================================================================= #
+  # === html_pre
+  # ========================================================================= #
+  def html_pre(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Pre.new(i)
+  end; alias oop_pre html_pre # === oop_pre
+
+  # ========================================================================= #
+  # === html_title
+  # ========================================================================= #
+  def html_title(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Title.new(i)
+  end; alias oop_title html_title # === oop_title
+
+  # ========================================================================= #
+  # === html_canvas
+  # ========================================================================= #
+  def html_canvas(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Canvas.new(i)
+  end; alias oop_canvas html_canvas # === oop_canvas
+
+  # ========================================================================= #
+  # === html_button
+  # ========================================================================= #
+  def html_button(i = ARGV)
+    i = i.join(' ').strip if i.is_a? Array
+    if i and i.start_with?('_')
+      i = i.dup if i.frozen?
+      i[0,1] = ''
+    end
+    return Cyberweb::Objectified::HtmlTags::Button.new(i)
+  end; alias oop_button html_button # === oop_button
+
+  # ========================================================================= #
+  # === html_fieldset
+  # ========================================================================= #
+  def html_fieldset(i = '')
+    return Cyberweb::Objectified::HtmlTags::Fieldset.new(i)
+  end; alias oop_fieldset html_fieldset # === oop_fieldset
+
+  # ========================================================================= #
+  # === html_combobox
+  #
+  # You can pass an Array of options to the method.
+  # ========================================================================= #
+  def html_combobox(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Combobox.new(i)
+  end; alias html_dropbox html_combobox # === html_dropbox
+       alias oop_combobox html_combobox # === oop_combobox
+
+  # ========================================================================= #
+  # === html_object
+  # ========================================================================= #
+  def html_object(i = ARGV)
+    return Cyberweb::Objectified::HtmlTags::Object.new(i)
+  end; alias oop_object html_object # === oop_object
+
+  # ========================================================================= #
+  # === html_checkbox
+  # ========================================================================= #
+  def html_checkbox(i = ARGV)
+    _ = Cyberweb::Objectified::HtmlTags::Input.new(i)
+    _.is_a_checkbox # Enable that this is a checkbox.
+    return _
+  end # alias checkbox html_checkbox # === checkbox
+      # ^^^ this currently conflicts with old code. We may have to re-consider at a later time.
+
+  # ========================================================================= #
+  # === html_submit
+  # ========================================================================= #
+  def html_submit(i = ARGV)
+    _ = Cyberweb::Objectified::HtmlTags::Input.new(i)
+    _.is_a_submit_button
+    return _
+  end; alias html_submit_button html_submit # === html_submit_button
+       alias submit_button      html_submit # === submit_button
+       alias oop_submit         html_submit # === oop_submit
+
+  # ========================================================================= #
+  # === html_div
+  # ========================================================================= #
+  def html_div(
+      i                  = ARGV,
+      optional_css_class = nil,
+      optional_id        = nil,
+      optional_css_style = nil,
+      &block
+    )
+    return Cyberweb::Objectified::HtmlTags::Div.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style,
+      &block
+    )
+  end; alias oop_div html_div # === oop_div
+
+  # ========================================================================= #
+  # === html_input
+  #
+  # The alias "entry" is derived from GUI toolkits such as gtk calling
+  # the user-input element Gtk::Entry.
+  # ========================================================================= #
+  def html_input(i = ARGV)
+    _ = Cyberweb::Objectified::HtmlTags::Input.new(i)
+    return _
+  end; alias entry     html_input # === entry
+       alias oop_input html_input # === oop_input
+
+end; end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h1
+  # ========================================================================= #
+  def self.oop_h1(
+      i                  = ARGV,
+      optional_css_class = '',
+      optional_id        = '',
+      optional_css_style = ''
+    )
+    return ::Cyberweb::Objectified::HtmlTags::H1.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h2
+  # ========================================================================= #
+  def self.oop_h2(
+      i                  = ARGV,
+      optional_css_class = '',
+      optional_id        = '',
+      optional_css_style = ''
+    )
+    return Cyberweb::Objectified::HtmlTags::H2.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h3
+  # ========================================================================= #
+  def self.oop_h3(
+      i                  = ARGV,
+      optional_css_class = '',
+      optional_id        = '',
+      optional_css_style = ''
+    )
+    return Cyberweb::Objectified::HtmlTags::H3.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h4
+  # ========================================================================= #
+  def self.oop_h4(
+      i = ARGV,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+    return Cyberweb::Objectified::HtmlTags::H4.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h5
+  # ========================================================================= #
+  def self.oop_h5(
+      i = ARGV,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+    return Cyberweb::Objectified::HtmlTags::H5.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.oop_h6
+  # ========================================================================= #
+  def self.oop_h6(
+      i = ARGV,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+    return Cyberweb::Objectified::HtmlTags::H6.new(
+      i,
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # === html_textarea
+  # ========================================================================= #
+  def html_textarea(i = ARGV)
+    if i.is_a?(Array) and i.empty?
+      i = ''
+    end
+    return Cyberweb::Objectified::HtmlTags::Textarea.new(i)
+  end; alias oop_textarea html_textarea # === oop_textarea
+       alias text_field   html_textarea # === text_field
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  require 'cyberweb/requires/require_objectified_html_tags_files.rb'
+  Cyberweb.require_objectified_html_tags_files(
+    :default,
+    :exclude_mask_rb_file
+  )
+  x = Object.new
+  x.extend Cyberweb::Objectified::Mask
+  e x.oop_h1 'yo there'
+  e x.oop_h2 'yo there'
+  e x.oop_h2 'yo there','mars2em'
+  e x.oop_h2 'yo there','mars2em','some_id'
+  e x.oop_h2 'yo there','mars2em','some_id','color: black'
+  e x.oop_h3 'yo there'
+  e x.oop_h3 'yo there','mars2em'
+  e x.oop_h3 'yo there','mars2em','some_id'
+  e x.oop_h3 'yo there','mars2em','some_id','color: black'
+  e x.oop_h4 'yo there','mars2em','some_id','color: black'
+  e x.oop_h5 'yo there','mars2em','some_id','color: black'
+  e x.oop_h6 'yo there','mars2em','some_id','color: black'
+  e x.oop_a 'derstandard.at'
+  e 'Round 1, testing ... '
+  e x.oop_ul(
+    [
+      'Schinken',
+      'und ganz viel Käse, also Käse Käse Käse Käse Käse Käse 
+       Käse Käse Käse Käse Käse Käse Käse Käse Käse Käse Käse Käse Käse 
+       Käse Käse und nochmals Käse',
+       'Pilze'
+    ]
+  )
+  e x.oop_body 'oki dokie!'
+end

data/lib/cyberweb/objectified/web_object/README.md

@@ -0,0 +1,4 @@
+This is highly experimental as of November 2021.
+
+The idea is to simulate Cyberweb::WebObject, but to
+do so from an OOP point of view.