beautiful_url 1.5.5

data/lib/beautiful_url/class/reset.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/class/reset.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+class BeautifulUrl # === BeautifulUrl::BeautifulUrl
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    set_intralink
+    set_data_dir(:default)
+    # ======================================================================= #
+    # === @commandline_arguments
+    # ======================================================================= #
+    @commandline_arguments = []
+    # ======================================================================= #
+    # === @is_registered
+    #
+    # By default the given input is NOT registered. A method can change
+    # this value at a later time. (In the past this variable was called
+    # @url_was_found, but during the rewrite in early 2020 it was
+    # renamed).
+    # ======================================================================= #
+    @is_registered = false # Will become true if the URL was found.
+    # ======================================================================= #
+    # === @replace_localhost_with_data
+    #
+    # This variable must be false by default. If true then we will replace
+    # the localhost string with the DATA/ string.
+    # ======================================================================= #
+    @replace_localhost_with_data = false
+    # ======================================================================= #
+    # === @replace_data_with_localhost
+    # ======================================================================= #
+    @replace_data_with_localhost = false
+    # ======================================================================= #
+    # === @ignore_help
+    #
+    # This variable can be used to specifically NOT make use of --help,
+    # that is to ignore this case even if the user specified it.
+    # ======================================================================= #
+    @ignore_help = false
+  end
+
+end; end

data/lib/beautiful_url/class/run.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/class/run.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+class BeautifulUrl # === BeautifulUrl::BeautifulUrl
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    menu
+    map_the_input_arguments_to_their_corresponding_values
+    handle_additional_actions_after_the_input_arguments_were_already_mapped
+  end
+
+end; end

data/lib/beautiful_url/constants/base_constants.rb

