RubyGems - cyberweb - Versions diffs - 0.4.174 → 0.5.225 - Mend

cyberweb 0.4.174 → 0.5.225

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of cyberweb might be problematic. Click here for more details.

Files changed (625) hide show

data/lib/cyberweb/objectified/web_object/web_object.rb ADDED Viewed

@@ -0,0 +1,119 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::Objectified::HtmlTags::WebObject
+# =========================================================================== #
+# require 'cyberweb/objectified/web_object/web_object'
+# =========================================================================== #
+require 'cyberweb/base/base.rb'
+module Cyberweb
+# =========================================================================== #
+# Must add the code of all objectified tags next; this should perhaps be
+# changed to batch-require these files instead.
+# =========================================================================== #
+require 'cyberweb/objectified/html_tags/body.rb'
+require 'cyberweb/objectified/html_tags/head.rb'
+require 'cyberweb/objectified/html_tags/img.rb'
+module Objectified::HtmlTags
+class WebObject < ::Cyberweb::Base # === Cyberweb::Objectified::HtmlTags::WebObject
+  require 'cyberweb/base_module/base_module.rb'
+  include Cyberweb::BaseModule
+  require 'cyberweb/objectified/mask/mask.rb'
+  include Cyberweb::Objectified::Mask
+  # ========================================================================= #
+  # === initialize
+  #
+  # Usage example:
+  #
+  #   Cyberweb::Objectified::HtmlTags::WebObject.new(i)
+  #
+  # ========================================================================= #
+  def initialize(
+      use_this_text = '',
+      run_already   = true,
+      &block
+    )
+    reset
+    run if run_already
+  end
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @_
+    # ======================================================================= #
+    @_ = ''.dup
+    # ======================================================================= #
+    # === @internal_hash
+    # ======================================================================= #
+    @internal_hash = {}
+    # ======================================================================= #
+    # === :title
+    # ======================================================================= #
+    @internal_hash[:title] = 'Generic title'
+  end
+  # ========================================================================= #
+  # === set_title
+  # ========================================================================= #
+  def set_title(i)
+    @internal_hash[:title] = i.to_s.dup
+  end
+  # ========================================================================= #
+  # === to_str
+  # ========================================================================= #
+  def to_str
+    @_.to_s
+  end; alias to_s to_str # === to_s
+  # ========================================================================= #
+  # === internal_testing_the_functionality
+  #
+  # The following method showcases how this can be used.
+  # ========================================================================= #
+  def internal_testing_the_functionality
+    # ======================================================================= #
+    # @_ will be our return String that will be served.
+    # ======================================================================= #
+    @_ << doctype?
+    @_ << "<html>\n"
+    # head = ::Cyberweb::Objectified::HtmlTags::Head.new
+    head = oop_head
+    head.title(@internal_hash[:title])
+    head.use_utf
+    head.description 'Oki dokie'
+    head.add 'Yo there'
+    @_ << head.to_s
+    image1 = oop_image('/home/x/data/images/NJOY/Susanne_03.jpg')
+    image1.lazy_loading
+puts image1
+exit
+    body = Cyberweb::Objectified::HtmlTags::Body.new(image1)
+    @_ << body.to_s
+  end
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+  end
+end; end; end
+if __FILE__ == $PROGRAM_NAME
+  require 'colours/autoinclude'
+  _ = Cyberweb::Objectified::HtmlTags::WebObject.new
+  _.internal_testing_the_functionality
+  e _
+end

data/lib/cyberweb/predefined_and_freeform_methods/frage.rb CHANGED Viewed

@@ -31,13 +31,15 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
   end
   # ========================================================================= #
-  # === Frage
+  # === Cyberweb::PredefinedMethods::Frage
   # ========================================================================= #
   class Frage
     # ======================================================================= #
     # === Frage.to_s
     # ======================================================================= #
-    def self.to_s(i = ::Cyberweb::PredefinedMethods.frage_css?)
+    def self.to_s(
+        i = ::Cyberweb::PredefinedMethods.frage_css?
+      )
       i
     end
   end

data/lib/cyberweb/predefined_and_freeform_methods/freeform_methods.rb CHANGED Viewed

@@ -18,6 +18,8 @@
 # =========================================================================== #
 @web_object = Cyberweb::WebObject.new
+::Cyberweb.set_web_object(@web_object)
 # =========================================================================== #
 # === w                                                              (w tag)
 #
@@ -34,15 +36,16 @@
 # Note that html {} is an alias to this method.
 # =========================================================================== #
 def w(&block)
-  if @web_object.already_served?
+  _ = @web_object
+  if _.already_served?
     # pass through in this case.
   else
