dictionaries 0.2.177

data/lib/dictionaries/gui/tk/README.md

@@ -0,0 +1,2 @@
+This directory includes experimental tk code. The main GUI is
+ruby-gtk, so this is just a fallback.

data/lib/dictionaries/gui/tk/dictionary.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::GUI::Tk::Dictionary
+#
+# This is a small TK-wrapper.
+# =========================================================================== #
+# require 'dictionaries/gui/tk/dictionary.rb'
+# =========================================================================== #
+begin
+  require 'tk'
+rescue LoadError; end
+require 'dictionaries/class/ask_word_from_dictionary.rb'
+require 'dictionaries/toplevel_methods/e.rb'
+
+module Dictionaries
+
+module GUI
+
+module Tk
+
+class Dictionary < ::TkFrame # < Base === Dictionaries::GUI::Tk::Dictionary.new
+
+  include Colours::E
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    super()
+    reset
+    set_input(i)
+    title "TK wrapper for the Dictionaries project"
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    TkLabel.new(root) do
+     text 'Hello, World!'
+     pack { padx 15 ; pady 15; side 'left' }
+    end
+  end
+ 
+  # ========================================================================= #
+  # === Dictionaries::GUI:Tk::Dictionary[]
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Dictionaries::GUI:Tk::Dictionary.new(ARGV)
+  ::Tk.mainloop
+end # dictionary.rb

data/lib/dictionaries/project/project_base_directory.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/project/project_base_directory.rb'
+# =========================================================================== #
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries::PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY =
+    File.absolute_path("#{__dir__}/..")+'/'
+
+  # ========================================================================= #
+  # === Dictionaries.project_base_dir?
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end
+
+end

data/lib/dictionaries/project/project_yaml_directory.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will point to the yaml directory of the Dictionaries project.
+# =========================================================================== #
+require 'dictionaries/project/project_base_directory.rb'
+
+module Dictionaries # require 'dictionaries/project_base_directory.rb'
+
+  # ========================================================================= #
+  # === PROJECT_YAML_DIRECTORY
+  # ========================================================================= #
+  PROJECT_YAML_DIRECTORY = "#{PROJECT_BASE_DIRECTORY}yaml/"
+
+  # ========================================================================= #
+  # === Dictionaries.project_yaml_dir?
+  # ========================================================================= #
+  def self.project_yaml_dir?
+    PROJECT_YAML_DIRECTORY
+  end; self.instance_eval { alias dictionary_directory? project_yaml_dir? } # === Dictionaries.dictionary_directory?
+
+end

data/lib/dictionaries/require_project/require_project.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/ask_english_word.rb'
+require 'dictionaries/ask_italian_word.rb'
+require 'dictionaries/toplevel_methods/has_key.rb' # This file requires the files above.
+require 'dictionaries/toplevel_methods/module_methods.rb'
+require 'dictionaries/toplevel_methods/english_to_german.rb'
+require 'dictionaries/toplevel_methods/is_on_roebe.rb'

data/lib/dictionaries/sinatra/app.rb

