open 0.1.3

data/lib/open/constants/constants.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'open/constants/constants.rb'
+# =========================================================================== #
+module Open
+
+  require 'yaml'
+  require 'open/project/project.rb'
+
+  # ========================================================================= #
+  # === IN_BACKGROUND
+  # ========================================================================= #
+  IN_BACKGROUND = ' &'
+
+  # ========================================================================= #
+  # === HOME_DIRECTORY_OF_USER_X
+  #
+  # This constant is only useful on my home system.
+  # ========================================================================= #
+  HOME_DIRECTORY_OF_USER_X = '/home/x/'
+
+  # ========================================================================= #
+  # === RUBY_SRC
+  # ========================================================================= #
+  RUBY_SRC = "#{HOME_DIRECTORY_OF_USER_X}programming/ruby/src/"
+
+  # ========================================================================= #
+  # === PROGRAMMING_LANGUAGES_DIRECTORY_AT_HOME
+  # ========================================================================= #
+  PROGRAMMING_LANGUAGES_DIRECTORY_AT_HOME =
+    "#{HOME_DIRECTORY_OF_USER_X}programming/"
+
+  # ========================================================================= #
+  # === USERFIND
+  # ========================================================================= #
+  USERFIND = "find #{HOME_DIRECTORY_OF_USER_X}data -name"
+
+  # ========================================================================= #
+  # === MY_DATA
+  #
+  # This is functionality equivalent to the String '/home/x/data/'.
+  # ========================================================================= #
+  MY_DATA = "#{HOME_DIRECTORY_OF_USER_X}data/"
+    DATA_DIRECTORY_AT_HOME = MY_DATA # === DATA_DIRECTORY_AT_HOME
+
+  # ========================================================================= #
+  # === N_DELAY
+  #
+  # This delay is specifically used for delaying before batch-opening
+  # files via the Open.in_editor() functionality.
+  # ========================================================================= #
+  N_DELAY = 0.48
+
+  # ========================================================================= #
+  # === LOCATION_OF_BROWSER_YAML_FILE
+  #
+  # Here we must define where we store the location for our browser.
+  #
+  # That file will tell us which browser to use.
+  #
+  #   cat $USERS_X/data/PC/yaml/browser.yml
+  #
+  # Most users will not have this file, so the code will have to remain
+  # flexible in this regard.
+  # ========================================================================= #
+  LOCATION_OF_BROWSER_YAML_FILE =
+    "#{project_yaml_directory?}use_this_browser.yml"
+
+  # ========================================================================= #
+  # === LOCATION_OF_EDITOR_YAML_FILE
+  # ========================================================================= #
+  LOCATION_OF_EDITOR_YAML_FILE =
+    "#{project_yaml_directory?}use_this_editor.yml"
+
+  # ========================================================================= #
+  # === USE_THIS_EDITOR
+  #
+  # This variant is hardcoded, but there are class-methods that can be used
+  # to overrule the setting. 
+  # ========================================================================= #
+  if File.exist?(LOCATION_OF_EDITOR_YAML_FILE)
+    USE_THIS_EDITOR = YAML.load_file(LOCATION_OF_EDITOR_YAML_FILE)
+  else # else use a hardcoded default
+    USE_THIS_EDITOR = 'bluefish' # geany
+  end
+
+  # ========================================================================= #
+  # === USE_THIS_BROWSER 
+  # ========================================================================= #
+  if File.exist?(LOCATION_OF_BROWSER_YAML_FILE)
+    USE_THIS_BROWSER = YAML.load_file(LOCATION_OF_BROWSER_YAML_FILE)
+  else # else use a hardcoded default
+    USE_THIS_BROWSER = 'firefox' # palemoon or chrome may be options too
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts Open::MY_DATA
+  puts Open::LOCATION_OF_BROWSER_YAML_FILE
+  puts Open::USE_THIS_EDITOR
+  puts Open::USE_THIS_BROWSER
+end

data/lib/open/in_browser/in_browser.rb

