swing_paradise 0.0.15

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0fde3c447e09283a11f783c60e85864db52904733b980bd82f426690d6465118
+  data.tar.gz: 47e4b6fdf29fc5ab13c5b6d454861ee9298d375cdec1447d0e46475fd68b51e0
+SHA512:
+  metadata.gz: 459c55e39c0d28eb94d95d653b742bdcb92f502c37ab1e642be0fa4a3db29d4c0178bf3a6e9e3d50994b3a353853f672a1068e9d7cc7028f249be45fb34d1d26
+  data.tar.gz: d78e0207bd49bacb30cc01c0d74c0c8e4a8ee97f30bdbfa492cde1b34465a7536e76e67c7c700f9966ced6107f798830e32bb1520225b0ccf73bcc9624474a8f

data/README.md

@@ -0,0 +1,19 @@
+## Goals of this project
+
+This project contains some add-on bindings to jruby Swing.
+
+It is thus only really useful for jruby; and even there it
+is very incomplete. Mega-beta quality, at best. I do not
+recommend anyone to use this project as of yet.
+
+## Simplified quitting
+
+Use the following method to quit easily:
+
+    do_quit
+
+For instance, a quit button:
+
+    quit_button.on_clicked {
+      do_quit
+    }

data/doc/README.gen

@@ -0,0 +1,19 @@
+## Goals of this project
+
+This project contains some add-on bindings to jruby Swing.
+
+It is thus only really useful for jruby; and even there it
+is very incomplete. Mega-beta quality, at best. I do not
+recommend anyone to use this project as of yet.
+
+## Simplified quitting
+
+Use the following method to quit easily:
+
+    do_quit
+
+For instance, a quit button:
+
+    quit_button.on_clicked {
+      do_quit
+    }

data/lib/swing_paradise/autoinclude.rb

@@ -0,0 +1,3 @@
+require 'swing_paradise/requires/require_the_project.rb'
+
+include SwingParadise

data/lib/swing_paradise/examples/001_quit_button_example.rb

@@ -0,0 +1,54 @@
+include Java
+
+java_import javax.swing.JButton
+java_import javax.swing.JFrame
+java_import javax.swing.JLabel
+java_import javax.swing.JPanel
+java_import javax.swing.JTextArea
+java_import javax.swing.JScrollBar
+java_import javax.swing.JTextField
+java_import javax.swing.JSpinner
+java_import javax.swing.SpinnerNumberModel
+java_import java.lang.System
+java_import java.awt.Font
+
+module SwingParadise
+
+class QuitButtonExample < JFrame
+
+  require 'swing_paradise'
+  include SwingParadise
+ 
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    frame = JFrame.new('A quit button example')
+    panel = JPanel.new # This is an instance of Java::JavaxSwing::JPanel.
+    panel.set_font(Font.new 'Sans serif', Font::PLAIN, 25)
+    frame.getContentPane.add(panel)
+    panel.setLayout(nil)
+    panel.hint = 'A quit button example'
+    _ = quit_button
+    _.setBounds(10, 20, 200, 40)
+    panel << _
+    frame.setDefaultCloseOperation JFrame::EXIT_ON_CLOSE
+    frame.setSize(600, 500)
+    frame.setLocationRelativeTo(nil)
+    frame.show_all
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  SwingParadise::QuitButtonExample.new
+end

data/lib/swing_paradise/jbutton/jbutton.rb

@@ -0,0 +1,46 @@
+# =========================================================================== #
+# require 'swing_paradise/jbutton/jbutton.rb'
+# =========================================================================== #
+class Java::JavaxSwing::JButton
+
+  # ========================================================================= #
+  # Enable: panel.hint=
+  # ========================================================================= #
+  alias hint= setToolTipText
+
+  alias on_clicked add_action_listener
+
+  # ========================================================================= #
+  # === on_event
+  # ========================================================================= #
+  alias on_event add_action_listener
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  alias use_this_font= setFont
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+end

data/lib/swing_paradise/jcombobox/jcombobox.rb