-    @web_object.addnl(Cyberweb.return_html_to_head_start)
-    @web_object.handle_these_calls(&block)
-    @web_object.close_html_after_making_sure_that_the_body_tag_exists
-    @web_object.serve_webpage
+    _.addnl(Cyberweb.return_html_to_head_start)
+    _.handle_these_calls(&block)
+    _.close_html_after_making_sure_that_the_body_tag_exists
+    _.serve_webpage
   end
-  return @web_object
+  return _
 end; alias html        w # === html
      alias web_object? w # === web_object?
@@ -65,14 +68,25 @@ def german(
     i = nil,
     &block
   )
-  @web_object.add_doctype_then_html_start_tag_then_head_tag_then_charset
-  @web_object.german_trinity
-  if i
-    @web_object.set_title(i)
-  end
-  @web_object.handle_these_calls(&block)
-  @web_object.close_html
-  @web_object.serve_webpage
+  # @web_object.set_title(i) if i
+  # @web_object.add_doctype_then_html_start_tag_then_head_tag_then_charset
+  # @web_object.german_trinity
+  # @web_object.handle_these_calls(&block)
+  # @web_object.close_html_then_serve_the_webpage
+  @web_object.set_title(i) if i
+  @web_object.addnl(DOCTYPE_HTML5)
+  @web_object.addnl(Cyberweb.return_html_start) # html lang.
+  @web_object.add_to_the_html_section Cyberweb.return_head_start
+  @web_object.add_to_the_html_section Cyberweb.return_utf_charset
+  # ========================================================================= #
+  # Next we must add the head string.
+  # ========================================================================= #
+  @web_object.addnl(@web_object.head_string?)
+  # ========================================================================= #
+  # Then we add the remaining meta-tags:
+  # ========================================================================= #
+  @web_object.add_the_meta_collection
+  @web_object.advanced_handle_these_calls_for_german(&block)
 end
 # =========================================================================== #
@@ -82,12 +96,9 @@ def english(
     i = nil,
     &block
   )
+  @web_object.set_title(i) if i
   @web_object.add_doctype_then_html_start_tag_then_head_tag_then_charset
   @web_object.english_trinity
-  if i
-    @web_object.set_title(i)
-  end
   @web_object.handle_these_calls(&block)
-  @web_object.close_html
-  @web_object.serve_webpage
+  @web_object.close_html_then_serve_the_webpage
 end

data/lib/cyberweb/predefined_and_freeform_methods/hash_registered_extra_tags.rb CHANGED Viewed

@@ -16,7 +16,13 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
   # This is used only for ruby and php so far.
   # ========================================================================= #
   @hash_registered_extra_tags = {}
+  # ========================================================================= #
+  # === :ruby
+  # ========================================================================= #
   @hash_registered_extra_tags[:ruby] = 'BO crimson FS1_2em'
+  # ========================================================================= #
+  # === :php
+  # ========================================================================= #
   @hash_registered_extra_tags[:php]  = 'BO blue'
   # ========================================================================= #

data/lib/cyberweb/predefined_and_freeform_methods/header.rb CHANGED Viewed

@@ -2,6 +2,8 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
+# === Cyberweb::PredefinedMethods::Header
+# =========================================================================== #
 # require 'cyberweb/predefined_and_freeform_methods/header.rb'
 # =========================================================================== #
 module Cyberweb

data/lib/cyberweb/predefined_and_freeform_methods/predefined_methods.rb CHANGED Viewed

@@ -15,7 +15,6 @@ module Cyberweb
 module PredefinedMethods # === Cyberweb::PredefinedMethods
   require 'cyberweb/predefined_and_freeform_methods/header.rb'
-  require 'cyberweb/predefined_and_freeform_methods/hash_css_class_to_use.rb'
   require 'cyberweb/predefined_and_freeform_methods/hash_registered_extra_tags.rb'
   require 'cyberweb/predefined_and_freeform_methods/frage.rb' # bl $RUBY_CYBERWEB/predefined/frage.rb
   require 'cyberweb/classes/simple_form.rb'
@@ -32,21 +31,12 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
   # ========================================================================= #
   ARRAY_FRAGEN = []
-  # ========================================================================= #
-  # === Cyberweb::PredefinedMethods.cmd=
-  #
-  # Modify the Hash that stores which css classes we shall use.
-  # ========================================================================= #
-  def self.cmd=(i)
-    hash_css_class_to_use?[:command1] = i
-  end
   # ========================================================================= #
   # === answer
   # ========================================================================= #
   def answer(this_question)
     e this_question,
