libui_paradise 0.2.49 → 0.4.13

data/lib/libui_paradise/version/version.rb

@@ -7,11 +7,11 @@ module LibuiParadise
   # ========================================================================= #
   # === VERSION
   # ========================================================================= #
-  VERSION = '0.2.49'
+  VERSION = '0.4.13'
 
   # ========================================================================= #
   # === LAST_UPDATE
   # ========================================================================= #
-  LAST_UPDATE = '09.10.2022'
+  LAST_UPDATE = '28.12.2023'
 
 end

data/libui_paradise.gemspec

@@ -15,15 +15,16 @@ Gem::Specification.new { |s|
 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
+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/
+  https://www.rubydoc.info/gems/libui_paradise/
 )
 
   EOF

data/test/testing_generic_window.rb

@@ -4,6 +4,8 @@
 # =========================================================================== #
 require 'libui_paradise'
 
+LibuiParadise.init
+
 text1 = LibuiParadise.text('Some text here.')
 text2 = LibuiParadise.text('Some text there.')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libui_paradise
 version: !ruby/object:Gem::Version
-  version: 0.2.49
+  version: 0.4.13
 platform: ruby
 authors:
 - Robert A. Heiler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-09 00:00:00.000000000 Z
+date: 2023-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: libui
@@ -24,34 +24,26 @@ dependencies:
     - - ">="
       - !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/
