wxruby3 0.9.2-x64-mingw-ucrt → 0.9.4-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48854a18e516defd6648ebc670fbd1d2a35630c5729822d69fccbf53d0738a39
-  data.tar.gz: 21126e8c1a3c61e291ed9109269ed25ea626ff686cf4f06a4ed889983b4c57c5
+  metadata.gz: 35f2b1b6a08de7ccf13fa0a671b8b75ba914983bb8c94e766f338c9793e313ff
+  data.tar.gz: 7c0689b6bba48874d538c901bb8258a9e721c70009898343e286386c0470094c
 SHA512:
-  metadata.gz: 68e8915b663e8754dff9703c5e5d30b34a465aea4f389734a403d75321f8129c7abc6a9ff92dd2b195a5b30e48aea8ac16abc6761d31a501f53345ffa03a39fa
-  data.tar.gz: 9322c2cde67925cc894616177b8858ff584ca5f177125b66f20442b662968985e91776c7cdeb7573e6d0a760970674450dc49b0b68634f890d7457b846af90bc
+  metadata.gz: a89cc5a2f3511265cd17606a1a1fdce8991122944f5fb40aa239e2422666b325bbcea97d40f5a7bae350291c3ab85206a74789c49a3a7e6666e1ebf8763789aa
+  data.tar.gz: '082c3a7bff1e51fb1ddb42706bb4db47b4b6e5e27bc8a5fd10f2dfbd6d6b1dc5a92c4e2dbd50a17d57aac0345d2ff95117c224817fc4b3f906d232ecd5daee80'

data/INSTALL.md