-      ::Cyberweb::PredefinedMethods.css_class_to_use?[:answer]
+      ::Cyberweb.internal_hash?[:answer]
   end; alias antwort answer # === antwort
   # ========================================================================= #
@@ -61,17 +51,6 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
     h1 i, optional_css_class, optional_id, optional_css_style
   end
-  # ========================================================================= #
-  # === col_cmd
-  # ========================================================================= #
-  def col_cmd(
-      i = '', optional_id = ''
-    )
-    ee(
-      i, ::Cyberweb::PredefinedMethods.css_class_to_use?[:col_cmd], optional_id
-    )
-  end; alias col col_cmd # === col
   # ========================================================================= #
   # === frage                                                     (frage tag)
   #
@@ -97,28 +76,6 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
     h2(result, optional_css) # Or H[:question].
   end; alias question frage # === question
-  # ========================================================================= #
-  # === Cmd
-  # ========================================================================= #
-  class Cmd
-    # ======================================================================= #
-    # === Cmd.append
-    #
-    # This method can be used to append to the H[:command1] hash.
-    #
-    # The ' ' will be mandatory for now.
-    # ======================================================================= #
-    def self.append(i)
-      if ::Cyberweb::PredefinedMethods.css_class_to_use?[:command1].frozen?
-        ::Cyberweb::PredefinedMethods.css_class_to_use?[:command1] =
-          ::Cyberweb::PredefinedMethods.css_class_to_use?[:command1].dup
-      end
-      ::Cyberweb::PredefinedMethods.css_class_to_use?[:command1] << " #{i}"
-    end; self.instance_eval { alias append_this_css append } # === Cmd.append_this_css
-  end
   # ========================================================================= #
   # === Cmd2
   # ========================================================================= #
@@ -132,45 +89,21 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
     # The ' ' will be mandatory for now.
     # ======================================================================= #
     def self.append(i)
-      ::Cyberweb::PredefinedMethods.css_class_to_use?[:command2] << " #{i}"
+      ::Cyberweb.internal_hash?[:cmd2] << " #{i}"
     end; self.instance_eval { alias append_this_css append } # === Cmd2.append_this_css
   end
-  # ========================================================================= #
-  # === Cyberweb::PredefinedMethods.command2?
-  #
-  # Simpler query over the Hash dataset here. We will use this method
-  # to return the corresponding CSS-dataset.
-  # ========================================================================= #
-  def self.command2?
-    ::Cyberweb::PredefinedMethods.css_class_to_use?[:command2]
-  end
-  # ========================================================================= #
-  # === Cyberweb::PredefinedMethods.command3?
-  # ========================================================================= #
-  def self.command3?
-    ::Cyberweb::PredefinedMethods.css_class_to_use?[:command3]
-  end
-  # ========================================================================= #
-  # === command2?
-  # ========================================================================= #
-  def command2?
-    ::Cyberweb::PredefinedMethods.command2?
-  end
   # ========================================================================= #
   # === CMD2
   # ========================================================================= #
-  CMD2 = command2? # A reference to the above.
+  # CMD2 = command2? # A reference to the above.
   # ========================================================================= #
   # === command3?
   # ========================================================================= #
   def command3?
-    ::Cyberweb::PredefinedMethods.css_class_to_use?[:command3] # We delegate towards HASH_CSS_CLASS_TO_USE here.
+    ::Cyberweb.internal_hash?[:cmd3] # We delegate towards HASH_CSS_CLASS_TO_USE here.
   end
   # ========================================================================= #
@@ -179,7 +112,8 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
   # This method will require that the method command2? will work.
   # ========================================================================= #
   def cmd2(
-      i = '', optional_id = ''
+      i           = '',
+      optional_id = ''
     )
     padl2em(i, command2?, optional_id) # The second argument here is the id.
   end; alias rc2      cmd2 # === rc2
@@ -192,34 +126,6 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
     cmd(i, 'BOLD mars1em')
   end
-  # ========================================================================= #
-  # === cmd_pre
-  # ========================================================================= #
-  def cmd_pre(i)
-    splitted = i.split(N)
-    splitted.each {|entry| cmd(entry) }
-  end; alias pre_cmd cmd_pre # === pre_cmd
-  # ========================================================================= #
-  # === Cyberweb::PredefinedMethods.cmd?
-  #
-  # This method will "tap" into the predefined css_class, for the
-  # Symbol :command1. This is the one that will be used for CSS
-  # in the method cmd().
-  # ========================================================================= #
-  def self.cmd?
-    ::Cyberweb::PredefinedMethods.css_class_to_use?[:command1]
-  end
-  # ========================================================================= #
-  # === cmd?
-  #
-  # This method also has a constant as an "alias" to its value.
-  # ========================================================================= #
-  def cmd?
-    ::Cyberweb::PredefinedMethods.cmd?
-  end; CMD = cmd?
   # ========================================================================= #
   # === cmd                                                         (cmd tag)
   #
