dictionaries 0.2.177

data/lib/dictionaries/class/colours.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+begin
+  require 'colours'
+rescue LoadError; end
+
+module Dictionaries
+
+class AskWordFromDictionary
+
+  # ========================================================================= #
+  # === green
+  # ========================================================================= #
+  def green
+    Colours::GREEN
+  end
+
+  # ========================================================================= #
+  # === brown
+  # ========================================================================= #
+  def brown(i = '')
+    "#{Colours::BROWN}#{i}#{Colours.revert}"
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(i)
+    ::Colours.sfancy(i)
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(i)
+    ::Colours.simp(i)
+  end; alias simportant simp # === simportant
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i)
+    ::Colours.sfile(i)
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i)
+    ::Colours.sdir(i)
+  end
+
+end; end

data/lib/dictionaries/class/set_search_for_this_word.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/class/set_search_for_this_word.rb'
+# =========================================================================== #
+module Dictionaries
+
+class AskWordFromDictionary
+
+  # ========================================================================= #
+  # === set_search_for_this_word                                   (menu tag)
+  #
+  # This method will also have the menu-functionality of the class.
+  # ========================================================================= #
+  def set_search_for_this_word(i = :rand)
+    i = i.join(' ').strip if i.is_a? Array # This will also handle empty ARGV passed to us.
+    i = :rand if i.nil?
+    case i
+    when :rand, 'rand' # We want a random word here.
+      i = return_random_word if @words
+    end
+    # ======================================================================= #
+    # We want a String past this point.
+    # ======================================================================= #
+    i = i.to_s.dup
+    # ======================================================================= #
+    # We can not downcase the input since we also try to have it match
+    # towards regular english letters. It is a dictionary after all.
+    # ======================================================================= #
+    # === Chop off last char if it is a question mark.
+    # ======================================================================= #
+    i.chop! if i.end_with? '?'
+    case i # case tag
+    # ======================================================================= #
+    # === askeng --delay?
+    # ======================================================================= #
+    when /^-?-?delay\??$/i
+      feedback_delay
+    # ======================================================================= #
+    # === askeng --openall
+    # ======================================================================= #
+    when 'OPEN','OPE','OP','O','EDIT','OPEN_ALL',/open/,
+         'OPENALL','--openall'
+      open_this_file_here(true) # true for "be verbose".
+      open_yaml_file_in_main_editor
+      exit
+    # ======================================================================= #
+    # === askeng --n-entries
+    # ======================================================================= #
+    when 'TOTAL','KEYS','KEYSTATS','--n-entries','--nentries','keys?',
+         'nkeys',/-?-?nwords\??/
+      feedback_total_amount_of_keys
+    # ======================================================================= #
+    # === askeng --stats
+    # ======================================================================= #  
+    when '--stats','--statistics','STATS','STATISTICS','STATS?','--stats?'
+      feedback_statistics; exit
+    # ======================================================================= #
+    # === askeng --help
+    # ======================================================================= #
+    when 'HELP','--help','show_help','--HELP'
+      feedback_help_options # This will also exit.
+    # ======================================================================= #
+    # === askeng --every_word
+    # ======================================================================= #
+    when 'SHOW','--show-every-word','--every_word'
+      show_every_word
+      exit
+    # ======================================================================= #
+    # === askeng --generate-tab
+    # ======================================================================= #
+    when 'GENERATE','TAB','GENERATE_COMPLETION','TABCOMPLETION',
+         'COMPLETION','--generate-tab'
+      generate_tab_completion
+      exit
+    # ======================================================================= #
+    # === askeng --open-in-browser
+    # ======================================================================= #
+    when 'OPEN_BROWSER','--open-in-browser'
+      open_in_browser
+    # ======================================================================= #
+    # === askeng --solved
+    # ======================================================================= #
+    when 'SOLVED',/-?-?solved/
+      set_last_word_solved
+    # ======================================================================= #
+    # === askeng --yaml-file?
+    # ======================================================================= #
+    when 'FILE?','YAML_FILE?','--yaml-file?'
+      feedback_yaml_file
+      exit
+    # ======================================================================= #
+    # === askeng --open-dictionary
+    # ======================================================================= #
+    when 'OPEN_DICTIONARY','OPEN_DICT','--open-dictionary'
+      open_main_yaml_file_in_main_editor
+      exit
+    # ======================================================================= #
+    # === askeng --repeat
+    # ======================================================================= #
+    when 'REPEAT','--repeat'
+      _ = STORE_LAST_QUESTION_ASKED_HERE
+      if File.exist? _
+        i = File.read(_)
+      else
+        opnn; e 'The file `'+sfile(_)+'` was not found, thus we can'
+        opnn; e 'not read in anything.'
+        exit
+      end
+    # ======================================================================= #
+    # === askeng --url
+    # ======================================================================= #
+    when '--url','URL'
+      feedback_url
+    # ======================================================================= #
+    # === askeng --random
+    # ======================================================================= #
+    when 'RANDOM','RAND','rand','--random' # Pass through here.
+      i = return_random_word if available_keys?
+    # else tag
+    else # Handle assignment cases next.
+      if i.include?('=') and i.downcase.include? 'delay'
+        new_delay = i.split('=').last.strip
+        e 'It seems as if you may want to assign a new delay.'
+        e 'We will thus set the last line of this file here'
+        e 'with the new delay of:'
+        e '  '+sfancy(new_delay)
+        what = File.readlines(Dictionaries::AskEnglishWord.main_file?)
+        what[-1,1] = new_delay # Set the new entry here.
+        SaveFile.write_what_into(what.join, Dictionaries::AskEnglishWord.main_file?)
+        exit
+      end
+    end
+    i = i.to_s.dup
+    i = i.downcase if SHALL_WE_DOWNCASE
+    if i.size == 1 # We assume that the user wants to get a category.
+      i = find_all_matches_for(i).sample
+    end
+    @search_for_this_word = i # We will search for this word here.
+  end
+
+end; end