@@ -0,0 +1,28 @@
+class Java::JavaxSwing::JComboBox
+
+  alias text? getSelectedItem # === text?
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+ 
+end

data/lib/swing_paradise/jframe/jframe.rb

@@ -0,0 +1,61 @@
+class Java::JavaxSwing::JFrame
+
+  java_import java.awt.Dimension
+
+  # ========================================================================= #
+  # === is_resizable
+  # ========================================================================= #
+  def is_resizable
+    JFrame.setResizable(true)
+  end
+
+  # ========================================================================= #
+  # === is_not_resizable
+  # ========================================================================= #
+  def is_not_resizable
+    JFrame.setResizable(false)
+  end
+
+  # ========================================================================= #
+  # === set_width
+  # ========================================================================= #
+  def set_width(i)
+    i = i.to_i
+    setPreferredSize(
+      java.awt.Dimension.new(i, -1)
+    )
+  end
+
+  # ========================================================================= #
+  # === show_all
+  # ========================================================================= #
+  def show_all
+    setVisible(true)
+  end
+
+  # ========================================================================= #
+  # === width_height
+  # ========================================================================= #
+  def width_height(
+      width = 1024,
+      height = 800
+    )
+    if width.is_a? String # This can be like this: '62% or minimum 300px'
+      if width.include? 'px'
+        scanned = width.scan(/(\d{1,}px)/)
+        width = scanned.flatten.first.delete('px')
+      end
+    end
+    if height.is_a? String # This can be like this: '62% or minimum 300px'
+      if height.include? 'px'
+        height = height.scan(/\d{1,}px/).flatten.first.delete('px')
+      end
+    end
+    width  = width.to_i
+    height = height.to_i
+    setSize(width, height)
+    # The next variant does not appear to work that well:
+    #  setPreferredSize(Dimension.new(width, height))
+  end
+
+end

data/lib/swing_paradise/jlabel/jlabel.rb

@@ -0,0 +1,31 @@
+class Java::JavaxSwing::JLabel
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  alias use_this_font= setFont
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+end

data/lib/swing_paradise/jpanel/jpanel.rb

@@ -0,0 +1,37 @@
+java_import java.awt.Font
+
+class Java::JavaxSwing::JPanel
+
+  # ========================================================================= #
+  # Enable: panel.hint=
+  # ========================================================================= #
+  alias hint= setToolTipText
+
+  # ========================================================================= #
+  # Add << as alias to .add() next:
+  # ========================================================================= #
+  alias << add
+
+  # ========================================================================= #
+  # === font=
+  #
+  # This could be invoked like so:
+  #
+  #   panel.font = :sans_serif_25
+  #
+  # It presently does not work, though.
+  # ========================================================================= #
+  # def font=(i)
+  #   font_to_use  = 'Sans serif'
+  #   font_variant = Font::PLAIN # Font is actually Java::JavaAwt::Font
+  #   font_size    = 25
+  #   if i.is_a? Symbol
+  #     splitted = i.to_s.tr('_',' ').split(' ')
+  #     font_size = splitted.pop
+  #     font_to_use = splitted.join(' ')
+  #     font_to_use[0, 1] = font_to_use[0, 1].upcase
+  #   end
+  #   set_font(Font.new(font_to_use), font_variant, font_size)
+  # end
+
+end

data/lib/swing_paradise/jscrollpane/jscrollpane.rb

@@ -0,0 +1,34 @@
+# =========================================================================== #
+# require 'swing_paradise/jscrollpane/jscrollpane.rb'
+# =========================================================================== #
+class Java::JavaxSwing::JScrollPane
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  alias use_this_font= setFont
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+end

data/lib/swing_paradise/jspinner/jspinner.rb

@@ -0,0 +1,10 @@
+class Java::JavaxSwing::JSpinner
+
+  # ========================================================================= #
+  # === text?
+  # ========================================================================= #
+  def text?
+    getValue.to_s
+  end
+
+end

data/lib/swing_paradise/jtextarea/jtextarea.rb

