mittens_ui 0.0.17 → 0.0.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 965d4306bb231d1777baa35f4553db1fd56d9c23ff483d1e7e469dba85933029
-  data.tar.gz: f00541e8f1a59fe6240e307cec7d53d2afde596ec3f62385d56fa9980f8a5fe6
+  metadata.gz: c853332d958f3db1b9c3fcf0257a81b8658c753844560fc313af3a874852182d
+  data.tar.gz: 7ab8875182370c9f4ea193c8e37c1dcd36d10912e97308c51a9de78e83aff9f1
 SHA512:
-  metadata.gz: 90288b844f09fa72f4e1aea63e564797f9ed2c82d16ed76aa4ea8debc6a12282cfc519aea6d2a99201ae58abe2fc2bfa0d033a64a1ebf532072f6daba02d4520
-  data.tar.gz: c4578d1b32fdc6da890c9d3ca5db4ebf03ca7f34077a0bbbe2cc97fc20597a10d240e7d34ace1dd26c4cb867ed6f998b819fc97e5da8712b40cfc9e8d9011a5d
+  metadata.gz: 8a4ce1db12ab26e00675371d60c1a120db50ee1c06618919532fee35bec5f2302c5b65cd006aece45b07f40d13416f0df55f916a3e6edc424668643aa9ccd0af
+  data.tar.gz: e1a05208a5dc5954bf140dcb7398bb55d4fe9949db7e80b7fd370b65d8732368cacabd7e98be6c6cba642cd5d9a0df58f4d30ed9b90b0061e6ed0cc190105dfa

data/README.md

@@ -1,22 +1,8 @@
 # MittensUi
 
-A lightweight Ruby GUI toolkit built on top of GTK, inspired by Ruby Shoes. MittensUi wraps the complexity of GTK so you can build desktop apps with plain Ruby objects and a simple, natural API — no DSLs, no magic, just Ruby.
+A lightweight Ruby GUI toolkit built on top of GTK, inspired by Ruby Shoes. MittensUi wraps the complexity of GTK so you can build desktop apps in Ruby.
 
-We will always try to keep up with the latest GTK updates.
-
-## Requirements
-
-MittensUi requires GTK native libraries to be installed on your system.
-
-**Ubuntu / Debian**
-```bash
-sudo apt install build-essential libgtk-4-dev libcairo2-dev
-```
-
-**macOS**
-```bash
-brew install gtk+4 cairo pkg-config
-```
+We always try to keep up with the latest GTK updates.
 
 ## Installation
 
@@ -81,7 +67,7 @@ Two `:half` widgets placed back to back sit side by side automatically. A `:full
 
 ### Horizontal Rows
 
-Use `HBox` to place widgets side by side in a row. The block style is recommended — no `defer_render` needed:
+Use `HBox` to place widgets side by side in a row:
 ```ruby
 MittensUi::HBox.new(spacing: 8) do
   MittensUi::Label.new("Name:")
@@ -161,7 +147,7 @@ Buttons support a loading state that disables the button and shows a spinner whi
 ```ruby
 btn.click do
   btn.loading do
-    sleep 2  # runs in background thread
+    sleep 2  # runs on a background thread
     puts "done!"
   end
 end
@@ -221,7 +207,7 @@ lb.clear_search
 ### Slider
 ```ruby
 s = MittensUi::Slider.new(start_value: 0, stop_value: 100, initial_value: 50)
-s.slide { |widget| puts widget.value }
+s.slide { |widget, value| puts "#{widget}: #{value}" }
 ```
 
 ### Switch
@@ -268,7 +254,7 @@ MittensUi::Notify.new("Saved!", type: :info)      # banner notification
 ```ruby
 loader = MittensUi::Loader.new
 loader.start do
-  sleep 3  # runs in background thread
+  sleep 3  # runs on a background thread
 end
 ```
 
@@ -304,7 +290,7 @@ MittensUi::WebLink.new("GitHub", "https://github.com")
 
 ### Separator
 ```ruby
