mittens_ui 0.0.9 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9976f7810db4c1f9ed61a4a1f1f639617ee9c84bf117d37e174b14fd54b21dbc
-  data.tar.gz: 0224ed85d93f9366f7f594e19ed74827c72b33c949ea7ce9efc78a230dc44121
+  metadata.gz: bb39340bda7c9c473ade8a1cfa92300cd87f6fdd29e96431507b0fc21133a6a7
+  data.tar.gz: 3ed7082dfca8a2475e6d86bae2bb36e5740464044bc6d67ce140b3de00eb4d8c
 SHA512:
-  metadata.gz: 68fbe929734690f1a21377b914fc200c54307e5393a98da9324e017b6bc59b3270577e4e09843aad88f49d61f6fd732c25f5e635d0ad2b0536d518898750e40b
-  data.tar.gz: edaecba0f03a65f2c79cab04345434cd8f8539c4a7930480eb6e792e89c90ee969416b7bcd36efba77be11f28210cf08e4a9c1c2d7cb3990cf5ca5940be3db67
+  metadata.gz: 5a47bf32490fb765cb9084bdb6aea8ca5fba19b572d81cc321c1cd56e13c45cc317f39f99bf63834a867f513817a02000e5819379501f0a3a36334f02d458aeb
+  data.tar.gz: 54149cd2b1f4d2d3d45ea434e244a746de45226bea12597d6166f31ae2b127208ad848d630d859297ecf70a32fac568fbfd356d8d1eb8776609550c96547dc32

data/Gemfile

@@ -1,6 +1,6 @@
 source "https://rubygems.org"
 
-ruby "3.0.1"
+ruby "3.0.2"
 
 # Specify your gem's dependencies in mittens_ui.gemspec
 gemspec

data/Gemfile.lock

@@ -68,7 +68,7 @@ DEPENDENCIES
   rspec (~> 3.0)
 
 RUBY VERSION
-   ruby 3.0.1p64
+   ruby 3.0.2p107
 
 BUNDLED WITH
-   2.2.15
+   2.2.22

data/README.md

@@ -4,6 +4,8 @@ This is a small vertical stacking GUI toolkit inspired by Ruby Shoes and built o
 around GTK. The goal of this project is make creating GUIs in Ruby dead simple 
 without the UI framework/library getting your way.
 
