libui_paradise 0.2.49

data/lib/libui_paradise/project/project.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/project/project.rb'
+# LibuiParadise.project_base_dir?
+# =========================================================================== #
+module LibuiParadise
+
+  # ========================================================================= #
+  # === PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY =
+    File.absolute_path("#{__dir__}/..")+'/'
+    BASE_DIR = PROJECT_BASE_DIRECTORY
+
+  # ========================================================================= #
+  # === LibuiParadise.project_base_dir?
+  #
+  # Preferentially use this method rather than the constant above directly.
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end; self.instance_eval { alias project_base_dir        project_base_dir? } # === LibuiParadise.project_base_dir
+       self.instance_eval { alias project_base_dir?       project_base_dir? } # === LibuiParadise.project_base_dir?
+       self.instance_eval { alias project_base_directory? project_base_dir? } # === LibuiParadise.project_base_directory?
+
+end

data/lib/libui_paradise/prototype/README.md

@@ -0,0 +1,3 @@
+The .rb file in this directory can be used to quickly copy/paste
+a working skeleton that can be adjusted and modifed for quick
+GUI prototyping via libui.

data/lib/libui_paradise/prototype/prototype.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === LibuiParadise::GUI::LibUI::Prototype
+# =========================================================================== #
+module LibuiParadise
+
+module GUI
+
+module LibUI
+
+class Prototype # === LibuiParadise::GUI::LibUI::Prototype
+
+  alias e puts
+
+  require 'libui_paradise'
+  include LibuiParadise::Extensions
+
+  # require 'bioroebe/gui/shared_code/levensthein_distance/levensthein_distance_module.rb'
+  # include Bioroebe::GUI::LevenstheinDistanceModule
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'A prototype for LibUI'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 680
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 520
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    title_width_height(TITLE, WIDTH, HEIGHT)
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_skeleton
+    # ======================================================================= #
+    # === @window
+    # ======================================================================= #
+    @window = ui_padded_main_window(title?, width?, height?, 0)
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+    outer_vbox = padded_vbox
+    # ======================================================================= #
+    # First add the two buttons on top:
+    # ======================================================================= #
+    hbox_on_top = padded_hbox
+    button_refresh = ui_button('Refresh')
+    button_refresh.on_clicked {
+      e 'TODO: Refresh this ... or add any other functionality.'
+    }
+    hbox_on_top.maximal(button_refresh)
+    hbox_on_top.maximal(quit_button)
+    outer_vbox.minimal(hbox_on_top)
+    outer_vbox.add_hsep
+
+    grid = ui_padded_grid
+    #                         widget, left, top, xspan, yspan, hexpand, halign, vexpand, valign
+    grid.ui_grid_append(text('Left'),  0, 0, 1, 1, 0, 0.5, 1, 0)
+    grid.ui_grid_append(text('Right'), 1, 0, 1, 1, 0, 0.5, 1, 0)
+
+    3.times.each {|index| index += 1
+      # ===================================================================== #
+      # left, top, xspan, yspan, hexpand, halign, vexpand, valign
+      #  0,    0,    2,     1,      0,      0,       1,      0
+      # ===================================================================== #
+      grid.ui_grid_append(text(index.to_s), 0, 1+index, 1, 1, 1, 1, 1, 1)
+      label_exam_topic = text(entry.to_s)
+      grid.ui_grid_append(label_exam_topic, 1, 1+index, 1, 1, 1, 1, 1, 1)
+    }
+    outer_vbox.maximal(grid)
+    @window.add(outer_vbox)
+    @window.intelligent_exit
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  LibuiParadise::GUI::LibUI::Prototype.new  
+end

data/lib/libui_paradise/requires/require_the_libui_classes.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/requires/require_the_libui_classes.rb'
+# =========================================================================== #
+module LibuiParadise
+
+  require 'libui_paradise/project/project.rb'
+
+  # ========================================================================= #
+  # === LibuiParadise.do_require_the_libui_classes
+  #
+  # This method will batch-require all libui-paradise classes under
+  # the libui_classes/ subdirectory.
+  # ========================================================================= #
+  def self.do_require_the_libui_classes
+    target = LibuiParadise.project_base_dir?+'libui_classes/*.rb'
+    files_that_are_to_be_required = Dir[target]
+    files_that_are_to_be_required.each {|this_file|
+      require "libui_paradise/libui_classes/#{File.basename(this_file)}"
+    }
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  LibuiParadise.do_require_the_libui_classes
+end

data/lib/libui_paradise/requires/require_the_libui_paradise_project.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/requires/require_the_libui_paradise_project.rb'
+# =========================================================================== #
+require 'libui_paradise/extensions/extensions.rb' # This also pulls in another file, called pointer.rb.
+require 'libui_paradise/project/project.rb'
+require 'libui_paradise/toplevel_methods/misc.rb'
+require 'libui_paradise/requires/require_the_libui_classes.rb'
+
+LibuiParadise.do_require_the_libui_classes