@@ -0,0 +1,230 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/constants/base_constants.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === Constants tag. 
+  #
+  # Use these constants to define the base layout of the host system.
+  #
+  # This evidently defaults to my use case, but I will try to adapt the
+  # project to be more flexible for other users as well, in the long
+  # run.
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === BASE_DIR
+  # ========================================================================= #
+  BASE_DIR = '/home/x/'
+    HOME_X = BASE_DIR # === HOME_X
+
+  # ========================================================================= #
+  # === DATA_DIR
+  #
+  # Note that the very useful convention for the constants here is to
+  # KEEP a trailing /.
+  #
+  # On my home system this will default to '/home/x/DATA/'.
+  # ========================================================================= #
+  DATA_DIR = "#{BASE_DIR}data/" # Can't use ENV here as ENV is not
+                                # always available.
+  # ========================================================================= #
+  # === MY_DATA
+  # ========================================================================= #
+  MY_DATA = DATA_DIR 
+
+  # ========================================================================= #
+  # === DATA_RUBY_SRC
+  # ========================================================================= #
+  DATA_RUBY_SRC = "#{BASE_DIR}programming/ruby/src/"
+
+  # ========================================================================= #
+  # === IMG TAG
+  # ========================================================================= #  
+  IMG = "#{DATA_DIR}images/"
+
+  # ========================================================================= #
+  # === PROGL
+  # ========================================================================= #
+  PROGL                 = "#{BASE_DIR}programming/"
+    # ======================================================================= #
+    # === PROGRAMMING_LANGUAGES
+    # ======================================================================= #
+    PROGRAMMING_LANGUAGES = PROGL # Alias to the ^^^ above.
+
+  # ========================================================================= #
+  # === RUBY
+  # ========================================================================= #
+  RUBY                  = "#{PROGL}RUBY/"
+
+  # ========================================================================= #
+  # === RUBY_SRC
+  # ========================================================================= #
+  RUBY_SRC              = "#{RUBY}src/"
+    RSRC                = RUBY_SRC
+
+  # ========================================================================= #
+  # The following constants are all relative to LOCAL_HOST
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === LHOST
+  # ========================================================================= #
+  LHOST                 = 'http://localhost/DATA/' # This is the LOCAL_HOST constant.
+    # ======================================================================= #
+    # === DATA
+    # ======================================================================= #
+    DATA = LHOST # An "alias" to the above ^^^.
+
+  # ========================================================================= #
+  # === SRC
+  # ========================================================================= #
+  SRC                   = "#{BASE_DIR}src"
+
+  # ========================================================================= #
+  # === PC
+  # ========================================================================= #
+  PC                    = "#{LHOST}PC/"
+
+  # ========================================================================= #
+  # === HARDWARE
+  # ========================================================================= #
+  HARDWARE              = "#{PC}hardware/"
+
+  # ========================================================================= #
+  # === PC_YAML
+  # ========================================================================= #
+  PC_YAML               = "#{PC}yaml/"
+
+  # ========================================================================= #
+  # === OS
+  # ========================================================================= #
+  OS                    = "#{PC}OS/"
+
+  # ========================================================================= #
+  # === MISC
+  # ========================================================================= #
+  MISC                  = "#{LHOST}misc/"
+
+  # ========================================================================= #
+  # === CSS
+  # ========================================================================= #
+  CSS                   = "#{LHOST}CSS/"
+
+  # ========================================================================= #
+  # === RPG
+  # ========================================================================= #
+  RPG                   = "#{LHOST}rpg/"
+
+  # ========================================================================= #
+  # === MUDS
+  # ========================================================================= #
+  MUDS                  = "#{RPG}MUDS/"
+    MUD                 = MUDS # === MUD
+
+  # ========================================================================= #
+  # === STUDIUM
+  # ========================================================================= #
+  STUDIUM               = "#{BASE_DIR}/studium/"
+
+  # ========================================================================= #
+  # === SCI
+  # ========================================================================= #
+  SCI                   = "#{LHOST}science/"
+  SCIENCE               = SCI   # Alias to the ^^^ above.
+
+  # ========================================================================= #
+  # === GAMES
+  # ========================================================================= #
+  GAMES                 = "#{LHOST}games/"
+
+  # ========================================================================= #
+  # === AUDIO
+  # ========================================================================= #
+  AUDIO                 = "#{LHOST}AUDIO/"
+
+  # ========================================================================= #
+  # === AUDIO_YAML
+  # ========================================================================= #
+  AUDIO_YAML            = "#{AUDIO}yaml/"
+
+  # ========================================================================= #
+  # === VIDEO
+  # ========================================================================= #
+  VIDEO                 = "#{LHOST}video/"
+
+  # ========================================================================= #
+  # === LINUX
+  # ========================================================================= #
+  LINUX                 = "#{PC}OS/LINUX/"
+
+  # ========================================================================= #
+  # === LINUX_YAML
+  # ========================================================================= #
+  LINUX_YAML            = "#{LINUX}yaml/"
+  
+  # ========================================================================= #
+  # === BIOINFORMATIC
+  # ========================================================================= #
+  BIOINFORMATIC         = "#{SCI}BIOINFORMATIK/"
+
+  # ========================================================================= #
+  # === BIOLANG_DIR
+  # ========================================================================= #
+  BIOLANG_DIR           = "#{SCI}BIOLOGY/"
+
+  # ========================================================================= #
+  # === RUBY_DOCUMENTATION
+  # ========================================================================= #
+  RUBY_DOCUMENTATION    = RUBY+'documentation/'
+  COOKBOOK_DIR          = PC+'COOKBOOKS/YAML/' # ALL_COOKBOOKS
+  DATABASES             = PC+'DATABASES/'
+  IRC                   = PC+'IRC/'
+  PHP                   = PROGL+'php/'
+  PERL                  = PROGL+'perl/'
+  
+  RUBY_SYS              = RUBY_SRC+'SYS/'
+  RUBY_WWW              = RUBY_SRC+'WWW/'
+  RUBY_TOOLS            = RUBY_SRC+'tools/'
+
+  # ========================================================================= #
+  # === RUBY_RBT
+  # ========================================================================= #
+  RUBY_RBT              = RUBY_SRC+'rbt/lib/rbt/'
+    RUBY_BT               = RUBY_RBT
+
+  # ========================================================================= #
+  # === RUBY_DIA
+  # ========================================================================= #
+  RUBY_DIA              = RUBY_SRC+'roebe/lib/roebe/shell/'
+
+  # ========================================================================= #
+  # === BEAUTIFUL_URL
+  # ========================================================================= #
+  BEAUTIFUL_URL         = RUBY_TOOLS+'beautiful_url/lib/beautiful_url/'
+  MASTER_PIPE           = "#{RUBY_SRC}pipe_handler/lib/pipe_handler/"
+
+  # ========================================================================= #
+  # === RUBY_CYBERWEB
+  # ========================================================================= #
+  RUBY_CYBERWEB         = "#{RUBY_SRC}cyberweb/lib/cyberweb/"
+    # ======================================================================= #
+    # === CYBERWEB
+    # ======================================================================= #
+    CYBERWEB              = RUBY_CYBERWEB
+
+  # ========================================================================= #
+  # === IMG_RPG
+  # ========================================================================= #
+  IMG_RPG = "#{IMG}RPG/"
+
+  # ========================================================================= #
+  # === TODO_DIRECTORY
+  # ========================================================================= #
+  TODO_DIRECTORY = "#{MY_DATA}personal/todo/"
+
+end