@@ -0,0 +1,34 @@
+# =========================================================================== #
+# require 'swing_paradise/jtextarea/jtextarea.rb'
+# =========================================================================== #
+class Java::JavaxSwing::JTextArea
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  alias use_this_font= setFont
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+end

data/lib/swing_paradise/jtextfield/jtextfield.rb

@@ -0,0 +1,31 @@
+class Java::JavaxSwing::JTextField
+
+  # ========================================================================= #
+  # === enable_dragging
+  # ========================================================================= #
+  def enable_dragging
+    setDragEnabled(true)
+  end
+
+  # ========================================================================= #
+  # === text?
+  # ========================================================================= #
+  def text?
+    getText.to_s
+  end
+
+  # ========================================================================= #
+  # === on_enter_pressed
+  # ========================================================================= #
+  def on_enter_pressed(&block)
+    add_action_listener(&block)
+  end
+
+  # ========================================================================= #
+  # === center
+  # ========================================================================= #
+  def center
+    setHorizontalAlignment(JTextField::CENTER)
+  end
+
+end

data/lib/swing_paradise/misc/misc.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'swing_paradise/misc/misc.rb'
+# =========================================================================== #
+module SwingParadise
+
+  # ========================================================================= #
+  # === jframe
+  # ========================================================================= #
+  def jframe(i = '')
+    JFrame.new(i)
+  end; alias frame jframe # === frame
+
+  # ========================================================================= #
+  # === entry
+  #
+  # This is simply a wrapper over JTextField.
+  # ========================================================================= #
+  def entry(i = '')
+    JTextField.new(i)
+  end; alias hcentered_entry entry # === hcentered_entry
+       alias create_entry    entry # === create_entry
+
+  # ========================================================================= #
+  # === quit_button
+  # ========================================================================= #
+  def quit_button(
+      use_this_text = 'Quit'
+    )
+    _ = button(use_this_text)
+    _.on_clicked { do_quit }
+    return _
+  end
+
+end

data/lib/swing_paradise/requires/require_the_project.rb

@@ -0,0 +1,15 @@
+# =========================================================================== #
+# require 'swing_paradise/requires/require_the_project.rb'
+# =========================================================================== #
+require 'swing_paradise/toplevel_methods/misc.rb'
+require 'swing_paradise/jbutton/jbutton.rb'
+require 'swing_paradise/jcombobox/jcombobox.rb'
+require 'swing_paradise/jpanel/jpanel.rb'
+require 'swing_paradise/jframe/jframe.rb'
+require 'swing_paradise/jtextfield/jtextfield.rb'
+require 'swing_paradise/jspinner/jspinner.rb'
+require 'swing_paradise/jtextarea/jtextarea.rb'
+require 'swing_paradise/jlabel/jlabel.rb'
+require 'swing_paradise/jscrollpane/jscrollpane.rb'
+
+require 'swing_paradise/misc/misc.rb'