data/lib/libui_paradise/toplevel_methods/misc.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/toplevel_methods/misc.rb'
+# =========================================================================== #
+module LibuiParadise
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  LibuiParadise
+end # misc.rb

data/lib/libui_paradise/version/version.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module LibuiParadise
+
+  # ========================================================================= #
+  # === VERSION
+  # ========================================================================= #
+  VERSION = '0.2.49'
+
+  # ========================================================================= #
+  # === LAST_UPDATE
+  # ========================================================================= #
+  LAST_UPDATE = '09.10.2022'
+
+end

data/lib/libui_paradise.rb

@@ -0,0 +1 @@
+require 'libui_paradise/requires/require_the_libui_paradise_project.rb'

data/libui_paradise.gemspec

@@ -0,0 +1,49 @@
+# =========================================================================== #
+# Gemspec for this project.
+# =========================================================================== #
+require 'libui_paradise/version/version.rb'
+require 'roebe/toplevel_methods/misc.rb'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'libui_paradise'
+  s.version = LibuiParadise::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+  
+  DESCRIPTION = <<-EOF
+
+This project bundles together some custom bindings and code to the
+official (upstream) ruby-libui interface. ruby-libui, in turn,
+makes available code written in the libui project. You can find
+the libui project here: https://github.com/andlabs/libui
+and the ruby-libui bindings maintained by kojix2 here:
+https://rubygems.org/gems/libui
+
+For more documentation about the libui_paradise gem, please have a look
+at the official homepage of this gem at rubygems.org, at its
+documentation/ link on the bottom right hand side (or just use
+this link directly:
+https://www.rubydoc.info/gems/libui_paradise/
+)
+
+  EOF
+
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  s.authors  = ['Robert A. Heiler']
+  s.email    = Roebe.email?
+  s.files    = Dir['**/*']
+  s.license  = 'MIT'
+  s.homepage = 'https://www.rubydoc.info/gems/libui_paradise/'
+
+  s.required_ruby_version     = '>= '+Roebe.third_most_stable_version_of_ruby
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # Dependencies for the project:
+  # ========================================================================= #
+  s.add_dependency 'libui'
+
+}