@@ -0,0 +1,93 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::Sinatra
+# =========================================================================== #
+# require 'dictionaries/sinatra/app.rb'
+# =========================================================================== #
+require 'sinatra/base.rb'
+require 'dictionaries/class/ask_word_from_dictionary.rb'
+require 'dictionaries/toplevel_methods/is_on_roebe.rb'
+require 'html_tags'
+require 'dictionaries/sinatra/english_to_german.rb'
+
+module Dictionaries
+
+class Sinatra < ::Sinatra::Base
+
+  include Colours
+  include Colours::E
+  include HtmlTags::BaseModule
+
+  # ========================================================================= #
+  # === USE_THIS_PORT
+  # ========================================================================= #
+  USE_THIS_PORT = '5252'
+
+  set :port, USE_THIS_PORT
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    reset
+    if ::Dictionaries.is_on_roebe?
+      require 'open_in_browser'
+      # ===================================================================== #
+      # Tell us which port will be used:
+      # ===================================================================== #
+      target = "http://localhost:#{USE_THIS_PORT}/"
+      e sfancy(target)
+      Thread.new {
+        sleep 1.0
+        OpenInBrowser[target]
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === / Entry point
+  #
+  # This is the root of our web-application.
+  # ========================================================================= #
+  get('/'){
+    html_header_default_title_and_start_of_the_body_tag+
+    p('Available translations:')+
+    a('/english_to_german')+
+    br+
+    a('/german_to_english')+
+    br
+  }
+
+  # ========================================================================= #
+  # === not_found
+  # ========================================================================= #
+  not_found {
+    p('This particular <b>API</b> was not found.')
+  }
+
+end
+
+# =========================================================================== #
+# === Dictionaries.start_sinatra_interface
+#
+# This method can be used to start the sinatra interface.
+# =========================================================================== #
+def self.start_sinatra_interface
+  e 'Trying to start the sinatra-interface of the Dictionaries project.'
+  ::Dictionaries::Sinatra.run!
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Dictionaries.start_sinatra_interface
+end # dictionaries --sinatra

data/lib/dictionaries/sinatra/english_to_german.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'dictionaries/toplevel_methods/english_to_german.rb'
+require 'sinatra/base.rb'
+
+module Dictionaries
+
+class Sinatra < ::Sinatra::Base
+
+  # ========================================================================= #
+  # === /english_to_german
+  #
+  # This is the root of our web-application.
+  # ========================================================================= #
+  get('/english_to_german'){
+    return_english_to_german_form
+  }
+
+  # ========================================================================= #
+  # === return_english_to_german_form
+  # ========================================================================= #
+  def return_english_to_german_form
+    route_to_this_action = '/english_to_german/'
+    html_header_default_title_and_start_of_the_body_tag+
+    h3('Input an english word next to see the translation.')+
+    div(css_style: 'padding: 0.1em') {
+      p(
+        '<b>Enter the word here:</b>', css_style: 'padding:0.15em'
+      )+
+      form(action: route_to_this_action, id: 'english_to_german', css_style: 'margin-left:1em; margin-top:2px') {
+        '<input type="text" name="user_input" style="border:3px solid slateblue; padding: 4px"><br>'+
+        return_search_button
+      }
+    }
+  end
+
+  # ========================================================================= #
+  # === /english_to_german
+  #
+  # This is the root of our web-application.
+  # ========================================================================= #
+  get('/english_to_german/*'){
+    _ = params[:splat]
+    if params.has_key?('user_input')
+      _ = params.fetch('user_input')
+    end
+    _ = _.join if _.is_a? Array
+    translated_word = Dictionaries.english_to_german(_)
+    if translated_word
+      html_header_default_title_and_start_of_the_body_tag+
+      p('This translates to: '\
+      '<b style="font-size: larger; color: darkblue">'+translated_word+'</b>')+
+      br+
+      return_english_to_german_form
+    else
+      html_header_default_title_and_start_of_the_body_tag+
+      p('The key '+_.to_s+' is not registered in the Dictionaries word file.')
+    end
+  }
+
+  # ========================================================================= #
+  # === html_header_default_title_and_start_of_the_body_tag
+  # ========================================================================= #
+  def html_header_default_title_and_start_of_the_body_tag
+    "<html>\n"\
+    "<title>Dictionaries</title>\n"\
+    "<body>\n"
+  end
+
+  # ========================================================================= #
+  # === return_search_button
+  # ========================================================================= #
+  def return_search_button
+    '<input type="submit" name="user_input_submit" value="Search" '\
+    'style="font-weight: bold; font-size: larger; '\
+    'border: 2px dotted slateblue; margin: 4px">'
+  end
+
+end; end

data/lib/dictionaries/toplevel_methods/e.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/toplevel_methods/e.rb'
+# =========================================================================== #
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries.e
+  # ========================================================================= #
+  def self.e(i = '')
+    puts i
+  end
+
+end

data/lib/dictionaries/toplevel_methods/english_to_german.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/toplevel_methods/english_to_german.rb'
+# =========================================================================== #
+require 'dictionaries/toplevel_methods/has_key.rb'  
+require 'dictionaries/toplevel_methods/misc.rb'
+
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries.english_to_german
+  #
+  # This method will return nil if the key has not been found in the
+  # Dictionaries dataset.
+  # ========================================================================= #
+  def self.english_to_german(i)
+    i = i.join.strip if i.is_a? Array
+    converted_word = nil
+    if Dictionaries.has_key? i
+      converted_word = Dictionaries[i]
+    end
+    converted_word
+  end; self.instance_eval { alias translate_this_from_english_to_german english_to_german } # === Dictionaries.translate_this_from_english_to_german
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  pp Dictionaries.english_to_german(ARGV)
+end

data/lib/dictionaries/toplevel_methods/has_key.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/toplevel_methods/has_key.rb'
+# Dictionaries.has_key?
+# =========================================================================== #
+require 'dictionaries/ask_english_word.rb'
+
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries.has_key?
+  #
+  # Query whether the main file of the Dictionaries namespace, has the
+  # given input key at hand.
+  #
+  # Returns:
+  #   true if the key is included
+  #   false otherwise
+  #
+  # Invocation examples:
+  #
+  #   Dictionaries.has_key? 'apprehensions'
+  #   Dictionaries.has_key? 'apprehensio'
+  #
+  # ========================================================================= #
+  def self.has_key?(this_key)
+    Dictionaries::AskEnglishWord.dataset?.has_key?(this_key)
+  end
+
+end

data/lib/dictionaries/toplevel_methods/is_on_roebe.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/toplevel_methods/is_on_roebe.rb'
+# =========================================================================== #
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries.is_on_roebe?
+  # ========================================================================= #
+  def self.is_on_roebe?
+    (ENV['IS_ROEBE'].to_s == '1')
+  end
+
+end

data/lib/dictionaries/toplevel_methods/main_file.rb

@@ -0,0 +1,88 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/toplevel_methods/main_file.rb'
+# =========================================================================== #
+module Dictionaries
+
+  # ========================================================================= #
+  # === @main_file
+  #
+  # This module-level instance variable keeps track of the main file in
+  # use.
+  # ========================================================================= #
+  @main_file = nil
+
+  # ========================================================================= #
+  # === DICTIONARIES_FILE
+  #
+  # Add support for the environment variable DICTIONARIES_FILE here.
+  # ========================================================================= #
+  if ENV['DICTIONARIES_FILE'] and
+     File.exist?(ENV['DICTIONARIES_FILE'])
+    @main_file = ENV['DICTIONARIES_FILE'].to_s
+  end
+
+  # ========================================================================= #
+  # === Dictionaries.return_name_from_compound
+  #
+  # This method will return 'italian' if the input is 'ask_italian_word'.
+  # ========================================================================= #
+  def self.return_name_from_compound(
+      i = Dictionaries.main_file?
+    )
+    i = i.to_s
+    i = File.basename(i).gsub(/.rb/, '').gsub(/.yml/, '')
+    if i.include? '_'
+      i = i.split('_')[1] # Grab the middle part here.
+    end
+    i
+  end
+
+  # ========================================================================= #
+  # === Dictionaries.set_main_file
+  #
+  # Use this method to designate the main yaml file which should contain
+  # the language-specific translations.
+  #
+  # If the input includes a '/' token and also ends with '.rb' then we
+  # assume that it may be in the form of this:
+  #
+  #   /Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/dictionaries/lib/dictionaries/ask_italian_word.rb
+  #
+  # So we will instead use the second part of the last part.
+  #
+  # Usage example:
+  #
+  #   Dictionaries.set_main_file(THIS_FILE)
+  #
+  # ========================================================================= #
+  def self.set_main_file(i = :default_file)
+    case i
+    when :default_file,
+         :default
+      i = FILE_ENGLISH_WORDS
+    end
+    if i.include? '/'
+      if i.end_with? '.rb' 
+        i = File.basename(i).sub(/.rb^/,'')
+        if i.include? '_'
+          i = Dictionaries.return_name_from_compound(i) # Grab the middle part here.
+          i = DICTIONARIES_DIR+i+'.yml'
+        end
+      end
+    end
+    @main_file = i
+  end
+
+  # ========================================================================= #
+  # === Dictionaries.main_file?
+  #
+  # Query method over the @main_file module-level instance variable.
+  # ========================================================================= #
+  def self.main_file?
+    @main_file
+  end; self.instance_eval { alias main_file main_file? } # === Dictionaries.main_file
+
+end