data/lib/beautiful_url/constants/constants.rb

@@ -0,0 +1,9 @@
+# =========================================================================== #
+# require 'beautiful_url/constants/constants.rb'
+# =========================================================================== #
+require 'beautiful_url/constants/base_constants.rb'
+require 'beautiful_url/constants/encoding.rb'
+require 'beautiful_url/constants/misc.rb'
+require 'beautiful_url/constants/newline.rb'
+require 'beautiful_url/constants/tasks.rb'
+require 'beautiful_url/constants/time.rb'

data/lib/beautiful_url/constants/encoding.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file here ensures a consistent, uniform encoding to be used
+# for the whole BeautifulUrl namespace.
+# =========================================================================== #
+# require 'beautiful_url/constants/encoding.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === ENCODING_UNICODE
+  # ========================================================================= #
+  ENCODING_UNICODE = 'UTF-8'
+
+  # ========================================================================= #
+  # === ENCODING_ISO
+  # ========================================================================= #
+  ENCODING_ISO     = 'ISO-8859-1'
+
+  # ========================================================================= #
+  # === USE_THIS_ENCODING
+  #
+  # This constant specifies the main encoding to be used in the
+  # BeautifulUrl namespace.
+  # ========================================================================= #
+  USE_THIS_ENCODING = ENCODING_UNICODE
+
+  # ========================================================================= #
+  # === BeautifulUrl.ensure_main_encoding
+  #
+  # his method can be used to ensure that the same base-encoding is
+  # used, for a given String.
+  # ========================================================================= #
+  def self.ensure_main_encoding(
+      i, use_this_encoding = USE_THIS_ENCODING
+    )
+    if i.is_a? String
+      unless i.encoding.to_s.include? use_this_encoding
+        i = i.force_encoding(use_this_encoding)
+      end
+    end
+    i # Return it here anyway.
+  end
+
+end

data/lib/beautiful_url/constants/misc.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/constants/misc.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === HTTP_LOCALHOST_STRING
+  # ========================================================================= #
+  HTTP_LOCALHOST_STRING = 'http://localhost/'
+
+end

data/lib/beautiful_url/constants/newline.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/constants/newline.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+end

data/lib/beautiful_url/constants/tasks.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/constants/tasks.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === BeautifulUrl::YAML_FILE_TASKS
+  #
+  # We will try to load the file called "tasks.yml" but this file may
+  # be missing for various reasons - hence a File.exist? check must
+  # be done.
+  # ========================================================================= #
+  tasks = '/home/x/DATA/todo/yaml/tasks.yml' # cat $MY_DATA/todo/yaml/tasks.yml
+  if File.exist? tasks
+    require 'yaml'
+    begin
+      YAML_FILE_TASKS = YAML.load_file(tasks)
+      YFT = YAML_FILE_TASKS # alias to the above ^^^
+    rescue LoadError # Silent Rescue.
+      # puts 'The file does not exist.'
+    rescue Psych::SyntaxError => error
+      puts 'An error happened (via psych). Showing this error next:'
+      pp error
+    end
+  end
+
+end

data/lib/beautiful_url/constants/time.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'beautiful_url/constants/time.rb'
+# =========================================================================== #
+module BeautifulUrl
+
+  # ========================================================================= #
+  # === CURRENT_YEAR
+  # ========================================================================= #
+  CURRENT_YEAR = Time.now.year.to_s
+
+  # ========================================================================= #
+  # === BeautifulUrl.current_year?
+  # ========================================================================= #
+  def self.current_year?
+    CURRENT_YEAR
+  end
+
+end