data/lib/dictionaries/commandline/parse_commandline.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/commandline/parse_commandline.rb'
+# =========================================================================== #
+require 'dictionaries/toplevel_methods/show_help.rb'
+require 'dictionaries/class/ask_word_from_dictionary.rb'
+
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries.start_gtk_component
+  #
+  # This module-method will start the GTK component.
+  # ========================================================================= #
+  def self.start_gtk_component
+    require 'dictionaries/gui/gtk/dictionary.rb'
+    Dictionaries::GUI::Gtk::Dictionary.run
+  end
+
+  # ========================================================================= #
+  # === Dictionaries.parse_commandline
+  # ========================================================================= #
+  def self.parse_commandline(
+      i = ARGV
+    )
+    if i.is_a? Array
+      i.each {|entry| parse_commandline(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === dictionaries --sinatra
+      # ===================================================================== #
+      when /^-?-?sinatra$/i
+        require 'dictionaries/sinatra/app.rb'
+        Dictionaries.start_sinatra_interface
+      # ===================================================================== #
+      # === dictionaries --n-words?
+      # ===================================================================== #
+      when /^-?-?n(_|-)?words\??$/i
+        e "#{Colours.sfancy(Dictionaries.n_entries?)} english-to-german "\
+          "translations are presently registered in this project."
+      # ===================================================================== #
+      # === dictionaries --gui
+      # ===================================================================== #
+      when /^-?-?gui$/i,
+           /^-?-?gtk$/i,
+           /^-?-?start(-|_)?gtk$/i
+        start_gtk_component
+      # ===================================================================== #
+      # === dictionaries --help
+      # ===================================================================== #
+      when /help/
+        show_help
+      end
+    end
+  end
+
+end

data/lib/dictionaries/constants.rb

@@ -0,0 +1,133 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'dictionaries/constants.rb'
+# =========================================================================== #
+require 'dictionaries/project/project_yaml_directory.rb'
+require 'dictionaries/version/version.rb'
+
+module Dictionaries
+
+  # ========================================================================= #
+  # === Dictionaries::N
+  # ========================================================================= #
+  N = "\n"
+
+  # ========================================================================= #
+  # === Dictionaries::URL_FOR_DICT_LEO
+  # ========================================================================= #
+  URL_FOR_DICT_LEO = 'http://dict.leo.org/'
+
+  # ========================================================================= #
+  # === URL_FOR_ITALIAN_DICTIONARY
+  # ========================================================================= #
+  URL_FOR_ITALIAN_DICTIONARY = 'http://www.wordreference.com/iten/'
+
+  # ========================================================================= #
+  # === LPAD
+  # ========================================================================= #
+  LPAD = '  '
+
+  # ========================================================================= #
+  # === RUBY_SRC
+  # ========================================================================= #
+  if ENV['RUBY_SRC']
+    RUBY_SRC = ENV['RUBY_SRC'].to_s.dup+'/'
+  else # else we just hardcode it anyway.
+    RUBY_SRC = '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/'
+  end
+
+  # ========================================================================= #
+  # === MY_DICTIONARIES
+  #
+  # This constant is only valid for my own system.
+  # ========================================================================= #
+  MY_DICTIONARIES = RUBY_SRC+'dictionaries/lib/dictionaries/yaml/'
+
+  # ========================================================================= #
+  # === SCIENCE_DIR
+  # ========================================================================= #
+  SCIENCE_DIR = ENV['SCIENCE'].to_s+'/'
+
+  # ========================================================================= #
+  # === DEPOT_INFORMATION_DIR
+  # ========================================================================= #
+  DEPOT_INFORMATION_DIR = '/Depot/Information/'
+
+  # ========================================================================= #
+  # === DICTIONARIES_DIR
+  #
+  # This constant will point at a path such as this one here:
+  #
+  #   /Programs/Ruby/2.6.3/lib/ruby/site_ruby/2.6.0/dictionaries/yaml/
+  #
+  # ========================================================================= #
+  DICTIONARIES_DIR = Dictionaries.dictionary_directory?
+
+  # ========================================================================= #
+  # === ENGLISH_WORDS
+  #
+  # This constant is no longer that important because we can now
+  # automatically infer the name of the .yml file.
+  # ========================================================================= #
+  ENGLISH_WORDS = DICTIONARIES_DIR+'english.yml'
+  ENGLISH_YAML_FILE = ENGLISH_WORDS  # === ENGLISH_YAML_FILE
+  FILE_ENGLISH_WORDS = ENGLISH_WORDS # === FILE_ENGLISH_WORDS
+  FILE_ENGLISH_DICTIONARY = ENGLISH_YAML_FILE
+
+  # ========================================================================= #
+  # === Dictionaries.file_english
+  # ========================================================================= #
+  def self.file_english
+    FILE_ENGLISH_DICTIONARY
+  end
+
+  # ========================================================================= #
+  # === ITALIAN_WORDS
+  #
+  # This constant is no longer that important because we can now
+  # automatically infer the name of the .yml file.
+  # ========================================================================= #
+  ITALIAN_WORDS = DICTIONARIES_DIR+'italian.yml'
+  ITALIAN_YAML_FILE = ITALIAN_WORDS
+  FILE_ITALIAN_DICTIONARY = ITALIAN_YAML_FILE
+
+  # ========================================================================= #
+  # === STORE_LINE_NUMBER_HERE
+  # ========================================================================= #
+  STORE_LINE_NUMBER_HERE = DEPOT_INFORMATION_DIR+'line_number_of_the_last_word'
+
+  # ========================================================================= #
+  # === STORE_LAST_ENGLISH_QUESTION_ASKED_HERE
+  # ========================================================================= #
+  STORE_LAST_ENGLISH_QUESTION_ASKED_HERE =
+    DEPOT_INFORMATION_DIR+'last_english_question_asked' # cat $MY_TEMP/last_english_question_asked
+
+  # ========================================================================= #
+  # === STORE_LAST_ITALIAN_QUESTION_ASKED_HERE
+  # ========================================================================= #
+  STORE_LAST_ITALIAN_QUESTION_ASKED_HERE =
+    DEPOT_INFORMATION_DIR+'last_italian_question_asked' # cat $MY_TEMP/last_italian_question_asked
+
+  # ========================================================================= #
+  # === SHALL_WE_DOWNCASE
+  # ========================================================================= #
+  SHALL_WE_DOWNCASE = true
+
+  # ========================================================================= #
+  # === USE_THIS_ENCODING
+  #
+  # This is the main encoding to use.
+  # ========================================================================= #
+  USE_THIS_ENCODING = 'ISO-8859-1'
+    MAIN_ENCODING = USE_THIS_ENCODING
+
+  # ========================================================================= #
+  # === DEFAULT_DELAY
+  #
+  # Specify how long to wait before revealing the translated word.
+  # ========================================================================= #
+  DEFAULT_DELAY = 1.6
+
+end

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

@@ -0,0 +1,216 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Dictionaries::GUI::Gtk::Dictionary
+#
+# This is a small GUI-wrapper.
+# =========================================================================== #
+# require 'dictionaries/gui/gtk/dictionary.rb'
+# Dictionaries.gtk_widget
+# =========================================================================== #
+begin
+  require 'gtk_paradise'
+rescue LoadError
+  puts 'error: gtk_paradise has a problem.'
+end
+require 'dictionaries/class/ask_word_from_dictionary.rb'
+require 'dictionaries/toplevel_methods/e.rb'
+
+module Dictionaries
+
+module GUI
+
+module Gtk
+
+class Dictionary < ::Gtk::VBox
+
+  include ::Gtk::BaseModule
+  include ::Colours
+
+  # ========================================================================= #
+  # === USE_THIS_WIDTH
+  # ========================================================================= #
+  USE_THIS_WIDTH = 1080
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    super()
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # === @dictionaries
+    @dictionaries = Dictionaries.new(:do_not_run_yet)
+    @dictionaries.load_the_english_file
+    set_gtk_font_size :default
+  end
+
+  # ========================================================================= #
+  # === e
+  # ========================================================================= #
+  def e(i = '')
+    ::Dictionaries.e(i)
+  end
+
+  # ========================================================================= #
+  # === add_ask_the_question_button
+  # ========================================================================= #
+  def add_ask_the_question_button
+    button = gtk_button('Translate into german')
+    button.make_bold
+    button.tooltip(
+      'Click this button in order to translate the english '\
+      'word into the german equivalent word.'
+    )
+    button.signal_connect(:clicked) {
+      button_pressed_so_try_to_convert_the_input
+    }
+    button.modify_bg(
+      ::Gtk::StateType::NORMAL,   Gdk::Color.parse('whitesmoke')
+    ) # ^^^ default colour
+    button.modify_bg(
+      ::Gtk::StateType::PRELIGHT, Gdk::Color.parse('paleturquoise')
+    ) # ^^^ mouse-on-over
+    button.modify_bg(
+      ::Gtk::StateType::ACTIVE,   Gdk::Color.parse('slategray')
+    ) # ^^^ colour on mouse-press-event
+    pack_start(button, false, true, 0)
+  end
+
+  # ========================================================================= #
+  # === create_answer_field
+  # ========================================================================= #
+  def create_answer_field
+    @answer_field = gtk_input_field
+    @answer_field.center
+  end
+
+  # ========================================================================= #
+  # === create_input_field_on_top
+  #
+  # This is the main widget for user input. The user types in some
+  # words, and then hits the main button on the bottom, in order
+  # to translate the (english) word to german.
+  # ========================================================================= #
+  def create_input_field_on_top
+    text_for_the_label = 'Input an english word in the field below:'
+    text = gtk_label(text_for_the_label)
+    text.set_markup(
+      '<span size="x-large" weight="bold">'+text_for_the_label+'</span>', true
+    )
+    # ======================================================================= #
+    # Add the "input field" next for the english word that is to
+    # be translated.
+    # ======================================================================= #
+    @input_field = gtk_input_field
+    completion = gtk_entry_completion
+    @input_field.completion = completion
+    completion_model = ::Gtk::ListStore.new(String)
+    @dictionaries.array.each { |word|
+      iter = completion_model.append
+      iter[0] = word
+    }
+    completion.model = completion_model
+    # ======================================================================= #
+    # Use model column 0 as the text column
+    # ======================================================================= #
+    completion.text_column = 0
+    @input_field.center
+    @input_field.signal_connect(:key_press_event) { |widget, event|
+      if Gdk::Keyval.to_name(event.keyval) == 'Return' 
+        button_pressed_so_try_to_convert_the_input
+      end
+    }
+    hbox_holding_label_and_input_field = gtk_vbox(
+      text, @input_field
+    )
+    pack_start(hbox_holding_label_and_input_field, false, false, 4)
+  end
+
+  # ========================================================================= #
+  # === button_pressed_so_try_to_convert_the_input                (click tag)
+  # ========================================================================= #
+  def button_pressed_so_try_to_convert_the_input
+    user_input = @input_field.return_input
+    translated_word = @dictionaries.translate(user_input)
+    e sfancy(user_input)+' → '+simp(translated_word)
+    # ===================================================================== #
+    # We need ISO encoding there.
+    # ===================================================================== #
+    translated_word = GLib.convert(
+      translated_word, 'utf-8', 'iso-8859-1'
+    )
+    @answer_field.set_text(translated_word)
+  end
+
+  # ========================================================================= #
+  # === width?
+  # ========================================================================= #
+  def width?
+    480 # Return the default width for our widget.
+  end
+
+  # ========================================================================= #
+  # === height?
+  # ========================================================================= #
+  def height?
+    300 # Return the default height for our widget.
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    create_input_field_on_top
+    create_answer_field
+    pack_start(@answer_field, false) # <- Translation appears here.
+    add_ask_the_question_button
+    show_all
+  end
+
+  # ========================================================================= #
+  # === Dictionaries::GUI::Gtk::Dictionary.run
+  #
+  # Use this method if you wish to start a new gtk-application window.
+  # ========================================================================= #
+  def self.run
+    dictionary = new
+    runner = ::Gtk::Runner.new
+    runner.width = USE_THIS_WIDTH
+    runner.set_size_request(
+      dictionary.width?,
+      dictionary.height?
+    )
+    runner.title = 'Dictionary'
+    runner.border_width = 10
+    runner << dictionary
+    runner.top_left_then_run
+  end
+
+end; end; end
+
+# =========================================================================== #
+# === Dictionaries.gtk_widget
+#
+# This toplevel-method can be used to return the gtk-widget, which
+# can then be embedded by other ruby-gtk applications, in particular
+# admin_panel.rb of the gtk_paradise project.
+# =========================================================================== #
+def self.gtk_widget
+  Dictionaries::GUI::Gtk::Dictionary.new
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Dictionaries::GUI::Gtk::Dictionary.run
+end