-  )
-
+description: "\nThis project bundles together some custom bindings and code to the\nofficial
+  (upstream) ruby-libui interface. ruby-libui, in turn,\nmakes available code written
+  in the libui project. You can find\nthe libui project here: https://github.com/andlabs/libui
+  and \nthe ruby-libui bindings maintained by kojix2 here:\n\n  https://rubygems.org/gems/libui\n\nFor
+  more documentation about the libui_paradise gem, please have a look\nat the official
+  homepage of this gem at rubygems.org, at its\ndocumentation/ link on the bottom
+  right hand side (or just use\nthis link directly:\n  https://www.rubydoc.info/gems/libui_paradise/\n)\n\n"
 email: shevy@inbox.lt
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- bin/libui_message
 - 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/base_module/base_module.rb
 - lib/libui_paradise/colours/colours.rb
 - lib/libui_paradise/domain_specific_language/README.md
 - lib/libui_paradise/domain_specific_language/button.yml
@@ -89,6 +81,8 @@ files:
 - 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/complex/034_bold_text_example.rb
+- lib/libui_paradise/examples/complex/035_parse_into_table_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
@@ -98,27 +92,39 @@ files:
 - 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/010_font_button.rb
+- lib/libui_paradise/examples/simple/011_simple_notepad.rb
+- lib/libui_paradise/examples/simple/012_table_example.rb
+- lib/libui_paradise/examples/simple/013_scrolling_pane_example.rb
+- lib/libui_paradise/examples/simple/014_simple_entry_example.rb
+- lib/libui_paradise/examples/simple/015_slider_example.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/fiddle/fiddle.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/button.rb
+- lib/libui_paradise/libui_classes/entry.rb
 - lib/libui_paradise/libui_classes/grid.rb
+- lib/libui_paradise/libui_classes/hbox.rb
 - lib/libui_paradise/libui_classes/libui_classes.rb
+- lib/libui_paradise/libui_classes/msg_box.rb
+- lib/libui_paradise/libui_classes/msg_box_error.rb
+- lib/libui_paradise/libui_classes/slider.rb
+- lib/libui_paradise/libui_classes/spinbox.rb
+- lib/libui_paradise/libui_classes/vbox.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/toplevel_methods/add_to_the_registered_widgets.rb
+- lib/libui_paradise/toplevel_methods/hash_fiddle_pointer_widgets.rb
+- lib/libui_paradise/toplevel_methods/toplevel_counters.rb
+- lib/libui_paradise/toplevel_methods/toplevel_methods.rb
 - lib/libui_paradise/version/version.rb
 - libui_paradise.gemspec
 - test/testing_generic_window.rb
@@ -139,18 +145,17 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.7
+      version: 3.5.3
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.3
 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
+  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: []
-...

data/doc/SNIPPETS.md

@@ -1,94 +0,0 @@
-# How to add a new main window:
-                                             # width, height, hasMenubar
-  main_window = UI.new_window('hello world', 300, 200, 1)
-
-  Source code:
-
-    https://raw.githubusercontent.com/andlabs/libui/master/unix/window.c
-
-# How to add a libui-widget to the main window / Designate a child widget:
-
-  UI.window_set_child(main_window, button)
-
-# Act on closing-event (on quit tag):
-
-  UI.window_on_closing(main_window) {
-    puts 'Bye Bye'
-    UI.control_destroy(main_window)
-    UI.quit
-    0
-  }
-  # Or simpler:
-  close_properly(main_window)
-
-# Add the window to the main UI:
-
-  UI.control_show(main_window)
-  main_window.show_the_controls # Or use this one here.
-
-
-# Add a checkbox (checkbox tag, checkbutton)
-
-  checkbox = UI.new_checkbox('Checkbox') # or ui_checkbox
-  checkbox_toggle_callback = proc { |pointer|
-    checked = UI.checkbox_checked(pointer) == 1
-    UI.window_set_title(MAIN_WINDOW, "Checkbox is #{checked}")
-    UI.checkbox_set_text(pointer, "I am the checkbox (#{checked})")
-    0
-  }
-  UI.checkbox_on_toggled(checkbox, checkbox_toggle_callback, nil)
-  UI.box_append(inner, checkbox, 0)
-
-  To set it checked:
-
-  checkbox.set_checked(1)
-
-  To query its state:
-
-    checked = UI.checkbox_checked(pointer) == 1
-
-# And the control:
-
-  UI.control_show(main_window)
-
-# Using a text-entry (ui entry tag):
-
-  text_entry = UI.new_entry
-  UI.entry_set_text(text_entry, 'Please enter your feelings')
-  UI.entry_on_changed(text_entry, text_changed_callback, nil)
-
-  # To set this on a "multiline entry", aka spanning several
-  # rows, do use:
-  UI.multiline_entry_set_text(entry1, 'Yo there')
-  ui_text_view # an alias used in libui_paradise
-
-  text1 = UI.entry_text(entry1) # Obtain text. You may have to call .to_s on it, to guarantee the String.
-  UI.multiline_entry_text # Obtain the text from a multiline entry.
-
-# Create a combobox (combo tag, combobox tag):
-
-  combobox_selected_callback = proc { |ptr|
-    puts "New combobox selection: #{UI.combobox_selected(ptr)}"
-  }
-  cbox = UI.new_combobox
-  UI.combobox_append(cbox, 'combobox Item 1')
-  UI.combobox_append(cbox, 'combobox Item 2')
-  UI.combobox_append(cbox, 'combobox Item 3')
-  UI.box_append(inner, cbox, 0)
-  UI.combobox_on_selected(cbox, combobox_selected_callback, nil)
-
-  # Or more concise:
-  combo_box = UI.combobox {
-    ['combobox Item 1', 'combobox Item 2', 'combobox Item 3']
-  }
-
-
-# Add content to an editable combox:
-
-  UI.append() # .append() adds the named item to the end of the EditableCombobox.
-
-# How to build a menu-interface (menu tag):
-
-  help_menu = UI.new_menu('Help')
-  version_item = UI.menu_append_item(help_menu, 'Version')
-

data/lib/libui_paradise/extensions/counters.rb

@@ -1,58 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'libui_paradise/extensions/counters.rb
-# =========================================================================== #
-module LibuiParadise
-
-# =========================================================================== #
-# === @counter_left
-# =========================================================================== #
-@counter_left = 0
-
-# =========================================================================== #
-# === LibuiParadise.counter_left?
-# =========================================================================== #
-def self.counter_left?
-  @counter_left
-end; self.instance_eval { alias counter_left  counter_left? } # === LibuiParadise.counter_left
-     self.instance_eval { alias left_counter  counter_left? } # === LibuiParadise.left_counter
-     self.instance_eval { alias left_counter? counter_left? } # === LibuiParadise.left_counter?
-
-# =========================================================================== #
-# === LibuiParadise.counter_left=
-# =========================================================================== #
-def self.counter_left=(i = 1)
-  @counter_left = i
-end
-
-# =========================================================================== #
-# === @counter_top
-# =========================================================================== #
-@counter_top = 0
-
-# =========================================================================== #
-# === LibuiParadise.counter_top?
-# =========================================================================== #
-def self.counter_top?
-  @counter_top
-end; self.instance_eval { alias counter_top  counter_top? } # === LibuiParadise.counter_top
-     self.instance_eval { alias top_counter  counter_top? } # === LibuiParadise.top_counter
-     self.instance_eval { alias top_counter? counter_top? } # === LibuiParadise.top_counter?
-
-# =========================================================================== #
-# === LibuiParadise.counter_top=
-# =========================================================================== #
-def self.counter_top=(i = 1)
-  @counter_top = i
-end
-
-# =========================================================================== #
-# === LibuiParadise.counters?
-# =========================================================================== #
-def self.counters?
-  return [@counter_left, @counter_top]
-end
-
-end

data/lib/libui_paradise/extensions/extensions.rb

@@ -1,29 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === LibuiParadise::Extensions
-#
-# This .rb file is primarly used to "extend" libui in a convenient
-# way. That way we only have to require this file and the rest will
-# be set up correctly for us.
-# =========================================================================== #
-# require 'libui_paradise/extensions/extensions.rb
-# include Libuiparadise::Extensions
-# =========================================================================== #
-require 'libui' # Mandatory require-call.
-
-module LibuiParadise
-
-module Extensions # === LibuiParadise::Extensions
-
-  require 'libui_paradise/fiddle/pointer.rb'
-  require 'libui_paradise/extensions/hash_fiddle_pointer_widgets.rb'
-  require 'libui_paradise/extensions/misc.rb'
-  require 'libui_paradise/libui_classes/libui_classes.rb'
-
-end; end
-
-alias e puts
-
-LibuiParadise::Extensions.initializer # Make UI known here.

data/lib/libui_paradise/extensions/hash_fiddle_pointer_widgets.rb

@@ -1,150 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'libui_paradise/extensions/hash_fiddle_pointer_widgets.rb'
-# =========================================================================== #
-module LibuiParadise
-
-module Extensions # === LibuiParadise::Extensions
-
-  # ========================================================================= #
-  # === @hash_fiddle_pointer_widgets
-  #
-  # This hash will contain all widgets, via pointer.
-  # ========================================================================= #
-  @hash_fiddle_pointer_widgets = {}
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-  # ========================================================================= # 
-  def self.hash_fiddle_pointer_widgets?
-    @hash_fiddle_pointer_widgets
-  end
-
-  # ========================================================================= #
-  # === main_hash?
-  #
-  # Access the main hash defined above.
-  # ========================================================================= #
-  def main_hash?
-    ::LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-  end; alias toplevel_hash? main_hash? # === toplevel_hash?
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.register_this_fiddle_pointer_widget
-  #
-  # This method registers the particular widget in use.
-  #
-  # Every new_* method available via LibUI.new* that creates a new widget
-  # has to be registered via this method here, by calling it.
-  #
-  # That way we have a main Hash that contains lots of Fiddle::Pointers
-  # and we can, at a later time, modify these Fiddle::Pointer or call
-  # toplevel methods with these registered pointers. This will only
-  # work if we have registered these pointers, though, which is why
-  # each method that creates a new libui-widget has to make use of
-  # this method here.
-  #
-  # The only exception to the above rule is the main window. The
-  # main window is always stored in the @main_window variable instead.
-  #
-  # Perhaps it should also use the method here, but I found it simpler
-  # to just refer to it via @main_window or main_window?. (Note that
-  # in future releases of the libui_paradise gem, @main_window will
-  # probably be removed and integrated just like any other
-  # libui-widget. But this has not been done yet, so it is retained
-  # as-is right now.)
-  #
-  # The mandatory entries given to this method must be of the
-  # following format:
-  #
-  #   object_id -> [:the_fiddle_pointer_widget, :the_type]
-  #
-  # In other words, a key (as an Integer), and an Array as
-  # its primary value.
-  #
-  # The object_id will be determined automatically, so it can
-  # be omitted. It is the value that is simply returned by
-  # calling the .object_id method, so we do not have to do
-  # anything else here.
-  #
-  # The very last argument of the two-member Array should be a
-  # symbol, such as :grid. This is automatically ensured via a
-  # call to __method__ which returns a Symbol. That way we can
-  # then call the correct method internally, once we know we
-  # have a :grid or any other widget.
-  # ========================================================================= #
-  def self.register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget = nil
-    )
-    # ======================================================================= #
-    # Determine the object-id automatically next:
-    # ======================================================================= #
-    object_id_to_use = the_fiddle_pointer_widget.object_id
-    # ======================================================================= #
-    # Then, store it on the main Hash.
-    # ======================================================================= #
-    @hash_fiddle_pointer_widgets[object_id_to_use] =
-      [
-        the_fiddle_pointer_widget,
-        the_type_of_the_widget
-      ]
-  end; self.instance_eval { alias add_to_the_registered_widgets register_this_fiddle_pointer_widget } # === LibuiParadise::Extensions.add_to_the_registered_widgets
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.current_widget_pointer?
-  # ========================================================================= #
-  def self.current_widget_pointer?
-    LibuiParadise::Extensions.hash_fiddle_pointer_widgets?.values.last.first
-  end
-
-  # ========================================================================= #
-  # === last_pointer?
-  #
-  # This used to return the "current" widget pointer, but past September
-  # 2021 this is rarely in use anymore. Use current_widget_pointer? 
-  # instead, based on the main Hash that keeps all widgets registered.
-  # ========================================================================= #
-  def last_pointer?
-    LibuiParadise::Extensions.current_widget_pointer?
-  end; alias current_pointer?        last_pointer? # === current_pointer?
-       alias current_widget_pointer? last_pointer? # === current_widget_pointer?
-
-  # ========================================================================= #
-  # === current_widget_pointer_type?
-  # ========================================================================= #
-  def current_widget_pointer_type?
-    LibuiParadise::Extensions.hash_fiddle_pointer_widgets?.values.last.last
-  end
-
-  # ========================================================================= #
-  # === register_this_fiddle_pointer_widget
-  # ========================================================================= #
-  def register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget = nil
-    )
-    ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget
-    )
-  end; alias add_to_the_registered_widgets register_this_fiddle_pointer_widget # === add_to_the_registered_widgets
-
-end
-
-# ========================================================================= #
-# === LibuiParadise.register_this_fiddle_pointer_widget
-# ========================================================================= #
-def self.register_this_fiddle_pointer_widget(
-    the_fiddle_pointer_widget,
-    the_type_of_the_widget = nil
-  )
-  ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(
-    the_fiddle_pointer_widget,
-    the_type_of_the_widget
-  )
-end; self.instance_eval { alias add_to_the_registered_widgets register_this_fiddle_pointer_widget } # === LibuiParadise.add_to_the_registered_widgets
-
-end