glimmer-dsl-libui VS rubio-radio

glimmer-dsl-libui is a more actively maintained alternative

https://github.com/AndyObtiva/glimmer-dsl-libui

Another GitHub Pull Request for Rubio-Radio (open-source Internet radio app built with Ruby) got accepted and merged, which focused on displaying the currently playing song/program, loading all available radio stations (instead of a pre-defined limit), and enhanced full-text-search support including column-specific queries. The changes have been released in rubio-radio gem version 0.0.6. In fact, the enhanced full-text-search support is included in the latest version of Glimmer DSL for LibUI (Ruby Desktop Development GUI Library used to build Rubio-Radio) as part of the refined_table custom control for use in any projects, so software engineers get that feature for free now.

Recently, I blogged about how I contributed Pagination/Filtering support to Rubio-Radio, an Internet radio application built with Ruby and Glimmer DSL for LibUI.

I am particularly impressed by the fact that the developers of those apps fully went the distance by walking the walk, not just talking the talk, especially given that the developers of the first app (RubyCrumbler) were brand new to Glimmer DSL for LibUI and had to exercise great problem solving skills to finish their app on time for their needs.

# From: https://github.com/AndyObtiva/glimmer-dsl-libui#shape-coloring require 'glimmer-dsl-libui' class ShapeColoring include Glimmer::LibUI::Application COLOR_SELECTION = Glimmer::LibUI.interpret_color(:red) before_body { @shapes = [] } body { window('Shape Coloring', 200, 200) { margined false grid { label("Click a shape to select and\nchange color via color button") { left 0 top 0 hexpand true halign :center vexpand false } color_button { |cb| left 0 top 1 hexpand true vexpand false on_changed do @selected_shape&.fill = cb.color end } area { left 0 top 2 hexpand true vexpand true rectangle(0, 0, 600, 400) { # background shape fill :white } @shapes << colorable(:rectangle, 20, 20, 40, 20) { |shape| fill :lime } @shapes << colorable(:square, 80, 20, 20) { |shape| fill :blue } @shapes << colorable(:circle, 75, 70, 20, 20) { |shape| fill :green } @shapes << colorable(:arc, 120, 70, 40, 0, 145) { |shape| fill :orange } @shapes << colorable(:polygon, 120, 10, 120, 50, 150, 10, 150, 50) { fill :cyan } @shapes << colorable(:polybezier, 20, 40, 30, 100, 50, 80, 80, 110, 40, 120, 20, 120, 30, 91) { fill :pink } } } } } def colorable(shape_symbol, *args, &content) send(shape_symbol, *args) do |shape| on_mouse_up do |area_mouse_event| old_stroke = Glimmer::LibUI.interpret_color(shape.stroke).slice(:r, :g, :b) @shapes.each {|sh| sh.stroke = nil} @selected_shape = nil unless old_stroke == COLOR_SELECTION shape.stroke = COLOR_SELECTION.merge(thickness: 2) @selected_shape = shape end end content.call(shape) end end end ShapeColoring.launch

# From: https://github.com/AndyObtiva/glimmer-dsl-libui#class-based-custom-controls require 'glimmer-dsl-libui' require 'facets' Address = Struct.new(:street, :p_o_box, :city, :state, :zip_code) class FormField include Glimmer::LibUI::CustomControl options :model, :attribute body { entry { |e| label attribute.to_s.underscore.split('_').map(&:capitalize).join(' ') text <=> [model, attribute] } } end class AddressForm include Glimmer::LibUI::CustomControl options :address body { form { form_field(model: address, attribute: :street) form_field(model: address, attribute: :p_o_box) form_field(model: address, attribute: :city) form_field(model: address, attribute: :state) form_field(model: address, attribute: :zip_code) } } end class LabelPair include Glimmer::LibUI::CustomControl options :model, :attribute, :value body { horizontal_box { label(attribute.to_s.underscore.split('_').map(&:capitalize).join(' ')) label(value.to_s) { text <= [model, attribute] } } } end class AddressView include Glimmer::LibUI::CustomControl options :address body { vertical_box { address.each_pair do |attribute, value| label_pair(model: address, attribute: attribute, value: value) end } } end class ClassBasedCustomControls include Glimmer::LibUI::Application # alias: Glimmer::LibUI::CustomWindow before_body do @address1 = Address.new('123 Main St', '23923', 'Denver', 'Colorado', '80014') @address2 = Address.new('2038 Park Ave', '83272', 'Boston', 'Massachusetts', '02101') end body { window('Class-Based Custom Keyword') { margined true horizontal_box { vertical_box { label('Address 1') { stretchy false } address_form(address: @address1) horizontal_separator { stretchy false } label('Address 1 (Saved)') { stretchy false } address_view(address: @address1) } vertical_separator { stretchy false } vertical_box { label('Address 2') { stretchy false } address_form(address: @address2) horizontal_separator { stretchy false } label('Address 2 (Saved)') { stretchy false } address_view(address: @address2) } } } } end ClassBasedCustomControls.launch

Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library): this gem just won a 2022 Fukuoka Ruby Special Award after getting judged directly by Matz (creator of Ruby) and the Fukuoka Ruby Award Competition Judges! How is that for a Year of The Ruby Desktop accomplishment!!?!

Another reason why this library was created was to address the need for supporting automated declarative drag and drop features in Glimmer DSL for LibUI coming soon (right now, it supports manually implementing drag and drop with area listeners out of the box).

Another GitHub Pull Request for Rubio-Radio (open-source Internet radio app built with Ruby) got accepted and merged, which focused on displaying the currently playing song/program, loading all available radio stations (instead of a pre-defined limit), and enhanced full-text-search support including column-specific queries. The changes have been released in rubio-radio gem version 0.0.6. In fact, the enhanced full-text-search support is included in the latest version of Glimmer DSL for LibUI (Ruby Desktop Development GUI Library used to build Rubio-Radio) as part of the refined_table custom control for use in any projects, so software engineers get that feature for free now.

