wxruby3 0.9.0.pre.rc.2-x64-mingw-ucrt → 0.9.0-x64-mingw-ucrt

data/lib/wx/core/events/evt_list.rb

@@ -611,6 +611,12 @@ class Wx::EvtHandler
       Wx::EVT_SPIN_DOWN,
       Wx::SpinEvent
     ] if Wx.const_defined?(:EVT_SPIN_DOWN)
+  # from wxSpinDoubleEvent
+  self.register_event_type EventType[
+      'evt_spinctrldouble', 1,
+      Wx::EVT_SPINCTRLDOUBLE,
+      Wx::SpinDoubleEvent
+    ] if Wx.const_defined?(:EVT_SPINCTRLDOUBLE)
   # from wxFontPickerEvent
   self.register_event_type EventType[
       'evt_fontpicker_changed', 1,
@@ -781,6 +787,7 @@ class Wx::EvtHandler
       Wx::EVT_LIST_ITEM_UNCHECKED,
       Wx::ListEvent
     ] if Wx.const_defined?(:EVT_LIST_ITEM_UNCHECKED)
+  # from wxHeaderCtrlEvent
   # from wxSplitterEvent
   self.register_event_type EventType[
       'evt_splitter_sash_pos_changing', 1,
@@ -1187,6 +1194,8 @@ class Wx::EvtHandler
       Wx::CommandEvent
     ] if Wx.const_defined?(:EVT_COMBOBOX_CLOSEUP)
   # from wxBitmapComboBox
+  # from wxComboCtrl
+  # from wxOwnerDrawnComboBox
   # from wxRadioBox
   # from wxPanel
   # from wxNotebook
@@ -1223,6 +1232,7 @@ class Wx::EvtHandler
       Wx::EVT_SPINCTRL,
       Wx::SpinEvent
     ] if Wx.const_defined?(:EVT_SPINCTRL)
+  # from wxSpinCtrlDouble
   # from wxBitmapButton
   # from wxRadioButton
   # from wxToolBar
@@ -1293,6 +1303,72 @@ class Wx::EvtHandler
   # from wxDirPickerCtrl
   # from wxFilePickerCtrl
   # from wxListCtrl
