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

cyberweb 0.4.174 → 0.5.225

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 _
     }