libui 0.2.0-x64-mingw-ucrt → 0.2.1-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 176cabb94d3e6b3043ba554e9eb9c2fa637281abdaf39b2007ad20f4235f52b3
-  data.tar.gz: 71fa2a596500f6dc247ea083661c347cd3827b1fdf2d8f9f1aff37faa592129b
+  metadata.gz: 6fd629f452a548a8e8ee6e7a831ab863eb4b43e3e709e1641e8c582a24e8f554
+  data.tar.gz: 5c81d5116b2a04fc64212a3f57004b890cf6f7e01ba04d513b51ff825f05e2fe
 SHA512:
-  metadata.gz: d8062c33cc8949639045ed1317ddf6956cc5938d9793562081ae82382683fab84f3f171a2e1dc4276cc463dbc316d9772ae906d9cfd18cc0a799f9223d4dd871
-  data.tar.gz: 43139f78a4d809082f2aa89aef4b68b53be8315455de5dcde4921c15ec6c24db1efe9d59be12f52a554edee84906311d2fc11e422892563bea21ecf1c1e0c951
+  metadata.gz: 9783a914542fa8e534b56e64cc928564f66f9c093e37b3ca278342613c8f2d066eb9aec64f41b40606362f17becfec69985794f81533bc874db4e952772ec5bb
+  data.tar.gz: b4953c59f245f284c8322a6f127de698980f44b8b32a30efcad343792bf5fe9350ebca77fa891267ed33b6a032b7970e34c41274060ad2902312e9a45068d10f

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020-2025 kojix2
+Copyright (c) 2020-present kojix2
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -16,20 +16,12 @@ LibUI is a Ruby wrapper for libui family.
 
 ## Installation
 
-It is recommended to use libui-ng, via the --pre commandline flag:
-
 ```sh
-gem install libui --pre # libui-ng; this will fetch libui-0.1.3.pre-x86_64-linux.gem
-```
-
-If for some reason you would like to install the slightly older libui-0.1.2.gem release, issue:
-
-```sh
-gem install libui
+gem install libui # --pre
 ```
 
 - The gem package includes the libui-ng shared library for Windows, Mac, and Linux.