data/lib/swing_paradise/toplevel_methods/misc.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'swing_paradise/toplevel_methods/misc.rb'
+# include SwingParadise
+# =========================================================================== #
+module SwingParadise
+
+  # ========================================================================= #
+  # === swing_dimension
+  #
+  # This is a slight wrapper over java.awt.Dimension.
+  # ========================================================================= #
+  def swing_dimension(new_width, new_height)
+    java.awt.Dimension.new(new_width, new_height)
+  end
+
+  # ========================================================================= #
+  # === do_quit
+  #
+  # This method can be used as a more convenient do-exit method.
+  # ========================================================================= #
+  def do_quit(
+      use_this_as_the_exit_code = 0
+    )
+    System.exit(use_this_as_the_exit_code)
+  end
+
+  # ========================================================================= #
+  # === SwingParadise.text
+  #
+  # This method will return a JLabel instance.
+  # ========================================================================= #
+  def self.text(i = '')
+    _ = JLabel.new(i)
+    return _
+  end; self.instance_eval { alias label text } # === SwingParadise.label
+
+  # ========================================================================= #
+  # === jbutton
+  # ========================================================================= #
+  def jbutton(i = '')
+    return JButton.new(i)
+  end; alias button jbutton # === button
+
+  # ========================================================================= #
+  # === jcombobox
+  # ========================================================================= #
+  def jcombobox(i = nil)
+    combo_box = JComboBox.new
+    if i and i.respond_to?(:each)
+      i.each {|this_exam_topic|
+        combo_box.addItem(this_exam_topic)
+      }
+    end
+    return combo_box
+  end
+
+  # ========================================================================= #
+  # === default_close
+  # ========================================================================= #
+  def default_close
+    setDefaultCloseOperation(JFrame::EXIT_ON_CLOSE)
+  end
+
+  # ========================================================================= #
+  # === jpanel
+  # ========================================================================= #
+  def jpanel
+    JPanel.new
+  end
+
+  # ========================================================================= #
+  # === jtextarea
+  # ========================================================================= #
+  def jtextarea
+    JTextArea.new
+  end
+
+  # ========================================================================= #
+  # === text
+  # ========================================================================= #
+  def text(i = '')
+    return JLabel.new(i)
+  end; alias jtext text # === jtext
+
+  # ========================================================================= #
+  # === show_message_dialog
+  # ========================================================================= #
+  def show_message_dialog(text = '')
+    javax.swing.JOptionPane.showMessageDialog(nil, text)
+  end
+
+  # ========================================================================= #
+  # === quit_button
+  #
+  # This method can be used to quickly create a quit-button.
+  # ========================================================================= #
+  def quit_button
+    _ = jbutton('Quit')
+    _.on_event {|event|
+      System.exit(0)
+    }
+    return _
+  end
+
+end

data/lib/swing_paradise/version/version.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module SwingParadise
+
+  # ========================================================================= #
+  # === VERSION
+  # ========================================================================= #
+  VERSION = '0.0.15'
+
+  # ========================================================================= #
+  # === LAST_UPDATE
+  # ========================================================================= #
+  LAST_UDPATE = '24.09.2022'
+
+end

data/lib/swing_paradise.rb

@@ -0,0 +1 @@
+require 'swing_paradise/requires/require_the_project.rb'

data/swing_paradise.gemspec

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'yaml'
+require 'swing_paradise/version/version.rb'
+require 'roebe'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'swing_paradise'
+  s.version = SwingParadise::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF
+
+This gem is meant for jruby only.
+
+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/rbt/'
+  s.require_paths = ['lib']
+
+  s.required_ruby_version     = '>= '+Roebe.third_most_stable_version_of_ruby
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+}

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: swing_paradise
+version: !ruby/object:Gem::Version
+  version: 0.0.15
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-09-24 00:00:00.000000000 Z
+dependencies: []
+description: |2+
+
+  This gem is meant for jruby only.
+
+email: shevy@inbox.lt
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- doc/README.gen
+- lib/swing_paradise.rb
+- lib/swing_paradise/autoinclude.rb
+- lib/swing_paradise/examples/001_quit_button_example.rb
+- lib/swing_paradise/jbutton/jbutton.rb
+- lib/swing_paradise/jcombobox/jcombobox.rb
+- lib/swing_paradise/jframe/jframe.rb
+- lib/swing_paradise/jlabel/jlabel.rb
+- lib/swing_paradise/jpanel/jpanel.rb
+- lib/swing_paradise/jscrollpane/jscrollpane.rb
+- lib/swing_paradise/jspinner/jspinner.rb
+- lib/swing_paradise/jtextarea/jtextarea.rb
+- lib/swing_paradise/jtextfield/jtextfield.rb
+- lib/swing_paradise/misc/misc.rb
+- lib/swing_paradise/requires/require_the_project.rb
+- lib/swing_paradise/toplevel_methods/misc.rb
+- lib/swing_paradise/version/version.rb
+- swing_paradise.gemspec
+homepage: https://www.rubydoc.info/gems/rbt/
+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.22
+requirements: []
+rubygems_version: 3.3.22
+signing_key:
+specification_version: 4
+summary: This gem is meant for jruby only.
+test_files: []
+...