# frozen_string_literal: true # From: https://github.com/kojix2/rubio-radio/tree/v0.0.5 require 'glimmer-dsl-libui' require_relative '../model/radio_browser' require_relative '../model/player' module Rubio module View class Radio include Glimmer::LibUI::Application options :backend, :initial_width, :initial_height option :radio_station_count, default: 10_000 option :debug, default: false option :show_menu, default: true option :show_page_count, default: false option :show_bookmarks, default: true option :gradually_fetch_stations, default: true option :table_per_page, default: 20 attr_reader :stations, :player attr_accessor :current_station, :view before_body do @loaded_station_count = [gradually_fetch_stations ? 100 : radio_station_count, radio_station_count].min @loaded_station_offset = 0 @stations = Model::RadioBrowser.topvote(@loaded_station_count, offset: @loaded_station_offset) @player = Model::Player.new(backend) @initial_width = (initial_width || (show_bookmarks ? 740 : 620)).to_i @initial_height = (initial_height || calculate_initial_height).to_i @view = :all end after_body do monitor_thread(debug) async_fetch_stations if gradually_fetch_stations && @stations.count < radio_station_count end body do radio_menu_bar window('Rubio', @initial_width, @initial_height) do vertical_box do horizontal_box do @station_table = refined_table( table_columns: station_table_columns, model_array: stations, per_page: table_per_page.to_i, visible_page_count: show_page_count ) end end on_closing do @player.stop_all end end end def radio_menu_bar return unless OS.mac? || show_menu radio_menu view_menu help_menu end def radio_menu menu('Radio') do menu_item('Stop') do enabled <= [self, 'current_station', { on_read: ->(value) { !!value } }] on_clicked do stop_station end end separator_menu_item menu_item('Bookmark') do enabled <= [self, 'current_station.bookmarked', { on_read: :! }] on_clicked do toggle_bookmarked_station(current_station) if current_station end end menu_item('Unbookmark') do enabled <= [self, 'current_station.bookmarked'] on_clicked do toggle_bookmarked_station(current_station) if current_station end end separator_menu_item if OS.mac? about_menu_item do on_clicked do about_message_box end end end quit_menu_item do on_clicked do @player.stop_all end end end end def view_menu menu('View') do radio_menu_item('All') do checked <=> [self, :view, { on_read: ->(value) { value == :all }, on_write: ->(_value) { :all } }] on_clicked do view_all end end radio_menu_item('Bookmarks') do checked <=> [self, :view, { on_read: ->(value) { value == :bookmarks }, on_write: ->(_value) { :bookmarks } }] on_clicked do view_bookmarks end end radio_menu_item('Playing') do checked <=> [self, :view, { on_read: ->(value) { value == :playing }, on_write: ->(_value) { :playing } }] on_clicked do view_playing end end separator_menu_item if OS.mac? end end def help_menu menu('Help') do menu_item('About') do on_clicked do about_message_box end end end end def station_table_columns table_columns = { 'Play' => { button: { on_clicked: lambda { |row| station = @station_table.refined_model_array[row] select_station(station) } } } } if show_bookmarks table_columns.merge!( 'Bookmark' => { button: { on_clicked: lambda { |row| station = @station_table.refined_model_array[row] toggle_bookmarked_station(station) } } } ) end table_columns.merge!( 'name' => :text, 'language' => :text ) end def about_message_box license = begin File.read(File.expand_path('../../../LICENSE.txt', __dir__)) rescue StandardError '' end product = "rubio-radio #{Rubio::VERSION}" message_box(product, "#{product}\n\n#{license}") end def select_station(station) playing = station.playing? stop_station self.current_station = station if playing self.current_station = nil else play_station end end def toggle_bookmarked_station(station) station.bookmarked = !station.bookmarked? view_bookmarks if view == :bookmarks && !station.bookmarked end def play_station @player.play(current_station.url) current_station.playing = true rescue StandardError => e message_box(e.message) self.current_station = nil end def stop_station return if current_station.nil? @player.stop current_station.playing = false self.current_station = nil end def view_all @station_table.model_array = stations end def view_bookmarks @station_table.model_array = stations.select(&:bookmarked?) end def view_playing @station_table.model_array = stations.select(&:playing?) end def refresh_view case view when :all view_all when :bookmarks view_bookmarks when :playing view_playing end end private def calculate_initial_height if OS.linux? 107 + (show_menu ? 26 : 0) + 24 * table_per_page.to_i elsif OS.mac? && OS.host_cpu == 'arm64' 90 + 24 * table_per_page.to_i elsif OS.mac? 85 + 19 * table_per_page.to_i else # Windows 95 + 19 * table_per_page.to_i end end def monitor_thread(debug) Glimmer::LibUI.timer(1) do p @player.history if debug next if current_station.nil? || @player.alive? message_box("player '#{@player.backend}' stopped!", @player.thr.to_s) stop_station true end end def async_fetch_stations @loaded_station_offset += @loaded_station_count @loaded_station_count *= 2 Thread.new do new_station_count = [@loaded_station_count, radio_station_count - @loaded_station_offset].min @stations += Model::RadioBrowser.topvote(new_station_count, offset: @loaded_station_offset) Glimmer::LibUI.queue_main do refresh_view async_fetch_stations if @stations.count < radio_station_count end end end end end end

Last but not least, the new refined_table custom control has been used in the Rubio Radio application to enable browsing 10,000 top radio stations with excellent performance and usability.