@@ -10,14 +10,14 @@ Below are installation instructions for Linux, Windows, and Mac (both AMD64 and
 
 The minimal requirements for installing any source based setup (gem, source package or Github clone) of wxRuby3 are:
 
-| Sofware                                       | Notes                                                                                                                                                                                                                                                             |
-|-----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                                                                |
-| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed via `sudo xcode-select --install` |
-| Git version control toolkit                   |                                                                                                                                                                                                                                                                   |
-| SWIG >= 3.0.12                                | On MacOS install [Homebrew](https://brew.sh/) and than `brew install swig`                                                                                                                                                                                        |
-| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: `brew tap mcorino/wxruby3` and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                                                              |
-| wxWidgets (>= 3.2)                            | See [wxWidgets installation](#wxwidgets-installation)                                                                                                                                                                                                             |
+| Sofware                                       | Notes                                                                                                                                                                                                                                                                        |
+|-----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                                                                           |
+| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed via <code>sudo xcode-select --install</code> |
+| Git version control toolkit                   |                                                                                                                                                                                                                                                                              |
+| SWIG >= 3.0.12                                | On MacOS install Homebrew (https://brew.sh) and than <code>brew install swig</code>                                                                                                                                                                                          |
+| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: <code>brew tap mcorino/wxruby3</code> and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                                                              |
+| wxWidgets (>= 3.2)                            | See the <b>wxWidgets installation</b> section below.                                                                                                                                                                                                                         |
 
 The wxRuby3 build process requires `git` to clone a copy of the wxWidgets Github repository to extract the interface 
 specifications from.<br>
@@ -57,46 +57,41 @@ gem install wxruby3 -- WITH_WXWIN=1
 
 Also a wxWidgets installation (version 3.2 or later) is required for which there are multiple options.
 
-1. System installed wxWidgets version (including development package)<br>
-   <br>
+1. System installed wxWidgets version (including development package)<br/>
+   <br/>
    This is the default method used when installing the source gem without any options.<br>
    The wxRuby build procedure will determine the availability and version of wxWidgets by locating and calling
    the `wx-config` utility script. In case no (compatible) wxWidgets version is found installation ends with an error.<br>
    Please note that even with this method a copy of the wxWidgets project will be checked out from GitHUb as the wxRuby3
    build procedure requires access to the wxWidgets interface specification sources which are not normally part of any of 
-   the standard distribution packages.
-   
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;On MacOS, you can install wxWidgets via [Homebrew](https://brew.sh/):
-
-```shell
+   the standard distribution packages.<br/> 
+   <br/>
+   On MacOS, you can install wxWidgets via [Homebrew](https://brew.sh/):
+   ```shell
    brew install wxwidgets
-```
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Afterwards, you can install the Ruby gem and it will detect wxWidgets in the system automatically:
-
-```shell
+   ```
+   Afterwards, you can install the Ruby gem and it will detect wxWidgets in the system automatically:
+   ```shell
    gem install wxruby3
-```   
+   ```   
 
 2. User installed wxWidgets version<br>
    <br>
    In case the system being installed on does not provide (a compatible) wxWidgets version or a specific (possibly updated)
    wxWidgets version is required the source gem can be installed using a user installed version like this (where the 
    `WXWIN` path should provide the location where the wxWidgets binaries are installed under `<wxwin path>/bin`):<br>
-
-```shell
+   ```shell
    gem install wxruby3 -- WXWIN=/path/to/wx/install 
-```
+   ```
 
 3. Automatic installed, embedded, wxWidgets version<br>
    <br>
    This is the easiest method when the system being installed on does not provide (a compatible) wxWidgets version (and 
    no specific user defined version is required) and can be used by installing the source gem like this (which will
    cause automatic checkout and building of the latest stable wxWidgets release (>= 3.2) from GitHub:
-
-```shell
+   ```shell
    gem install wxruby3 -- WITH_WXWIN=1
-```
+   ```
 
 In case of option **2** it is also possible to do the doxygen XML generation as part of the wxWidgets user installation
 and use that for the gem installation. In that case the user is required to generate the XML interface specs using the
@@ -104,16 +99,27 @@ and use that for the gem installation. In that case the user is required to gene
 provided to the gem installation as follows:
 
 ```shell
-   gem install wxruby3 -- WXWIN=/path/to/wx/install WXXML=/path/to/wx/doxygen/xml
+gem install wxruby3 -- WXWIN=/path/to/wx/install WXXML=/path/to/wx/doxygen/xml
 ```
 
-Please also not that in case of option two the user is responsible to make sure the wxWidgets shared libraries can be
+Please also not that in case of option **2** the user is responsible to make sure the wxWidgets shared libraries can be
 found by the system's dynamic loader at runtime.
 
 > **NOTE:** Be patient when installing the source gem. Building wxRuby3 takes a while and when wxWidgets is included event more. 
 
 > **NOTE:** Be aware that for prerelease versions of the gem you should add the `--pre` argument to the `gem install` command. 
 
+### Bundled CLI
+
+Installing the wxRuby3 gem will also install the bundled `wxruby` CLI binary.
+
+Currently this binary can be used to run the bundled regression tests and access (run or copy) the bundled examples.
+Run the following command to see the options:
+
+```shell
+wxruby --help
+```
+
 ## Building from source
 
 Checkout the wxRuby3 sources from [GitHub](https://github.com/mcorino/wxRuby3) or download and unpack a release package.

data/README.md

@@ -96,11 +96,11 @@ of these products.
 
 Currently the following are fully supported:
 
-| Platform                                                                   | Ruby version(s) | wxWidgets version(s) |
-|----------------------------------------------------------------------------|-----------------| --- |
-| Windows 10 (tested)<br>(most likely also Windows 11)                       | Ruby >= 2.5<br>(RubyInstaller MSYS2-DevKit) | wxWidgets >= 3.2 |
-| Linux (tested; any AMD-64 distribution)<br>(most likely also i686 and ARM) | Ruby >= 2.5 | wxWidgets >= 3.2 |
-| MacOS >= 10.10 using Cocoa (tested on AMD-64 and ARM64 M2 Chip)            | Ruby >= 2.5 | wxWidgets >= 3.2 |
+| Platform                                                                   | Ruby version(s)                             | wxWidgets version(s) |
+|----------------------------------------------------------------------------|---------------------------------------------|----------------------|
+| Windows 10 (tested)<br>(most likely also Windows 11)                       | Ruby >= 2.5<br>(RubyInstaller MSYS2-DevKit) | wxWidgets >= 3.2     |
+| Linux (tested; any AMD-64 distribution)<br>(most likely also i686 and ARM) | Ruby >= 2.5                                 | wxWidgets >= 3.2     |
+| MacOS >= 10.10 using Cocoa (tested on AMD-64 and ARM64 M2 Chip)            | Ruby >= 2.5                                 | wxWidgets >= 3.2     |
 
 Support for other platforms is not being actively developed at present,
 but patches are welcome. It is likely to be much simpler to get wxRuby
@@ -118,14 +118,16 @@ Installing the binary gem version on Windows requires no additional software to
 version of the Ruby interpreter.<br>
 To install the source-only gem the following software is required:
 
-| Sofware                                       | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-|-----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed                                                                                                                                                                                                                                                                                                                                                                                                              |
-| Git version control toolkit                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| SWIG >= 3.0.12                                | On MacOS install [Homebrew](https://brew.sh/) and than `brew install swig`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: `brew tap mcorino/wxruby3` and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| wxWidgets >= 3.2 (*OPTIONAL*)                 | On Linux most distributions provide system installable (development) packages for wxWidgets providing a supported version. Alternatively you can fairly easily install your own preferred version manually (see the [wxWidgets](https://wxwidgets.org) project for details).<br>On Windows and MacOS the process is less straightforward (also here see the [wxWidgets](https://wxwidgets.org) project for details).<br>The wxRuby3 source-only gem can also be installed using a private local wxWidgets installation or an embedded installation (most likely preferred on Windows and MacOS). See [INSTALL](INSTALL.md) for more details. |    
+| Sofware                                       | Notes                                                                                                                                                                                                                           |
+|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                              |
+| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed |
+| Git version control toolkit                   |                                                                                                                                                                                                                                 |
+| SWIG >= 3.0.12                                | On MacOS install with Homebrew                                                                                                                                                                                                  |
+| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.                                                                                                                                               |
+| wxWidgets >= 3.2 (*OPTIONAL*)                 | On Linux most distributions provide system installable (development) packages for wxWidgets providing a supported version.<br>Alternatively you can fairly easily install your own preferred version manually.                  |    
+
+See the [INSTALL](INSTALL.md) document for more details.
 
 In case the prerequisites above are met the (source-only or binary) gem can be installed executing the following command:
 
@@ -154,7 +156,9 @@ distribution comes with numerous samples which illustrate how to use
 many specific parts of the API. A good one to start with is the
 'minimal' sample, which provides an application skeleton. All the
 bundled samples are expected to work with current wxRuby3, although
-some use a more modern coding style than others.
+some use a more modern coding style than others. Use the bundled `wxruby`
+CLI to access the samples (see the section **Bundled CLI** in 
+the [INSTALL](INSTALL.md) document for more details).
 
 Complete (more or less) wxRuby API documentation should be part of any
 complete wxRuby3 build. This tends to focus on providing a reference
@@ -213,4 +217,9 @@ this doesn't help, please post your question using GitHub Issues.
 
 ### Is there another, more declarative way, for writing wxRuby3 desktop GUI applications?
 
-Yes. [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) enables software engineers to build GUI using wxruby3 following the Ruby way with the least amount of code possible. That is by offering a minimalistic declarative high-level DSL that maps visually to the way software engineers think about the GUI hierarchy in addition to adopting Rails' strategy of Convention over Configuration via smart defaults and automation of wxruby3 low-level details. You can check out the [Glimmer DSL for WX README "Coming From wxruby3" section](https://github.com/AndyObtiva/glimmer-dsl-wx#coming-from-wxruby3) for more information on how to translate wxruby3 apps to [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) syntax.
+Yes. [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) enables software engineers to build GUI 
+using wxruby3 following the Ruby way with the least amount of code possible. That is by offering a minimalistic 
+declarative high-level DSL that maps visually to the way software engineers think about the GUI hierarchy in addition 
+to adopting Rails' strategy of Convention over Configuration via smart defaults and automation of wxruby3 low-level 
+details. You can check out the [Glimmer DSL for WX README "Coming From wxruby3" section](https://github.com/AndyObtiva/glimmer-dsl-wx#coming-from-wxruby3) for more information on 
+how to translate wxruby3 apps to [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) syntax.

data/lib/wx/core/bitmap_combobox.rb

@@ -8,32 +8,28 @@
 
 module Wx
 
-  class BitmapCombobox < Wx::ComboBox
-
-    # We need to cache client data in Ruby variables as we cannot access items
-    # during the GC mark phase as for some platforms (WXMSW at least) that would
-    # involve calling methods that would break in that phase.
+  class BitmapComboBox < Wx::ComboBox
 
     wx_append = instance_method :append
-    define_method :append do |item, bitmap=Wx::NULL_BITMAP, data=nil|
-      itm_pos = if data
-                  wx_append.bind(self).call(item, bitmap, data)
-                else
-                  wx_append.bind(self).call(item, bitmap)
-                end
-      client_data_store.insert(itm_pos, data)
-      itm_pos
+    define_method :append do |item, *rest| #bitmap=Wx::NULL_BITMAP, data=nil|
+      if ::Array === item
+        super(item, *rest)
+      elsif rest.empty? || Wx::Bitmap === rest.first
+        wx_append.bind(self).call(item, *rest)
+      else
+        super(item, *rest)
+      end
     end
 
     wx_insert = instance_method :insert
-    define_method :insert do |item, bitmap, pos, data=nil|
-      itm_pos = if data
-                  wx_insert.bind(self).call(item, bitmap, pos, data)
-                else
-                  wx_insert.bind(self).call(item, bitmap, pos)
-                end
-      client_data_store.insert(itm_pos, data)
-      itm_pos
+    define_method :insert do |item, *rest| # bitmap, pos, data=nil|
+      if ::Array === item
+        super(item, *rest)
+      elsif rest.empty? || Wx::Bitmap === rest.first
+        wx_insert.bind(self).call(item, *rest)
+      else
+        super(item, *rest)
+      end
     end
 
   end

data/lib/wx/core/book_ctrl_base.rb

@@ -0,0 +1,16 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+module Wx
+
+  class BookCtrlBase
+
+    # create PersistentObject for toplevel windows (incl. Dialog and Frame)
+    def create_persistent_object
+      PersistentBookCtrl.new(self)
+    end
+
+  end
+
+end

data/lib/wx/core/combobox.rb

@@ -8,7 +8,17 @@
 
 require_relative './controlwithitems'
 
-class Wx::ComboBox
-  alias :get_item_data :get_client_data
-  alias :set_item_data :set_client_data
+module Wx
+
+  class ComboBox
+
+    # redefine #clear method to take care of client data and to call the proper #clear_items method
+    # (not the #clear method inherited from the TextEntry mixin)
+    wx_clear = instance_method :clear_items
+    define_method :clear do
+      wx_clear.bind(self).call
+    end
+
+  end
+
 end