+![alt_text](https://github.com/tuttza/mittens_ui/blob/51e84d7c50282e3f2c856aa9e65fe3ed28b117ff/lib/mittens_ui/assets/mittens_ui_preview.gif "MittensUi Preview")
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -23,84 +25,89 @@ Or install it yourself as:
 ## Usage
 
 ```ruby
-require "mittens_ui"
+require 'mittens_ui'
 
 app_options = {
-  name: "hello_world",
-  title: "Hello World App!",
-  height: 650,
-  width: 550,
+  name: "contacts",
+  title: "Contacts",
+  height: 615,
+  width: 570,
   can_resize: true
 }.freeze
 
-MittensUi::Application.Window(app_options) do
-  MittensUi::Label("Enter Name:", top: 30)
-
-  text_box = MittensUi::Textbox(can_edit: true)
-
-  listbox_options = {
-    top: 10,
-    items: ["item_1", "item_2", "item_3"]
-  }.freeze
-
-  listbox = MittensUi::ListBox(listbox_options)
 
-  btn = MittensUi::Button(title: "Click Here")
-  btn.click {|_b| MittensUi::Alert("Hello #{text_box.text} AND! #{listbox.selected_value} was selected.") }
+require '../lib/mittens_ui'
 
-  s = MittensUi::Slider({ start_value: 1, stop_value: 100, initial_value: 30 })
-  s.slide { |s| puts s.value }
-
-  img_opts = {
-    tooltip_text: "The Gnome LOGO!",
-    width: 200,
-    height: 200,
-    left: 50
-  }.freeze
-
-  img = MittensUi::Image("./assets/gnome_logo.png", img_opts)
+app_options = {
+  name: "contacts",
+  title: "Contacts",
+  height: 615,
+  width: 570,
+  can_resize: true
+}.freeze
 
-  switch = MittensUi::Switch(left: 120 )
 
-  img.click do
-    unless switch.hidden?
-      switch.show
-    else
-      switch.hide
-    end
-  end
+MittensUi::Application.Window(app_options) do
+  add_contact_button    = MittensUi::Button.new(title: "Add")
+  remove_contact_button = MittensUi::Button.new(title: "Remove")
 
-  switch.on do
-    unless img.hidden?
-      img.show
-    else
-      img.hide
-    end 
-  end
+  buttons = [ add_contact_button, remove_contact_button ]
 
-  cb = MittensUi::CheckBox(label: "Enable")
-  cb.value = "Some Value"
-  cb.toggle { puts "checkbox was toggled! associated value: #{cb.value}" }
+  MittensUi::HeaderBar.new(buttons.map(&:render), title: "Contacts", position: :left).render
 
-  link = MittensUi::WebLink("YouTube", "https://www.youtube.com", left: 200)
-  
   table_view_options = {
     headers: ["Name", "Address", "Phone #"],
     data: [ 
       [ "John Appleseed", "123 abc st.", "111-555-3333"],
       [ "Jane Doe", "122 abc st.", "111-555-4444" ],
       [ "Bobby Jones", "434 bfef ave.", "442-333-1342"],
+      [ "Sara Akigawa", "777 tyo ave.", "932-333-1325"],
      ],
+     top: 20
   }
   
-  table = MittensUi::TableView(table_view_options)
-  table.add(["Sara Akigawa", "777 tyo ave.", "932-333-1325"], :prepend)
-  
-  remove_ct = MittensUi::Button(title: "Remove Contact")
-  remove_ct.click { |btn| table.remove_selected }
-  
-end
+  contacts_table = MittensUi::TableView.new(table_view_options).render
 
+  # FORM
+  MittensUi::Label.new("Add Contact", top: 30).render
+
+  name_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Name...")
+  addr_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Address...")
+  phne_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Phone #...")
+
+  tb_list = [name_tb, addr_tb, phne_tb].map(&:render).freeze
+
+  MittensUi::HBox.new(tb_list, spacing: 10).render
+
+  # ACTONS
+
+  add_contact_button.click do |_b| 
+    if tb_list.map { |tb| tb.text.length > 0 }.all?
+      contacts_table.add(tb_list.map {|tb| tb.text })
+      tb_list.map {|tb| tb.clear }
+    end
+  end
+
+  remove_contact_button.click do |btn| 
+    removed = contacts_table.remove_selected 
+
+    if removed.size > 0
+      MittensUi::Alert.new("#{removed[0]} was removed.").render
+    end
+  end
+
+  contacts_table.row_clicked do |data|
+    msg = <<~MSG
+      Contact Info:
+
+      Name:        #{data[0]}
+      Address:     #{data[1]}
+      Phone #:     #{data[2]}
+    MSG
+
+    MittensUi::Alert.new(msg).render
+  end
+end
 
 ```
 
@@ -114,11 +121,8 @@ This does require GTK ruby gem which requires `gtk` native dependencies to be co
 Using dnf:
 * `$ sudo dnf install ruby ruby-devel cairo cairo-devel gtk3-devel`
 
-#### MacOS
-
-Using Brew:
-* `$ brew install gtk+3`
-* `$ brew install cairo`
+#### Ubuntu
+* `sudo apt install build-essential git sqlite3 libsqlite3-dev lib-gtk-3 libcairo2-dev`
 
 ## Contributing
 

data/examples/app.rb

@@ -5,10 +5,16 @@ app_options = {
   title: "Hello World App!",
   height: 650,
   width: 550,
-  can_resize: false
+  can_resize: true
 }.freeze
 
 MittensUi::Application.Window(app_options) do
+
+  MittensUi::HeaderBar([
+    MittensUi::Button(title: "headerbar button"),
+    MittensUi::CheckBox(label: "Checkbox")
+  ], title: "Demo App", position: :left) {}
+
   MittensUi::Label("Enter Name:", top: 30)
 
   text_box = MittensUi::Textbox(can_edit: true)
@@ -35,6 +41,8 @@ MittensUi::Application.Window(app_options) do
 
   img = MittensUi::Image("./assets/gnome_logo.png", img_opts)
 
+  img2 = MittensUi::Image("./assets/mittens_ui_preview.gif", img_opts)
+
   switch = MittensUi::Switch(left: 220 )
 
   img.click do

data/examples/contacts.rb

@@ -0,0 +1,75 @@
+require '../lib/mittens_ui'
+
+app_options = {
+  name: "contacts",
+  title: "Contacts",
+  height: 615,
+  width: 570,
+  can_resize: true
+}.freeze
+
+
+MittensUi::Application.Window(app_options) do
+  add_contact_button    = MittensUi::Button.new(title: "Add")
+  remove_contact_button = MittensUi::Button.new(title: "Remove")
+
+  buttons = [ add_contact_button, remove_contact_button ]
+
+  MittensUi::HeaderBar.new(buttons.map(&:render), title: "Contacts", position: :left).render
+
+  table_view_options = {
+    headers: ["Name", "Address", "Phone #"],
+    data: [ 
+      [ "John Appleseed", "123 abc st.", "111-555-3333"],
+      [ "Jane Doe", "122 abc st.", "111-555-4444" ],
+      [ "Bobby Jones", "434 bfef ave.", "442-333-1342"],
+      [ "Sara Akigawa", "777 tyo ave.", "932-333-1325"],
+     ],
+     top: 20
+  }
+  
+  contacts_table = MittensUi::TableView.new(table_view_options).render
+
+  # FORM
+  MittensUi::Label.new("Add Contact", top: 30).render
+
+  name_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Name...")
+  addr_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Address...")
+  phne_tb = MittensUi::Textbox.new(can_edit: true, placeholder: "Phone #...")
+
+  tb_list = [name_tb, addr_tb, phne_tb].map(&:render).freeze
+
+  MittensUi::HBox.new(tb_list, spacing: 10).render
+
+  fp = MittensUi::FilePicker.new
+
+  # ACTONS
+
+  add_contact_button.click do |_b| 
+    if tb_list.map { |tb| tb.text.length > 0 }.all?
+      contacts_table.add(tb_list.map {|tb| tb.text })
+      tb_list.map {|tb| tb.clear }
+        puts "#{fp.render.path}"
+    end
+  end
+
+  remove_contact_button.click do |btn| 
+    removed = contacts_table.remove_selected 
+
+    if removed.size > 0
+      MittensUi::Alert.new("#{removed[0]} was removed.").render
+    end
+  end
+
+  contacts_table.row_clicked do |data|
+    msg = <<~MSG
+      Contact Info:
+
+      Name:        #{data[0]}
+      Address:     #{data[1]}
+      Phone #:     #{data[2]}
+    MSG
+
+    MittensUi::Alert.new(msg).render
+  end
+end

data/lib/mittens_ui.rb

@@ -1,77 +1,25 @@
 require "mittens_ui/version"
-require "mittens_ui/widgets/alert"
-require "mittens_ui/widgets/label"
-require "mittens_ui/widgets/button"
-require "mittens_ui/widgets/textbox"
-require "mittens_ui/widgets/listbox"
-require "mittens_ui/widgets/slider"
-require "mittens_ui/widgets/switch"
-require "mittens_ui/widgets/image"
-require "mittens_ui/widgets/checkbox"
-require "mittens_ui/widgets/web_link"
-require "mittens_ui/widgets/table_view"
-require "mittens_ui/widgets/loader"
-
-require "mittens_ui/dialogs/file_dialog"
+require "mittens_ui/alert"
+require "mittens_ui/label"
+require "mittens_ui/button"
+require "mittens_ui/textbox"
+require "mittens_ui/listbox"
+require "mittens_ui/slider"
+require "mittens_ui/switch"
+require "mittens_ui/image"
+require "mittens_ui/checkbox"
+require "mittens_ui/web_link"
+require "mittens_ui/table_view"
+require "mittens_ui/loader"
+require "mittens_ui/header_bar"
+require "mittens_ui/file_picker"
+require "mittens_ui/hbox"
 
 require "gtk3"
 
 module MittensUi
   class Error < StandardError; end
 
-  def self.Loader(options={})
-    MittensUi::Widgets::Loader.new(options)
-  end
-
-  def self.FilePicker
-    fp = MittensUi::Dialogs::File.new
-    return fp.path
-  end
-  
-  def self.TableView(options={})
-    MittensUi::Widgets::TableView.new(options)
-  end
-
-  def self.WebLink(url, name, options={})
-    MittensUi::Widgets::WebLink.new(url, name, options)
-  end
-
-  def self.CheckBox(options={})
-    MittensUi::Widgets::Checkbox.new(options)
-  end
-
-  def self.Image(path, options={})
-    MittensUi::Widgets::Image.new(path, options)
-  end
-
-  def self.Switch(options = {})
-    MittensUi::Widgets::Switch.new(options)
-  end
-
-  def self.Slider(options = {})
-    MittensUi::Widgets::Slider.new(options)
-  end
-
-  def self.ListBox(options = {})
-    MittensUi::Widgets::ListBox.new(options)
-  end
-
-  def self.Alert(message, options = {})
-    MittensUi::Widgets::Alert.new(message, options)
-  end
-
-  def self.Label(text, options = {})
-    MittensUi::Widgets::Label.new(text, options)
-  end
-
-  def self.Textbox(options = {})
-    MittensUi::Widgets::Textbox.new(options)
-  end
-
-  def self.Button(options = {})
-    MittensUi::Widgets::Button.new(options)
-  end
-
   def self.Shutdown
     $app_window.signal_connect("delete-event") do |_widget| 
       yield
@@ -99,6 +47,11 @@ module MittensUi
         title       = options[:title].nil?      ? "Mittens App" : options[:title]
         can_resize  = options[:can_resize].nil? ? true : options[:can_resize]
 
+        app_assets_path = File.join(File.expand_path(File.dirname(__FILE__)), "mittens_ui", "assets") + "/"
+        default_icon = app_assets_path + "icon.png"
+        
+        app_icon = options[:icon].nil? ? default_icon : options[:icon]
+
         set_process_name(app_name)
 
         gtk_app_name = "org.mittens_ui.#{app_name}"
@@ -115,6 +68,7 @@ module MittensUi
           $app_window.set_size_request(width, height)
           $app_window.set_title(title)
           $app_window.set_resizable(can_resize)
+          $app_window.set_icon_from_file(app_icon)
           $app_window.show_all
         end
 

data/lib/mittens_ui/alert.rb

@@ -0,0 +1,32 @@
+module MittensUi
+  class Alert
+    def initialize(message, options={})
+      dialog_options = {
+        title: options[:title] || "Alert",
+        parent: $app_window,
+        flags: [:modal, :destroy_with_parent],
+        :buttons => [[Gtk::Stock::OK, :none]]
+      }.freeze
+
+      @alert_dialog = Gtk::Dialog.new(dialog_options)
+      @alert_dialog.set_transient_for($app_window)
+      @alert_dialog.set_default_width(420)
+      @alert_dialog.set_default_height(200)
+      @alert_dialog.set_modal(true)
+      @alert_dialog.set_resizable(false)
+
+      message_label = Gtk::Label.new(message)
+      message_label.set_margin_top(36)
+
+      dialog_box = @alert_dialog.content_area
+      dialog_box.add(message_label)
+    end
+
+    def render
+      @alert_dialog.show_all
+      response = @alert_dialog.run
+      response == :none ? @alert_dialog.destroy : @alert_dialog.destroy
+    end
+
+  end
+end