data/test/testing_generic_window.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise'
+
+text1 = LibuiParadise.text('Some text here.')
+text2 = LibuiParadise.text('Some text there.')
+
+::LibuiParadise.run_in_the_background
+
+LibuiParadise.generic_window(
+  text1,
+  text2,
+  :create_a_quit_button # Ad-hoc create a quit-button.
+) {{
+  width:  620,
+  height: 220,
+  title:  'This is just a test! It should show this as title.'
+}}

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: libui_paradise
+version: !ruby/object:Gem::Version
+  version: 0.2.49
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: libui
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2+
+
+  This project bundles together some custom bindings and code to the
+  official (upstream) ruby-libui interface. ruby-libui, in turn,
+  makes available code written in the libui project. You can find
+  the libui project here: https://github.com/andlabs/libui
+  and the ruby-libui bindings maintained by kojix2 here:
+  https://rubygems.org/gems/libui
+
+  For more documentation about the libui_paradise gem, please have a look
+  at the official homepage of this gem at rubygems.org, at its
+  documentation/ link on the bottom right hand side (or just use
+  this link directly:
+  https://www.rubydoc.info/gems/libui_paradise/
+  )
+
+email: shevy@inbox.lt
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- doc/README.gen
+- doc/SNIPPETS.md
+- doc/todo/todo.md
+- lib/libui_paradise.rb
+- lib/libui_paradise/autoinclude.rb
+- lib/libui_paradise/base/base.rb
+- lib/libui_paradise/colours/colours.rb
+- lib/libui_paradise/domain_specific_language/README.md
+- lib/libui_paradise/domain_specific_language/button.yml
+- lib/libui_paradise/examples/complex/001_hbox_example.rb
+- lib/libui_paradise/examples/complex/002_tabs_example.rb
+- lib/libui_paradise/examples/complex/003_open_file_button_example.rb
+- lib/libui_paradise/examples/complex/004_font_button.rb
+- lib/libui_paradise/examples/complex/005_search_entry_example.rb
+- lib/libui_paradise/examples/complex/006_coloured_boxes_example.rb
+- lib/libui_paradise/examples/complex/007_slider_example.rb
+- lib/libui_paradise/examples/complex/008_radio_button_example.rb
+- lib/libui_paradise/examples/complex/009_separator_example.rb
+- lib/libui_paradise/examples/complex/010_table_example.rb
+- lib/libui_paradise/examples/complex/011_two_buttons_showing_how_to_enable_and_disable_them.rb
+- lib/libui_paradise/examples/complex/012_password_entry_example.rb
+- lib/libui_paradise/examples/complex/013_form_example.rb
+- lib/libui_paradise/examples/complex/014_text_example.rb
+- lib/libui_paradise/examples/complex/015_text_view_example.rb
+- lib/libui_paradise/examples/complex/016_grid_example.rb
+- lib/libui_paradise/examples/complex/017_unicode_text_example.rb
+- lib/libui_paradise/examples/complex/018_spinbutton_example.rb
+- lib/libui_paradise/examples/complex/019_combo_box_example.rb
+- lib/libui_paradise/examples/complex/020_checkbox_example.rb
+- lib/libui_paradise/examples/complex/021_font_example.rb
+- lib/libui_paradise/examples/complex/022_simple_notepad_example.rb
+- lib/libui_paradise/examples/complex/023_msg_box_error.rb
+- lib/libui_paradise/examples/complex/024_parse_config_file_example.config
+- lib/libui_paradise/examples/complex/024_parse_config_file_example.rb
+- lib/libui_paradise/examples/complex/025_colour_button.rb
+- lib/libui_paradise/examples/complex/026_basic_table_image.rb
+- lib/libui_paradise/examples/complex/027_basic_button_example.rb
+- lib/libui_paradise/examples/complex/028_try_for_automatic_button_press_event_after_a_delay.rb
+- lib/libui_paradise/examples/complex/029_progressbar_example.rb
+- lib/libui_paradise/examples/complex/030_entry_responds_to_comment_as_synonymous_to_the_enter_key_pressed_example.rb
+- lib/libui_paradise/examples/complex/031_notification_functionality_example.rb
+- lib/libui_paradise/examples/complex/032_simple_window_example.rb
+- lib/libui_paradise/examples/complex/033_daemonize_and_exit_after_delay_example.rb
+- lib/libui_paradise/examples/simple/001_open_file_example.rb
+- lib/libui_paradise/examples/simple/002_histogram_example.rb
+- lib/libui_paradise/examples/simple/003_fancy_text_example.rb
+- lib/libui_paradise/examples/simple/004_date_time_picker.rb
+- lib/libui_paradise/examples/simple/005_text_drawing_example.rb
+- lib/libui_paradise/examples/simple/006_midi_player.rb
+- lib/libui_paradise/examples/simple/007_control_gallery.rb
+- lib/libui_paradise/examples/simple/008_basic_area_example.rb
+- lib/libui_paradise/examples/simple/009_spectrum.rb
+- lib/libui_paradise/examples/simple/README.md
+- lib/libui_paradise/experimental/dsl.rb
+- lib/libui_paradise/extensions/counters.rb
+- lib/libui_paradise/extensions/extensions.rb
+- lib/libui_paradise/extensions/hash_fiddle_pointer_widgets.rb
+- lib/libui_paradise/extensions/misc.rb
+- lib/libui_paradise/fiddle/pointer.rb
+- lib/libui_paradise/generic_window/README.md
+- lib/libui_paradise/generic_window/generic_window.rb
+- lib/libui_paradise/images/LIBUI_PARADISE_LOGO.png
+- lib/libui_paradise/images/README.md
+- lib/libui_paradise/images/form_example.png
+- lib/libui_paradise/libui_classes/box.rb
+- lib/libui_paradise/libui_classes/grid.rb
+- lib/libui_paradise/libui_classes/libui_classes.rb
+- lib/libui_paradise/project/project.rb
+- lib/libui_paradise/prototype/README.md
+- lib/libui_paradise/prototype/prototype.rb
+- lib/libui_paradise/requires/require_the_libui_classes.rb
+- lib/libui_paradise/requires/require_the_libui_paradise_project.rb
+- lib/libui_paradise/toplevel_methods/misc.rb
+- lib/libui_paradise/version/version.rb
+- libui_paradise.gemspec
+- test/testing_generic_window.rb
+homepage: https://www.rubydoc.info/gems/libui_paradise/
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.7
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: 'This project bundles together some custom bindings and code to the official
+  (upstream) ruby-libui interface. ruby-libui, in turn, makes available code written
+  in the libui project. You can find the libui project here: https://github.com/andlabs/libui
+  and the ruby-libui bindings maintained by kojix2 here: https://rubygems.org/gems/libui  For
+  more documentation about the libui_paradise gem, please have a look at the official
+  homepage of this gem at rubygems.org, at its documentation/ link on the bottom right
+  hand side (or just use this link directly: https://www.rubydoc.info/gems/libui_paradise/
+  )'
+test_files: []
+...