@@ -277,55 +183,6 @@ module PredefinedMethods # === Cyberweb::PredefinedMethods
 end # (end tag)
-  # ========================================================================= #
-  # === Cyberweb.append_to_cmd1
-  #
-  # This method can be used to append to "cmd1" aka :command1.
-  #
-  # Usage example:
-  #
-  #   Cyberweb.append_to_cmd1 :slateblue
-  #
-  # ========================================================================= #
-  def self.append_to_cmd1(i = 'marl2em')
-    old_content = ::Cyberweb::PredefinedMethods.css_class_to_use[:command1]
-    old_content = old_content.dup if old_content.frozen?
-    old_content << (" #{i.to_s.strip}").squeeze(' ')
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command1] = old_content
-  end
-  # ========================================================================= #
-  # === append_to_cmd1
-  #
-  # This method will append to cmd1.
-  # ========================================================================= #
-  def append_to_cmd1(
-      i = 'marl2em'
-    )
-    ::Cyberweb.append_to_cmd1(i)
-  end
-  # ========================================================================= #
-  # === empty_cmd1
-  # ========================================================================= #
-  def empty_cmd1
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command1] = ''
-  end
-  # ========================================================================= #
-  # === Cyberweb.cmd2=
-  #
-  # This allows us to ad-hoc redefine cmd2.
-  #
-  # For instance:
-  #
-  #   Cyberweb.cmd2 = CMD2
-  #
-  # ========================================================================= #
-  def self.cmd2=(i)
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command2] = i
-  end
   # ========================================================================= #
   # === return_form_object
   #
@@ -348,7 +205,9 @@ end # (end tag)
   #   css.optional
   #
   # ========================================================================= #
-  def css(optional_but_irrelevant_argument = '')
+  def css(
+      optional_but_irrelevant_argument = ''
+    )
     ::Cyberweb.css_object = ::Cyberweb::Css.new if ::Cyberweb.css_object.nil? # Create a new one in this case.
     ::Cyberweb.css_object
   end # alias c css # <--- We can not use this because "c" is already aliased onto "close".
@@ -360,35 +219,11 @@ end # (end tag)
     ::Cyberweb::PredefinedMethods.hash_registered_extra_tags?
   end
-  # ========================================================================= #
-  # === Cyberweb.style_cmd1
-  #
-  # This method can be used to globally re-"style" the CSS used for
-  # command.
-  # ========================================================================= #
-  def self.style_cmd1(i)
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command1] = i
-  end
   # ========================================================================= #
   # === Cyberweb.css_for_cmd?
   # ========================================================================= #
   def self.css_for_cmd?
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command1]
-  end
-  # ========================================================================= #
-  # === Cyberweb.css_for_cmd=
-  # ========================================================================= #
-  def self.css_for_cmd=(i)
-    ::Cyberweb::PredefinedMethods.css_class_to_use[:command1] = i
-  end
-  # ========================================================================= #
-  # === Cyberweb.cmd?
-  # ========================================================================= #
-  def self.cmd?
-    ::Cyberweb::PredefinedMethods.cmd?
+    ::Cyberweb.internal_hash?[:cmd1]
   end
   # ========================================================================= #

data/lib/cyberweb/project/project.rb CHANGED Viewed

@@ -33,6 +33,8 @@ module Cyberweb
   # ========================================================================= #
   # === ABSOLUTE_PROJECT_BASE_DIRECTORY
+  #
+  # Store the absolute path in a constant as well.
   # ========================================================================= #
   ABSOLUTE_PROJECT_BASE_DIRECTORY =
     File.absolute_path("#{__dir__}/..")+'/lib/cyberweb/'
@@ -63,18 +65,21 @@ module Cyberweb
   # The constant PROJECT_YAML_DIRECTORY tells us where we can find the
   # yaml/ directory for this project.
   #
-  # You can use a method called Cyberweb.project_yaml_directory? instead.
+  # You have to use the method called Cyberweb.project_yaml_directory?
+  # past October 2021.
   # ========================================================================= #
-  PROJECT_YAML_DIRECTORY = "#{PROJECT_BASE_DIRECTORY}yaml/"
   # ========================================================================= #
   # ==== Cyberweb.yaml_directory?
   #
   # This method will simply return the yaml directory of this project.