@@ -0,0 +1,390 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Open::InBrowser
+#
+# This class can be used to open something in the browser.
+#
+# The correct browser to use is, by default, the one that is stored in
+# the yaml file called 'use_this_browser.yml'. This can, evidently,
+# only work if this file exists and can be found.
+#
+# If it is a local file then the absolute path will be used, determined
+# via File.absolute_path().
+#
+# Usage example for this class:
+#
+#   require 'open'
+#   Open::InBrowser.new(ARGV)
+#
+# =========================================================================== #
+# To open a remote webpage in firefox only, do:
+#
+#   use_this_browser = 'firefox -new-tab'
+#    _ = use_this_browser
+#    _ << ' "'+url.to_s+'"'
+#
+# =========================================================================== #
+# require 'open/in_browser/in_browser.rb'
+# =========================================================================== #
+require 'open/base/base.rb'
+
+module Open
+
+class InBrowser < Base # === Open::InBrowser
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument becomes the target URL that will be opened.
+  # ========================================================================= #
+  def initialize(
+      target_url  = '',
+      run_already = true
+    )
+    register_sigint
+    reset
+    set_target_url(
+      target_url
+    )
+    # ======================================================================= #
+    # === Handle blocks given next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :open_in_background
+      # ===================================================================== #
+      when :open_in_background
+        @open_in_background = true
+      # ===================================================================== #
+      # === be_silent
+      # ===================================================================== #
+      when :be_silent,
+           :be_quiet
+        @show_the_sys_command_that_is_used = false
+      else
+        # =================================================================== #
+        # Handle Hashes next:
+        # =================================================================== #
+        if yielded.is_a? Hash
+          # ================================================================= #
+          # === :use_this_browser
+          #
+          # Usage example for this clause:
+          #
+          #   Open.in_browser(remote_URL) {{ use_this_browser: :firefox }}
+          #
+          # ================================================================= #
+          if yielded.has_key? :use_this_browser
+            set_use_this_browser(yielded[:use_this_browser])
+          end
+        end
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @append_this_string
+    # ======================================================================= #
+    @append_this_string = ''.dup
+    # ======================================================================= #
+    # === @show_the_sys_command_that_is_used
+    # ======================================================================= #
+    @show_the_sys_command_that_is_used = true
+    # ======================================================================= #
+    # === @use_this_browser
+    # ======================================================================= #
+    @use_this_browser = ::Open.use_which_browser?
+    # ======================================================================= #
+    # === @open_in_background
+    # ======================================================================= #
+    @open_in_background = false
+  end
+
+  # ========================================================================= #
+  # === check_for_intralink
+  #
+  # The second optional argument specifies the token to use for replacing
+  # empty spaces, if we have passed an Array as argument.
+  # ========================================================================= #
+  def check_for_intralink(
+      i                                      = nil,
+      use_this_token_to_replace_empty_spaces = '_'
+    )
+    if i
+      if i.is_a? Array
+        i = i.join(' ').tr(' ', use_this_token_to_replace_empty_spaces)
+      end
+      i = i.to_s # Ensure that we have a String at this point.
+      unless i.empty?
+        @append_this_string << i
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === set_target_url
+  #
+  # We prefer this to be an Array.
+  # ========================================================================= #
+  def set_target_url(i = '')
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :with_localhost
+      #
+      # Example for this entry point:
+      #
+      #   Open::InBrowser.new(with_localhost: PORT_TO_USE)
+      #
+      # ===================================================================== #
+      if i.has_key? :with_localhost
+        i = "http://localhost:#{i.delete(:with_localhost)}/"
+      # ===================================================================== #
+      # === :port
+      #
+      # Example for this entry point:
+      #
+      #   Open::InBrowser[port: 8080]
+      #
+      # ===================================================================== #
+      elsif i.has_key? :port
+        i = "http://localhost:#{i.delete(:port)}/"
+      end
+    end
+    i = [i] unless i.is_a? Array
+    i.flatten! if i.is_a? Array
+    i.map! {|entry|
+      case entry
+      when :default_sinatra_port
+        entry = 'http://localhost:4567/'
+      end
+      entry = beautiful_url(entry).dup
+      if File.exist?(entry)
+        entry = File.absolute_path(entry)
+      end
+      if entry.start_with?('/home/x/') and !entry.include?('images/')
+        entry.sub!(/\/home\/x\//,'http://localhost/')
+      end
+      # ===================================================================== #
+      # Perform some sanitize-operations next.
+      # ===================================================================== #
+      if entry and
+        ((entry.include?("'") and !entry.include?('"')) or
+          entry.include?(' ')
+        )
+        entry = '"'+entry+'"'
+      elsif entry.include?(';') or entry.include?('(')
+        entry = '"'+entry+'"'
+      end
+      entry
+    }
+    @target_url = i
+  end
+
+  # ========================================================================= #
+  # === set_use_this_browser
+  # ========================================================================= #
+  def set_use_this_browser(
+      i = ::Open.use_which_browser?
+    )
+    @use_this_browser = i.to_s
+  end
+
+  # ========================================================================= #
+  # === open_in_browser
+  #
+  # This is the part that does the actual file-opening via the browser.
+  # ========================================================================= #
+  def open_in_browser(
+      optional_append_this_string = @append_this_string
+    )
+    _ = LOCATION_OF_BROWSER_YAML_FILE
+    browser = @use_this_browser # Use the generic browser by default.
+    # ======================================================================= #
+    # We must check first whether the file exists or not.
+    # ======================================================================= #
+    if File.exist? _
+      browser = YAML.load_file(_).strip.dup # This variable holds which browser to use.
+      if is_on_windows?
+        case browser
+        when 'palemoon'
+          browser.prepend(
+            "C:\\Program Files\\Pale Moon\\palemoon.exe"
+          )
+        end
+      end
+      # ===================================================================== #
+      # Different browsers have different ways to open a new tab.
+      # ===================================================================== #
+      if browser.include? 'opera' # Perform some sanitizing in this case.
+        browser << ' -newtab'
+        # =================================================================== #
+        # Or alternatively:
+        #
+        #   opera --remote 'openURL(<url>, new-page)'
+        #
+        # =================================================================== #
+      elsif browser.include? 'firefox'
+        browser << ' -new-tab'
+      end
+      @target_url.each {|entry|
+        entry = entry.to_s.dup # .dup to avoid that it may be frozen.
+        if optional_append_this_string.size > 0
+          # ================================================================= #
+          # We prepend the '#' character, unless it starts with the
+          # '?' character.
+          # ================================================================= #
+          unless optional_append_this_string.start_with? '?'
+            optional_append_this_string.prepend '#'
+          end
+          entry << optional_append_this_string
+        end
+        # =================================================================== #
+        # Next, specifically handle the situation on my home system, when
+        # we are in a directory that includes a substring such as
+        # '/home/x/data/' and if the target file name ends with '.cgi'.
+        # =================================================================== #
+        if is_on_roebe? and
+           entry.end_with?('.cgi') and
+          !entry.start_with?('http') and
+          !entry.start_with?('http://localhost/')
+          if return_pwd.include?(DATA_DIRECTORY_AT_HOME)
+            # ================================================================= #
+            # We need a target URL such as:
+            #   http://localhost/DATA/games/AITD/AITD.cgi
+            # in this case.
+            # ================================================================= #
+            unless entry.include? DATA_DIRECTORY_AT_HOME
+              entry.prepend(return_pwd)
+            end
+            entry.squeeze!('/')
+            quoted_regexp = Regexp.quote(DATA_DIRECTORY_AT_HOME)
+            entry.sub!(quoted_regexp, 'http://localhost/data/')
+          elsif return_pwd.include?(PROGRAMMING_LANGUAGES_DIRECTORY_AT_HOME)
+            unless entry.include? PROGRAMMING_LANGUAGES_DIRECTORY_AT_HOME
+              entry.prepend(return_pwd)
+            end
+            entry.squeeze!('/')
+            quoted_regexp = Regexp.quote(PROGRAMMING_LANGUAGES_DIRECTORY_AT_HOME)
+            entry.sub!(quoted_regexp, 'http://localhost/programming/')
+          end
+        end
+
+        if @open_in_background
+          entry << '&'
+        end
+        if entry.include? '&'
+          entry = '"'+entry+'"' unless entry.start_with? '"'
+        end
+        this_command = "#{browser} #{entry}"
+        if @show_the_sys_command_that_is_used
+          e this_command
+        end
+        unless entry.empty?
+          # Finally run the system-command.
+          system(this_command) # Here we always output.
+        end
+      } unless @target_url.nil?
+    else
+      browser = 'firefox' # Else, default to this here as a generic fallback.
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run 
+    open_in_browser
+  end
+
+  # ========================================================================= #
+  # === Open::InBrowser[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end; self.instance_eval { alias open_in_browser [] } # === Open::InBrowser.open_in_browser
+
+end
+
+  # ========================================================================= #
+  # === Open.open_in_browser
+  #
+  # Note that this method needs to be somewhat flexible, as we can provide
+  # varied input such as:
+  #
+  #   Open.open_in_browser(port: 8080)
+  #   Open.in_browser(remote_URL) {{ use_this_browser: :firefox }}
+  #
+  # ========================================================================= #
+  def self.open_in_browser(
+      i = ARGV, &block
+    )
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Hashes next
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === Handle Hashes past this point
+        # =================================================================== #
+        # =================================================================== #
+        # === :delay
+        # =================================================================== #
+        if yielded.has_key? :delay
+          _ = yielded.delete(:delay)
+          if _.is_a? String
+            _ = _.sub(/ seconds/,'')
+            _ = _.sub(/ second/,'').to_f if _.include? ' second'
+            _ = _.to_f # Need a Float.
+          end
+          sleep(_)
+        end
+      end
+    # else
+    end
+    ::Open::InBrowser.new(i, &block)
+  end; self.instance_eval { alias in_browser open_in_browser } # === Open.in_browser
+       self.instance_eval { alias open       open_in_browser } # === Open.open
+
+end
+
+# =========================================================================== #
+# === open_in_browser
+#
+# This method will open an URL in firefox.
+#
+# Usage example in pure Ruby:
+#
+#   require 'open'; open_in_browser 'google.at'
+#
+# =========================================================================== #
+def open_in_browser(
+    url                = ARGV,
+    optional_intralink = nil,
+    &block
+  )
+  # ========================================================================= #
+  # Next, open the class that we defined above in this file here.
+  # ========================================================================= #
+  _ = Open::InBrowser.new(url, false, &block)
+  _.check_for_intralink(optional_intralink)
+  _.run
+end; alias oib open_in_browser # oib shortcut.
+
+if __FILE__ == $PROGRAM_NAME
+  open_in_browser(ARGV.first)
+end # inbrowser
+    # inbrowser https://distrowatch.com/dwres.php?resource=ratings&distro=antix