-  - Namely `libui.dll`, `libui.dylib`, or `libui.so`.
+  - Namely `libui.x64.dll`/`libui.x86.dll`, `libui.x86_64.dylib`/`libui.arm64.dylib`, or `libui.x86_64.so`/`libui.aarch64.so`.
 - No dependencies required.
   - The libui gem uses the standard Ruby library [Fiddle](https://github.com/ruby/fiddle) to call C functions.
 
@@ -85,7 +77,7 @@ Compared to the original libui library written in C:
   - The block will be converted to a Proc object and added as the last argument.
   - The last argument can still be omitted when nil.
 
-You can use [the documentation for libui's Go bindings](https://pkg.go.dev/github.com/andlabs/ui) as a reference.
+You can use [the libui-ng API documentation](https://libui-ng.github.io/libui-ng/) as a reference.
 
 ### DSLs for LibUI
 
@@ -104,12 +96,26 @@ UI = LibUI
 UI.init
 ```
 
-To convert a pointer to a string:
+Text getter methods such as `label_text`, `entry_text`, and `window_title`
+return `Fiddle::Pointer` objects for strings allocated by libui. Convert the
+pointer to a Ruby string, then release it with `free_text`.
 
 ```ruby
 label = UI.new_label("Ruby")
-p pointer = UI.label_text(label) # #<Fiddle::Pointer>
-p pointer.to_s # Ruby
+pointer = UI.label_text(label) # #<Fiddle::Pointer>
+text = pointer.to_s
+UI.free_text(pointer)
+p text # Ruby
+```
+
+Use `ensure` if the code between conversion and cleanup can raise:
+
+```ruby
+def ui_text(text_pointer)
+  text_pointer.to_s
+ensure
+  UI.free_text(text_pointer) if text_pointer && !text_pointer.null?
+end
 ```
 
 If you need to use C structs, you can do the following:
@@ -124,11 +130,15 @@ font_descriptor.to_ptr.free = Fiddle::RUBY_FREE
 
 UI.font_button_on_changed(font_button) do
   UI.font_button_font(font_button, font_descriptor)
-  p family:  font_descriptor.Family.to_s,
-    size:    font_descriptor.Size,
-    weight:  font_descriptor.Weight,
-    italic:  font_descriptor.Italic,
-    stretch: font_descriptor.Stretch
+  begin
+    p family:  font_descriptor.Family.to_s,
+      size:    font_descriptor.Size,
+      weight:  font_descriptor.Weight,
+      italic:  font_descriptor.Italic,
+      stretch: font_descriptor.Stretch
+  ensure
+    UI.free_font_button_font(font_descriptor)
+  end
 end
 ```
 
@@ -206,8 +216,8 @@ If you build libui-ng yourself, set `LIBUIDIR` to the directory containing the c
 Push a version tag to automatically publish platform-specific gems:
 
 ```sh
-git tag v0.1.3
-git push origin v0.1.3
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
 Requires `RUBYGEMS_API_KEY` repository secret with scoped API key.
@@ -225,9 +235,19 @@ find pkg -name *.gem -exec sh -c "echo; echo \# {}; tar -O -f {} -x data.tar.gz
 rake release_platform # publish gems
 ```
 
+Windows Ruby (x64-mingw32 or x64-mingw-ucrt)
+
+```sh
+gem install rake rubyzip
+GEM_PLATFORM=x64-mingw32 rake vendor:clean
+GEM_PLATFORM=x64-mingw32 rake vendor:auto
+GEM_PLATFORM=x64-mingw32 gem build libui.gemspec
+gem push libui-0.2.0-x64-mingw32.gem
+```
+
 ### libui or libui-ng
 
-- From version 0.1.X, we plan to support only libui-ng/libui-ng.
+- From version 0.1.X, LibUI supports only libui-ng.
 - Version 0.0.X only supports andlabs/libui.
 
 ## Contributing

data/lib/libui/version.rb

@@ -1,3 +1,3 @@
 module LibUI
-  VERSION = '0.2.0'
+  VERSION = '0.2.1'
 end

data/lib/libui.rb

@@ -59,6 +59,106 @@ module LibUI
       nil
     end
 
+    def new_button(text = '')
+      super(text)
+    end
+
+    def new_checkbox(text = '')
+      super(text)
+    end
+
+    def window_set_title(window, title = '')
+      super(window, title)
+    end
+
+    def button_set_text(button, text = '')
+      super(button, text)
+    end
+
+    def checkbox_set_text(checkbox, text = '')
+      super(checkbox, text)
+    end
+
+    def entry_set_text(entry, text = '')
+      super(entry, text)
+    end
+
+    def label_set_text(label, text = '')
+      super(label, text)
+    end
+
+    def new_label(text = '')
+      super(text)
+    end
+
+    def group_set_title(group, title = '')
+      super(group, title)
+    end
+
+    def new_group(title = '')
+      super(title)
+    end
+
+    def combobox_append(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def combobox_insert_at(combobox, index, text = '')
+      super(combobox, index, text)
+    end
+
+    def editable_combobox_append(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def editable_combobox_set_text(combobox, text = '')
+      super(combobox, text)
+    end
+
+    def radio_buttons_append(radio_buttons, text = '')
+      super(radio_buttons, text)
+    end
+
+    def multiline_entry_set_text(entry, text = '')
+      super(entry, text)
+    end
+
+    def multiline_entry_append(entry, text = '')
+      super(entry, text)
+    end
+
+    def menu_append_item(menu, name = '')
+      super(menu, name)
+    end
+
+    def menu_append_check_item(menu, name = '')
+      super(menu, name)
+    end
+
+    def new_menu(name = '')
+      super(name)
+    end
+
+    def msg_box(parent, title, description = '')
+      super(parent, title, description)
+    end
+
+    def msg_box_error(parent, title, description = '')
+      super(parent, title, description)
+    end
+
+    def new_attributed_string(initial_string = '')
+      super(initial_string)
+    end
+
+    def attributed_string_append_unattributed(attributed_string, str = '')
+      super(attributed_string, str)
+    end
+
+    def new_table_value_string(str = '')
+      super(str)
+    end
+
     # Gets the window position.
     # Coordinates are measured from the top left corner of the screen.
     # @param w [Fiddle::Pointer] Pointer of uiWindow instance.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: libui
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: x64-mingw-ucrt
 authors:
 - kojix2