+  #
+  # It used to be a constant, but since as of October 2021 it no longer is.
   # ========================================================================= #
   def self.yaml_directory?
-    PROJECT_YAML_DIRECTORY
-  end; self.instance_eval { alias config_directory? yaml_directory? } # === Cyberweb.config_directory?
+    "#{PROJECT_BASE_DIRECTORY}yaml/"
+  end; self.instance_eval { alias config_directory?       yaml_directory? } # === Cyberweb.config_directory?
+       self.instance_eval { alias project_yaml_directory? yaml_directory? } # === Cyberweb.project_yaml_directory?
 end

data/lib/cyberweb/rack/request.rb CHANGED Viewed

@@ -14,18 +14,18 @@
 # =========================================================================== #
 module Cyberweb
-require 'rack'
+  require 'rack'
-# =========================================================================== #
-# === Cyberweb::Request
-# =========================================================================== #
-class Request < Rack::Request
-end
+  # ========================================================================= #
+  # === Cyberweb::Request
+  # ========================================================================= #
+  class Request < Rack::Request
+  end
-# =========================================================================== #
-# === Cyberweb::Response
-# =========================================================================== #
-class Response < Rack::Response
-end
+  # ========================================================================= #
+  # === Cyberweb::Response
+  # ========================================================================= #
+  class Response < Rack::Response
+  end
 end

data/lib/cyberweb/raw_images/404.png ADDED Viewed

Binary file

data/lib/cyberweb/raw_images/500.png ADDED Viewed

Binary file

data/lib/cyberweb/raw_images/README.md ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ This directory contains "raw" images, aka images that can be
2	+ displayed as-is.

data/lib/cyberweb/raw_images/a_dice.png ADDED Viewed

Binary file

data/lib/cyberweb/raw_images/food.png ADDED Viewed

Binary file

data/lib/cyberweb/raw_images/ground.png ADDED Viewed

Binary file

data/lib/cyberweb/requires/require_generators.rb CHANGED Viewed

@@ -6,7 +6,7 @@
 # =========================================================================== #
 module Cyberweb
-  require 'cyberweb/constants/project_constants.rb'
+  require 'cyberweb/constants/constants.rb'
   # ========================================================================= #
   # === Cyberweb.require_generators

data/lib/cyberweb/requires/require_html_tags_files.rb CHANGED Viewed

@@ -6,7 +6,7 @@
 # =========================================================================== #
 module Cyberweb
-  require 'cyberweb/constants/project_constants.rb'
+  require 'cyberweb/constants/constants.rb'
   # ========================================================================= #
   # === Cyberweb.require_html_tags_files

data/lib/cyberweb/requires/require_javascript_files.rb CHANGED Viewed

@@ -6,7 +6,7 @@
 # =========================================================================== #
 module Cyberweb
-  require 'cyberweb/constants/project_constants.rb'
+  require 'cyberweb/constants/constants.rb'
   # ========================================================================= #
   # === Cyberweb.require_javascript_files

data/lib/cyberweb/requires/require_objectified_html_tags_files.rb CHANGED Viewed

@@ -6,15 +6,41 @@
 # =========================================================================== #
 module Cyberweb
-  require 'cyberweb/constants/project_constants.rb'
+  require 'cyberweb/constants/constants.rb'
   # ========================================================================= #
   # === Cyberweb.require_objectified_html_tags_files
+  #
+  # This method allows for some ad-hoc flexibility. This is only needed
+  # for a few files, though, so you can safely use the default values
+  # without a problem.
   # ========================================================================= #
   def self.require_objectified_html_tags_files(
-      from_this_directory = OBJECTIFIED_HTML_TAGS_DIRECTORY
+      from_this_directory = :default,
+      exclude_these_files = :none_are_to_be_excluded
     )
-    Dir["#{from_this_directory}*rb"].each {|file|
+    case from_this_directory
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      from_this_directory = OBJECTIFIED_HTML_TAGS_DIRECTORY
+    end
+    work_on_these_files = Dir["#{from_this_directory}*rb"]
+    work_on_these_files.reject! {|file|
+      file.include? 'include_objectified_html_tags.rb'
+    }
+    case exclude_these_files
+    # ======================================================================= #
+    # === :exclude_mask_rb
+    # ======================================================================= #
+    when :exclude_mask_rb,
+         :exclude_mask_rb_file
+      work_on_these_files.reject! {|file|
+        file.include? 'mask.rb'
+      }
+    end
+    work_on_these_files.each {|file|
       _ = "#{from_this_directory}#{File.basename(file)}"
       require _
     }