-MittensUi::Separator.new                                    # horizontal (default)
+MittensUi::Separator.new
 MittensUi::Separator.new(:horizontal, top: 10, bottom: 10)  # with margin
 ```
 
@@ -326,7 +312,7 @@ MittensUi::HBox.new(spacing: 8) do
   end
 end
 
-# array style — requires defer_render: true on each widget
+# array style — requires `defer_render: true` attribute to be set on each widget
 MittensUi::HBox.new([
   MittensUi::Button.new(title: "OK",     defer_render: true),
   MittensUi::Button.new(title: "Cancel", defer_render: true)
@@ -335,11 +321,12 @@ MittensUi::HBox.new([
 
 ## Development
 
-**Setup Ruby**
-# setup and install Ruby if you have not done so:
+MittensUi requires GTK native libraries to be installed on your system.
+
+### Install Ruby if you have not done so:
 ```bash
 rbenv install 4.0.0
-rbenv global 4.0.0`
+rbenv global 4.0.0
 ```
 
 **Linux**
@@ -351,9 +338,9 @@ bundle install
 
 **macOS**
 ```bash
-brew install gtk+3 cairo pkg-config rbenv
+brew install gtk4 cairo pkg-config rbenv
 
-git clone https://github.com/tuttza/mittens_ui.git
+git clone https://codeberg.com/tuttza/mittens_ui.git
 cd mittens_ui
 bundle install
 ```
@@ -363,15 +350,11 @@ Run the test suite:
 bundle exec rspec
 ```
 
-Generate docs:
+Generate API docs:
 ```bash
 bundle exec yard doc
 ```
 
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/tuttza/mittens_ui.
-
 ## License
 
 Available under the MIT License.

data/examples/mig.rb

@@ -66,7 +66,7 @@ MittensUi::Application.Window(app_options) do
   MittensUi::Separator.new(:horizontal, top: 10, bottom: 10)
 
   s = MittensUi::Slider.new({ start_value: 1, stop_value: 100, initial_value: 30 })
-  s.slide { |value| puts "slider value: #{value}" }
+  s.slide { |w, v| puts "slider: #{w} value: #{v}" }
 
   switch = MittensUi::Switch.new(left: 220)
   switch.on do

data/lib/mittens_ui/checkbox.rb

@@ -38,7 +38,7 @@ module MittensUi
     # @return [void]
     def toggle
       @checkbox.signal_connect('toggled') do
-        yield
+        yield(self)
       end
     end
 

data/lib/mittens_ui/core.rb

@@ -51,8 +51,8 @@ module MittensUi
     def initialize(widget, options = {})
       @core_widget  = widget # This represents the GTK widget.
       @core_widget.focusable = true
-      @width        = options[:width]        || :full
-      @defer_render = options[:defer_render] || false
+      @width        = options.fetch(:width, :full)
+      @defer_render = options.fetch(:defer_render, false)
       set_margin_from_opts_for(@core_widget, options)
       render unless @defer_render
       enable_hover_focus

data/lib/mittens_ui/slider.rb

@@ -59,7 +59,7 @@ module MittensUi
     #   end
     def move
       @scale.signal_connect('value_changed') do |scale_widget|
-        yield(scale_widget.value)
+        yield(scale_widget, scale_widget.value)
       end
     end
     alias slide move

data/lib/mittens_ui/version.rb

@@ -1,3 +1,3 @@
 module MittensUi
-  VERSION = "0.0.17"
+  VERSION = "0.0.18"
 end

data/lib/mittens_ui.rb

@@ -227,10 +227,10 @@ module MittensUi
       # @yield [window] the GTK application window
       # @return [void]
       def init_gtk_application(options, &block)
-        app_name        = options[:name]       || 'mittens_ui_app'
-        height          = options[:height]     || 600
-        width           = options[:width]      || 400
-        title           = options[:title]      || 'Mittens App'
+        app_name        = options.fetch(:name, 'mittens_ui_app')
+        height          = options.fetch(:height, 600)
+        width           = options.fetch(:width, 400)
+        title           = options.fetch(:title, 'Mittens App')
         can_resize      = options.fetch(:can_resize, true)
         theme           = options.fetch(:theme, :system)
         app_assets_path = File.join(__dir__, 'mittens_ui', 'assets')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mittens_ui
 version: !ruby/object:Gem::Version
-  version: 0.0.17
+  version: 0.0.18
 platform: ruby
 authors:
 - Zach Tuttle