tk_paradise 0.0.11

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 57e4a8df5ba60f4d91f8ca5ca47e5479a291f6234be90a1396f4e4b29c1712b3
+  data.tar.gz: eb0d691e920529f48a61ec739b1f63ca89e8b5adfb0518aaed788d45734c784d
+SHA512:
+  metadata.gz: 30453d6c0479e4b51ca533e4b00c440eab792b01eb760545faf081bb1d00fd2fa6499508c8f84f6fb2fc216de6bc92cc84315af795e4129e68e2c94ecca17b62
+  data.tar.gz: 055f4da45f19d7d51bc5a39c2b0f20ff090b33ec7e75d686540e26b8259b241c6e386ba196b9d61f09b1681a8101c2bead8e2157a35532a8ec4ff340af5f8e28

data/doc/HINTS.md

@@ -0,0 +1,318 @@
+ADD_RUBY_BADGE
+ADD_TIME_STAMP
+
+Specify width, height, then x-coordinate, then y-coordinate:
+
+  root.geometry('800x600+0+0')
+  root.geometry('250x150+0+0')
+  root.geometry("500x100") # Just width x height
+  root.geometry("800x500") # Just width x height
+  root.geometry("+300+300") # And this will only specify the x and y coordinates
+
+Create a new root entry:
+
+  TITLE = 'This is my widget'
+  root = TkRoot.new { title TITLE }
+
+Set the title of the root widget at a later point:
+
+  root.title('YO')
+
+Set a minimal size of the root widget:
+
+  root.minsize(400, 200)
+
+Make the root window invisible (so that e. g. only the menubar shows up):
+
+  root.withdraw
+
+Disallow the root window from being resized:
+
+  Tk.root.resizable(false, false) # boolean value: (width, height)
+
+Obtain the value of an entry:
+
+  use .get
+
+Delete the content of an entry:
+
+  entry.delete(0,'end') # Weird that 'end' is used there.
+
+Set the value of an entry:
+
+  entry.insert(0, _)
+
+  # Note that I was unable to get this to work: entry.configure(text: 'Hey there')
+
+Create an entry (entry tag):
+
+  @entry1 = TkEntry.new(outermost_frame, textvariable: @text1) {
+    font(MAIN_FONT)
+  }
+
+Set the width of an entry:
+
+  entry.configure(width: 35) # Oddly enough I have no idea what this number stands for. 
+
+Set the background colour of an entry:
+
+  background 'steelblue'
+  root.configure(background: 'black')
+
+Respond to key-events for entry:
+
+  entry.bind('Key', proc {|this_key|
+    e "This key was pressed: `#{this_key}`"
+  }, '%K')
+
+Change an entry dynamically:
+
+  label = TkLabel.new(top) {
+    text  'Hello, World!'
+  }
+  TkButton.new(top) {
+    text "Cancel"
+    command proc {
+      label.configure('text'=>"Goodbye, Cruel World!")
+    }
+    pack('side'=>'right', 'padx'=>10, 'pady'=>10)
+  }
+
+Now when the Cancel button is pressed, the text in the label 
+will change immediately from ``Hello, World!'' to ``Goodbye,
+Cruel World!'' 
+
+Create buttons:
+
+  Button.new(root, text: 'two')
+  TkButton.new(root, text: entry)
+  TkButton.new(root, text: 'is').grid("columnspan"=>3, "sticky"=>"ew")
+  TkButton.new(root, text: 'two').grid("row"=>1, "column"=>3, "columnspan"=>3)
+
+Button is-clicked event (clicked callback):
+
+  command proc {
+    e 'Hello.'
+  }
+
+Add the button to the main root:
+
+  button.pack
+
+Create a new grid:
+
+  TkGrid.grid(buttons[0], buttons[1], buttons[2], columnspan: 2 )
+
+Start the mainloop:
+
+  Tk.mainloop
+  Tk.run # Or this variant when the tk_paradise gem is used.
+
+Specify font size:
+
+  root.option_add('*Font', '25')
+
+Return the available fonts:
+
+  pp TkFont.names
+  # ["TkCaptionFont", "TkSmallCaptionFont", "TkTooltipFont",
+  #  "TkFixedFont", "TkHeadingFont", "TkMenuFont", "TkIconFont",
+  #  "TkTextFont", "TkDefaultFont"]
+
+  1 TkDefaultFont:      The default for all GUI items not otherwise specified.
+  2 TkTextFont:         Used for entry widgets, listboxes, etc.
+  3 TkFixedFont:        A standard fixed-width font.
+  4 TkMenuFont:         The font used for menu items.
+  5	TkHeadingFont:      The font typically used for column headings in lists and tables.
+  6 TkCaptionFont:      A font for window and dialog caption bars.
+  7 TkSmallCaptionFont: A smaller caption font for subwindows or tool dialogs
+  8 TkIconFont:         A font for icon captions.
+  9 TkTooltipFont:      A font for tooltips.
+
+Specify a font to use (font tag):
+
+  font = TkFont.new(family: 'Helvetica', size: 20, weight: 'bold')
+  TkLabel.new(root) { text 'Attention!'; font TkCaptionFont }
+
+  MONOSPACED_FONT = TkFont.new(family: 'Hack', size: 22, weight: 'bold')
+
+Create a new tk-variable:
+
+  text1 = TkVariable.new
+
+  Note that TkVariable implements #to_a, which can be used to convert
+  its value into an Array.
+
+How to create a label (text):
+
+  label = TkLabel.new(root)  {
+    textvariable
+    borderwidth 5
+    font use_this_font
+    foreground  'red' # The foreground colour to use.
+    relief      'groove'
+    pack(side: 'right', padx: '50', pady: '50')
+  }
+
+Draw on a canvas:
+
+  canvas = TkCanvas.new(root)
+
+Multiple spanning in a grid:
+
+   .grid(row: 1, column: 3, columnspan: 3)
+
+How to let the button perform an action:
+
+  button = Button.new(root, text: 'foobar) {
+    command proc {
+      puts 'I am saying '+::Colours.sfancy('hello world')+'!'
+    }
+  }
+
+Padding in tk:
+
+  Use padx and pady for a grid. Example:
+
+  .grid(row: 1, column: 3, columnspan: 3, padx: 5, pady: 5)
+        
+Pack a tk-label:
+
+  TkLabel.new(root) {
+    text 'Hello, World!'
+    pack { padx 25 ; pady 25; side 'left' }
+  }
+
+Make use of a scrollbar (scrollbar tag):
+
+  scrollbar = TkScrollbar.new(root).pack(side: :right, fill: :y)
+
+  command proc{|idx|
+    list.yview *idx
+  }
+
+Combo box widget:
+
+  list = TkListbox.new(frame).pack  
+  list.insert("end", "/home")
+  list.insert("end", "/etc/hosts")
+
+  Or alternatively:
+    n = TkVariable.new
+    combo_box = TkCombobox.new(
+      root,
+      width: 30,
+      font:  MONOSPACED_FONT,
+      textvariable: n
+    )
+    combo_box.values(%w(
+      aa bb cc dd ee ff gg hh ii jj kk ll mm nn oo pp qq rr ss tt uu
+    ))
+    combo_box.grid(column: 0, row: 6)
+
+How to select the current value of such a combo-box:
+
+  combo_box.current = 3 # This uses the fourth element.
+
+Query / Obtain values:
+
+  This is done via the method .cget().
+
+  b.cget('text')    # "OK"
+  b.cget('justify') # "left"
+  b.cget('border')  # 5
+
+Events in ruby-tk in general need to make use of .bind, in order
+to tie an event to a widget.
+
+mouse-over event:
+
+  image1 = TkPhotoImage.new { file "img1.gif" }
+  b = TkButton.new(@root) {
+    image    image1
+    command  proc { doit }
+  }
+  b.bind("Enter") { b.configure(image: image2) }
+  b.bind("Leave") { b.configure(image: image1) }
+
+The configure method (configure tag):
+
+  Every widget in tk supports the .configure() method.
+  button.configure(text: "Goodbye, Cruel World!") 
+ 
+Creating images (image tag, img tag):
+
+  image = TkPhotoImage.new(file: 'foobar.png', height: 82)
+
+Create some text:
+
+  text = TkText.new(root) { width 20; height 5 }.pack(side: :left)
+
+Append onto the text-widget:
+
+  text.insert('end', 'Left in canvas')
+
+Create a frame:
+
+  frame = TkFrame(root, highlightbackground: "black", 
+                        highlightthickness: 2,
+                        bd: 0)
+Add a button to that frame:
+
+  button = TkButton(frame, text: 'Submit', fg: 'black',
+                 bg: 'yellow', font: (("Times New Roman"),15))
+
+bttn.pack()
+
+Set the width of a border around a button:
+
+  borderwidth 3
+
+Set the style of a border:
+
+  Possible values include:
+
+    flat
+
+  Use it like this:
+
+    relief 'flat'
+    relief 'ridge'
+    relief 'sunken'
+
+How to use TkMessage:
+
+  TkMessage.new(root) {
+
+Start in the top left corner:
+
+  root.geometry('250x150+0+0')
+
+How to use an open-file dialog: 
+
+  Tk.getOpenFile
+
+How to create a spin-button in ruby-tk (also called a spin-box):
+
+  TkSpinbox.new(root) {
+     ...Standard Options...
+     ...Widget-specific Options...
+  }
+
+  Such as:
+
+  TkSpinbox.new(root) {
+    to 250
+    from 0
+    increment 5
+    pack(side: 'left', padx: '50', pady: '50')
+  }
+
+  To center it, use:
+
+  justify :center
+
+Useful links:
+
+  https://tkdocs.com/tutorial/text.html
+  https://www.tutorialspoint.com/ruby/ruby_tk_dialogbox.htm

data/lib/tk_paradise/base/base.rb

@@ -0,0 +1,63 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'tk_paradise/base/base.rb'
+# =========================================================================== #
+module Tk
+
+class Base # === Tk::Base
+
+  require 'colours'
+  include Colours
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i = ARGV
+    )
+    set_commandline_arguments(i)
+    reset
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @internal_hash
+    # ======================================================================= #
+    @internal_hash = {}
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+
+  # ========================================================================= #
+  # === tk_variable
+  # ========================================================================= #
+  def tk_variable
+    TkVariable.new
+  end
+
+end; end