+  # from wxHeaderCtrl
+  self.register_event_type EventType[
+      'evt_header_click', 1,
+      Wx::EVT_HEADER_CLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_CLICK)
+  self.register_event_type EventType[
+      'evt_header_right_click', 1,
+      Wx::EVT_HEADER_RIGHT_CLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_RIGHT_CLICK)
+  self.register_event_type EventType[
+      'evt_header_middle_click', 1,
+      Wx::EVT_HEADER_MIDDLE_CLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_MIDDLE_CLICK)
+  self.register_event_type EventType[
+      'evt_header_dclick', 1,
+      Wx::EVT_HEADER_DCLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_DCLICK)
+  self.register_event_type EventType[
+      'evt_header_right_dclick', 1,
+      Wx::EVT_HEADER_RIGHT_DCLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_RIGHT_DCLICK)
+  self.register_event_type EventType[
+      'evt_header_middle_dclick', 1,
+      Wx::EVT_HEADER_MIDDLE_DCLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_MIDDLE_DCLICK)
+  self.register_event_type EventType[
+      'evt_header_separator_dclick', 1,
+      Wx::EVT_HEADER_SEPARATOR_DCLICK,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_SEPARATOR_DCLICK)
+  self.register_event_type EventType[
+      'evt_header_begin_resize', 1,
+      Wx::EVT_HEADER_BEGIN_RESIZE,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_BEGIN_RESIZE)
+  self.register_event_type EventType[
+      'evt_header_resizing', 1,
+      Wx::EVT_HEADER_RESIZING,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_RESIZING)
+  self.register_event_type EventType[
+      'evt_header_end_resize', 1,
+      Wx::EVT_HEADER_END_RESIZE,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_END_RESIZE)
+  self.register_event_type EventType[
+      'evt_header_begin_reorder', 1,
+      Wx::EVT_HEADER_BEGIN_REORDER,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_BEGIN_REORDER)
+  self.register_event_type EventType[
+      'evt_header_end_reorder', 1,
+      Wx::EVT_HEADER_END_REORDER,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_END_REORDER)
+  self.register_event_type EventType[
+      'evt_header_dragging_cancelled', 1,
+      Wx::EVT_HEADER_DRAGGING_CANCELLED,
+      Wx::HeaderCtrlEvent
+    ] if Wx.const_defined?(:EVT_HEADER_DRAGGING_CANCELLED)
   # from wxSplitterWindow
   self.register_event_type EventType[
       'evt_splitter_sash_pos_resize', 1,

data/lib/wx/core/evthandler.rb

@@ -1,3 +1,11 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # All classes which are capable of handling events inherit from
 # EvtHandler. This includes all Wx::Window subclasses and Wx::App.
 

data/lib/wx/core/ext.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 module Wx
 

data/lib/wx/core/file_dialog.rb

@@ -0,0 +1,23 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+#
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
+# WxRuby Extensions - Dialog functors for wxRuby3
+
+module Wx
+
+  class FileDialog
+
+    wx_set_customize_hook = instance_method :set_customize_hook
+    define_method :set_customize_hook do |hook|
+      wx_set_customize_hook.bind(self).call(hook)
+      @hook = hook # cache hook to prevent premature GC collection
+    end
+
+  end
+
+end

data/lib/wx/core/find_replace_dialog.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 module Wx
 

data/lib/wx/core/functions.rb

@@ -1,3 +1,11 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Tweaks to the global module functions
 
 module Wx

data/lib/wx/core/gauge.rb

@@ -1,12 +1,21 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Gauge : presents a progress bar
 #
 # On the C++ side, the actual class name of wxGauge under Windows is
 # wxGauge95. So when a Gauge is loaded from XRC, and we try to wrap the
 # object in a ruby class by calling obj->ClassInfo()->ClassName(), it
 # seeks for a ruby class (Wx::Gauge95) that doesn't exist (see
-# swig/shared/get_ruby_object.i). 
+# swig/shared/get_ruby_object.i).
 #
 # To fix this, make Wx::Gauge95 an alias.
+
 if Wx::PLATFORM == 'WXMSW'
   Wx::Gauge95 = Wx::Gauge
 end

data/lib/wx/core/genericdirctrl.rb

@@ -1,4 +1,13 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Bottom-up implementation of a Directory lister
+
 class Wx::GenericDirCtrl
   module DirCtrlTree 
     # The TreeCtrl contained in a GenericDirCtrl already has C++ data

data/lib/wx/core/hboxsizer.rb

@@ -1,6 +1,22 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Just a shortcut version for creating a horizontal box sizer
+
 class Wx::HBoxSizer < Wx::BoxSizer
   def initialize
     super(Wx::HORIZONTAL)
   end
 end
+
+# Just a shortcut version for creating a horizontal wrap sizer
+class Wx::HWrapSizer < Wx::WrapSizer
+  def initialize(flags=Wx::WRAPSIZER_DEFAULT_FLAGS)
+    super(Wx::HORIZONTAL)
+  end
+end

data/lib/wx/core/helpcontroller.rb

@@ -1,3 +1,11 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 class Wx::HelpController
   def self.instance(*args)
     @instance ||= new(*args)

data/lib/wx/core/helpcontrollerhelpprovider.rb

@@ -1,5 +1,14 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Pure-ruby implementation of the corresponding Wx class. Shows a
 # relevant section of help, if available, or a native popup
+
 require_relative './simplehelpprovider'
 
 class Wx::HelpControllerHelpProvider < Wx::SimpleHelpProvider

data/lib/wx/core/helpprovider.rb

@@ -1,5 +1,14 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Base class for providing context-sensitive help. The main definition
-# is in SWIG/C++ 
+# is in SWIG/C++
+
 class Wx::HelpProvider
   class << self
     # We need to protect the currently set HelpProvider from GC as it is a

data/lib/wx/core/icon.rb

@@ -1,3 +1,11 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Specific type of platform-dependent image used for frames on Windows and
 # Linux. Normally Bitmap is used
 
@@ -19,13 +27,13 @@ module Wx
 
     def to_bitmap
       # for WXMSW platform Icon is not derived from Bitmap
-      return self unless Wx::PLATFORM == 'WXMSW' || Wx::PLATFORM == 'WXOSX'
+      return self unless Wx::PLATFORM == 'WXMSW'
       bm = Wx::Bitmap.new
       bm.copy_from_icon(self)
       bm
     end
 
-    if Wx::PLATFORM == 'WXMSW' || Wx::PLATFORM == 'WXOSX'
+    if Wx::PLATFORM == 'WXMSW'
       def convert_to_image
         to_bitmap.convert_to_image
       end
@@ -50,10 +58,13 @@ module Wx
     end
   end
 
-  def self.Icon(name, bmp_type = nil, *rest)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
-    art_owner = File.basename(caller_path, '.*')
-    art_file = ArtLocator.find_art(name, art_type: :icon, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
+  def self.Icon(name, bmp_type = nil, *rest, art_path: nil, art_section: nil)
+    unless art_path && art_section
+      caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path
+      art_path = File.dirname(caller_path) unless art_path
+      art_section = File.basename(caller_path, '.*') unless art_section
+    end
+    art_file = ArtLocator.find_art(name, art_type: :icon, art_path: art_path, art_section: art_section, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Icon" unless art_file
     Icon.new(art_file, bmp_type, *rest)
   end

data/lib/wx/core/id_helper.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 module Wx
 

data/lib/wx/core/image.rb

@@ -1,5 +1,14 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # A platform-independent image; can be manipulated more extensively than
 # Bitmap, but must be converted to a Bitmap for drawing.
+
 module Wx
   class Image
 
@@ -66,12 +75,48 @@ module Wx
     def convert_to_bitmap
       Wx::Bitmap.from_image(self)
     end
+
+    module Histogram
+
+      def make_key(r, g, b)
+        (r << 16) | (g << 8) | b
+      end
+
+      def find_first_unused_colour(r=1, g=0, b=0)
+        while self.has_key?(make_key(r,g,b))
+          if r >= 254
+            r = 0
+            if g >= 254
+              return nil if b >= 254
+              g = 0
+              b += 1
+            else
+              g += 1
+            end
+          else
+            r += 1
+          end
+        end
+        [r, g, b]
+      end
+
+    end
+
+    wx_compute_histogram = instance_method :compute_histogram
+    define_method :compute_histogram do
+      hist_hash = wx_compute_histogram.bind(self).call
+      hist_hash.extend Histogram
+      hist_hash
+    end
   end
 
-  def self.Image(name, bmp_type = nil, *rest)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
-    art_owner = File.basename(caller_path, '.*')
-    art_file = ArtLocator.find_art(name, art_type: :image, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
+  def self.Image(name, bmp_type = nil, *rest, art_path: nil, art_section: nil)
+    unless art_path && art_section
+      caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path
+      art_path = File.dirname(caller_path) unless art_path
+      art_section = File.basename(caller_path, '.*') unless art_section
+    end
+    art_file = ArtLocator.find_art(name, art_type: :image, art_path: art_path, art_section: art_section, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Image" unless art_file
     Image.new(art_file, bmp_type, *rest)
   end

data/lib/wx/core/imagelist.rb

@@ -1,10 +1,17 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 class Wx::ImageList
 
   # provide seamless support for adding icons on all platforms
   wx_add = instance_method :add
   define_method :add do |*args|
-    if Wx::Icon === args.first
+    if Wx::PLATFORM == 'WXMSW' && args.size == 1 && Wx::Icon === args.first
       args[0] = args.first.to_bitmap
     end
     wx_add.bind(self).call(*args)

data/lib/wx/core/listbox.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 require_relative './controlwithitems'
 

data/lib/wx/core/listctrl.rb

@@ -1,10 +1,34 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # Multi-item control with numerous possible view styles
+
 class Wx::ListCtrl
   # Make these ruby enumerables so find, find_all, map are available 
   include Enumerable
   # Passes each valid item index into the passed block
-  def each
-    0.upto(item_count - 1) { | i | yield i }
+  def each(&block)
+    if block_given?
+      0.upto(item_count - 1) { | i | block.call(i) }
+    else
+      ::Enumerator.new { |y| each { | i | y << i } }
+    end
+  end
+
+  def each_selected(&block)
+    if block_given?
+      item = -1
+      while (item = get_next_item(item, Wx::LIST_NEXT_ALL, Wx::LIST_STATE_SELECTED)) >= 0
+        block.call(item)
+      end
+    else
+      ::Enumerator.new { |y| each_selected { | i | y << i } }
+    end
   end
 
   # Returns an Array containing the indexes of the currently selected
@@ -19,15 +43,4 @@ class Wx::ListCtrl
     selections
   end
 
-  # # Stub version for LC_VIRTUAL controls that does nothing; may be
-  # # overridden in subclasses.
-  # def on_get_item_attr(i)
-  #   nil
-  # end
-  #
-  # # Stub version for LC_VIRTUAL|LC_REPORT controls that does nothing;
-  # # may be overridden in subclasses.
-  # def on_get_item_column_image(i, col)
-  #   -1
-  # end
 end

data/lib/wx/core/locale.rb

@@ -1,3 +1,11 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 class Wx::Locale
   class << self
     def get_system_language_name

data/lib/wx/core/log.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 module Wx
 
@@ -14,7 +21,114 @@ module Wx
       alias :timestamp= :set_timestamp
       alias :verbose :get_verbose
       alias :verbose= :set_verbose
+
+      def set_component(comp)
+        @component = comp ? comp.to_s : comp
+      end
+      private :set_component
+
+      def component
+        @component
+      end
+
+      def for_component(comp, &block)
+        old_comp = component
+        set_component(comp)
+        begin
+          block.call if block_given?
+        ensure
+          set_component(old_comp)
+        end
+      end
+
+    end
+
+  end
+
+  class LogChain
+
+    wx_initialize = instance_method :initialize
+    define_method :initialize do |new_log|
+      wx_initialize.bind(self).call(new_log)
+      @new_log = new_log # cache to prevent premature GC collection; old_log managed in C++ wrapper
+    end
+
+    wx_set_log = instance_method :set_log
+    define_method :set_log do |new_log|
+      wx_set_log.bind(self).call(new_log)
+      @new_log = new_log # cache to prevent premature GC collection; old_log managed in C++ wrapper
+    end
+    alias :log= :set_log
+
+  end
+
+  class << self
+
+    def setup_log_info(fmt, args, filename, line, func, component)
+      # as wxRuby apps will ever only log from the main thread the only reason why
+      # log info data may be retained beyond the execution scope of the current
+      # log action is because of log repetition counting which will retain the
+      # first log info instance of a repeating message sequence
+
+      # format message
+      msg = fmt % args
+      log_info = {
+        filename: if filename
+                    filename.to_s
+                  else
+                    filename
+                  end,
+        line: line,
+        func: if func
+                func.to_s
+              else
+                func
+              end,
+        component: if component
+                     component.to_s
+                   else
+                     Log.component
+                   end
+      }
+      if Wx::Log.get_repetition_counting && @last_msg != msg
+        # refresh cache
+        @last_msg = msg
+        @last_info = log_info
+      end
+      [msg, log_info]
+    end
+    private :setup_log_info
+
+    wx_log_generic = self.instance_method :log_generic
+    define_method :log_generic do |lvl, fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_generic.bind(self).call(lvl, *setup_log_info(fmt, args, filename, line, func, component))
+    end
+
+    wx_log_info = self.instance_method :log_info
+    define_method :log_info do |fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_info.bind(self).call(*setup_log_info(fmt, args, filename, line, func, component))
+    end
+
+    wx_log_verbose = self.instance_method :log_verbose
+    define_method :log_verbose do |fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_verbose.bind(self).call(*setup_log_info(fmt, args, filename, line, func, component))
     end
+
+    wx_log_message = self.instance_method :log_message
+    define_method :log_message do |fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_message.bind(self).call(*setup_log_info(fmt, args, filename, line, func, component))
+    end
+
+    wx_log_warning = self.instance_method :log_warning
+    define_method :log_warning do |fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_warning.bind(self).call(*setup_log_info(fmt, args, filename, line, func, component))
+    end
+
+    wx_log_error = self.instance_method :log_error
+    define_method :log_error do |fmt, *args, filename: nil, line: 0, func: nil, component: nil|
+      wx_log_error.bind(self).call(*setup_log_info(fmt, args, filename, line, func, component))
+    end
+
   end
 
 end

data/lib/wx/core/menu.rb

@@ -1,4 +1,13 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # A single labelled list within a drop-down menu, or a popup menu
+
 class Wx::Menu
 
   alias :wx_initialize :initialize

data/lib/wx/core/menu_bar.rb

@@ -1,3 +1,10 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
 
 class Wx::MenuBar
 

data/lib/wx/core/menuitem.rb

@@ -1,4 +1,13 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# 
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
 # An individual item within a frame or popup menu
+
 class Wx::MenuItem
   # Get the Wx id, not Ruby's deprecated Object#id
   alias :id :get_id