libui 0.2.0-x86_64-darwin → 0.2.1-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d2954e0190af33bfe1bb68cc123b57b5d5bc10a90ef21167b6db870ff40524d
-  data.tar.gz: e5748e4586617b1809dfc384bb897f92e298d91ec50e15eb6a7bef763f17dab7
+  metadata.gz: 2da7e4d17eb4d0cc4479b3c67bb96e13525abaa67b0d148fb7d102501f5afffa
+  data.tar.gz: 8995dea62c2f064e1166e3df975fe8c2fc17582a10479cbd74d0f725ebce41c5
 SHA512:
-  metadata.gz: dacbc63fe500b48d6216d64090b8d94a1ac0e466eadc9cd9ad266c65e61bf45c3da768778cf03388d094abe67e1fd20723d728758c419d85e04c310f6fc5f65d
-  data.tar.gz: c55a34901a8dc3a997d055d0034a84e574fbe6fb1aad6eab6e4419a1bd4b42e10b94750d590d77e524500a64fac28f1e61c3cb257ac5682f4a80ca6ae7476b5f
+  metadata.gz: 52812b379c2644c91d133cc3a2a55d64280cbcca7a45a404ef3ae53ac76ad1aa98e3166f5310440b2fb61186fa2db4bd13571d131e26b7883362f71c34d1e426
+  data.tar.gz: 8625c35e8e2918a73afcc550aed29e8f024b5bf6782aabf2e5d8e82f9c41533879aa50eba8a490d959564d1a094db89924b2e4773ab79ac935762c34b7dfc922

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: x86_64-darwin
 authors:
 - kojix2