data/lib/tk_paradise/examples/001_dialog_box_example.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk'
+
+root = TkRoot.new
+root.title = 'Window'
+root.geometry('800x600+0+0')
+button_click = Proc.new {
+  Tk.getOpenFile
+}
+
+button = TkButton.new(root) {
+  text 'button'
+  pack(side: :left, padx: "50", pady: "50")
+}
+
+button.command = button_click
+
+Tk.mainloop

data/lib/tk_paradise/examples/002_draw_tiny_box.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk'
+
+root = TkRoot.new { title 'Click to draw a tiny box' }
+TkLabel.new(root) { text 'Attention!'; font TkCaptionFont }
+canvas = TkCanvas.new(root)
+canvas.pack
+canvas.bind('1',  proc { |e| 
+  p "#{e.x}, #{e.y}"
+  TkcRectangle.new(canvas, e.x,e.y,e.x-5, e.y-5)
+})
+root.bind('Any-Key-d',  
+  proc { |event| 
+    p "#{event.x}, #{event.y}"
+    TkcRectangle.new(canvas, event.x, event.y, event.x-5, event.y-5)
+  }
+)
+Tk.mainloop
+# rb draw_tiny_box.rb

data/lib/tk_paradise/examples/003_fun_with_cursors.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk'
+root     = TkRoot.new { title 'Fun with Cursors'}
+# =========================================================================== #
+# Specify the Root Geometry
+# =========================================================================== #
+root.geometry '1250x1000+0+0'
+
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='box_spiral';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='center_ptr';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='circle';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='clock';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='coffee_mug';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='cross';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='cross_reverse';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='crosshair';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='diamond_cross';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='dot';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='dotbox';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='double_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='draft_large';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='draft_small';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='draped_box';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='exchange';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='bottom_side';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='hand2';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='heart';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='icon';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='iron_cross';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='left_ptr';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='left_side';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='left_tee';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='leftbutton';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='ll_angle';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='lr_angle';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='man';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='middlebutton';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='mouse';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='pencil';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='pirate';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='plus';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='question_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='right_ptr';text x;background 'green';cursor x}.pack('side'=>'bottom', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='right_side';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='right_tee';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='rightbutton';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='rtl_logo';text x;background 'green';cursor x}.pack('side'=>'bottom', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sailboat';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_down_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_h_double_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_left_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_right_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_up_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sb_v_double_arrow';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='shuttle';text x;background 'green';cursor x}.pack('side'=>'top', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='sizing';text x;background 'green';cursor x}.pack('side'=>'right', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='spider';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='spraycan';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='star';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='target';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='tcross';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='top_left_arrow';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='top_left_corner';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='top_right_corner';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='top_side';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='top_tee';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='trek';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='ul_angle';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='umbrella';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='ur_angle';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='watch';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+TkMessage.new(root) { x='xterm';text x;background 'green';cursor x}.pack('side'=>'left', padx: 4, 'padx'=>2)
+Tk.mainloop
+# rb fun_with_cursors.rb

data/lib/tk_paradise/examples/004_hello_world_example.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk_paradise'
+require 'colours/autoinclude'
+
+root = TkRoot.new() { title 'Hello, world!' }
+
+TkLabel.new(root) {
+  text 'Hello, World!'
+  pack { padx 25 ; pady 25; side 'left' }
+}
+# Add the hello world button next:
+button = TkButton.new(root) {
+  text 'Hello, World!'
+  command proc {
+    e 'I am saying '+sfancy('hello world')+'!'
+  }
+}
+button.pack
+Tk.mainloop

data/lib/tk_paradise/examples/005_key_press_event_example.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk'
+
+alias e puts
+
+USE_THIS_FONT = TkFont.new(family: 'Helvetica', size: 20, weight: 'bold')
+
+root = TkRoot.new
+root.geometry('800x600+0+0')
+entry = TkEntry.new(root) {
+  font USE_THIS_FONT
+  pack
+}
+entry.bind('Key', proc {|this_key|
+  e "This key was pressed: `#{this_key}`"
+}, '%K')
+
+Tk.mainloop

data/lib/tk_paradise/examples/006_multiple_buttons.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk'
+
+TITLE = 'Several buttons'  
+root = TkRoot.new { title TITLE }
+root.geometry('550x450+10+10')
+buttons = %w( one and one ).map { |entry|
+  TkButton.new(root, text: entry)
+}
+TkGrid.grid(buttons[0], buttons[1], buttons[2], columnspan: 2 )
+TkButton.new(root, text: 'is').grid(columnspan: 3, sticky: 'ew')
+TkButton.new(root, text: 'two', width: 50).grid("row"=>1, "column"=>3, "columnspan"=>3)
+Tk.mainloop

data/lib/tk_paradise/examples/007_packing_example_in_tk.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'tk_paradise'
+
+include Tk
+
+IMAGE = '/home/x/DATA/images/HUE2.gif'
+
+root = TkRoot.new() { title 'Packing Example' }
+
+button = TkButton.new(root) { text 'First, rightmost' }
+button.pack('side'=>'right', 'fill'=>'y')
+
+entry = TkEntry.new(root).pack('side'=>'top', 'fill'=>'x')
+entry.insert(0, 'Entry on the top')
+
+label = tk_label('to the right', root) { :on_right }
+
+our_image = tk_image(image, height: 50)
+img_label = TkLabel.new(root) { image(our_image) }.pack('anchor'=>'e')
+
+text = TkText.new(root) { width 20; height 5 }.pack('side'=>'left')
+text.insert('end', 'Left in canvas')
+
+tk_label('Message in the Bottom', root) { :on_bottom }
+Tk.run

data/lib/tk_paradise/examples/008_pig_latin_example.rb

@@ -0,0 +1,70 @@
+require 'tk'
+
+class PigBox
+
+  # ========================================================================= #
+  # === PADDING_TO_USE
+  # ========================================================================= #
+  PADDING_TO_USE = {
+    padx: 10,
+    pady: 10
+  }
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    use_this_callback = proc { show_pig }
+    root = TkRoot.new { title 'Pig' }
+    top = TkFrame.new(root)
+    TkLabel.new(top) {
+      text 'Enter Text:'
+      pack(PADDING_TO_USE)
+    }
+    @text = TkVariable.new
+    @entry = TkEntry.new(top, textvariable: @text)
+    @entry.pack(PADDING_TO_USE)
+    TkButton.new(top) {
+      text 'Pig It'
+      command use_this_callback
+      pack PADDING_TO_USE
+    }
+    TkButton.new(top) {
+      text 'Exit'
+      command {proc exit}
+      pack PADDING_TO_USE
+    }
+    top.pack(fill: 'both', side: 'top')
+  end
+
+  # ========================================================================= #
+  # === pig
+  # ========================================================================= #
+  def pig(word)
+    leadingCap = word =~ /^A-Z/
+    word.downcase!
+    res =
+    case word
+    when /^aeiouy/
+      "#{word}way"
+    when /^([^aeiouy]+)(.*)/
+      $2+$1+"ay"
+    else
+      word
+    end
+    leadingCap ? res.capitalize : res
+  end
+
+  # ========================================================================= #
+  # === show_pig
+  # ========================================================================= #
+  def show_pig
+    @text.value = @text.value.split.collect{|w| pig(w)}.join(' ')
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PigBox.new
+  Tk.mainloop
+end