fxruby-enhancement 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 815c35e0699b8a7cb0bc90b27f21789751af71fd
-  data.tar.gz: c9cc4a024a7493888bc3e27ec96a319e1b8a1a63
+  metadata.gz: d3c7b8e5a27a1d979f10f9f7111b0c1dab700078
+  data.tar.gz: 2ecedc52cf7ec206590c7cc0a4646cd4c8f36c40
 SHA512:
-  metadata.gz: 5e6d8150e9bb259e6bf9b12c63a1e874e6ebcc9ead1594cfc5cf0fd0f12d307e712bdfbe6cd92ba0ec68cfb98c8b0847ddc0430c63fe1337b0c756436a0ce304
-  data.tar.gz: 36efe40ce1f47ab9d7a4623ede142171856c4648e45ba1a7c51bdfb67151774d7d35c615c0d7b57fa833a8fd4f0167f3ff637ed3ae3288cd17fc60e1c9230a41
+  metadata.gz: 960a428b033f972f812d4c4c28fa3932b2cc7322b6f3109230727c7a257697b2092f44d4123361cdbbcb96f4734481e6b3d67f22e57fbf0301c3e1eb2c66129b
+  data.tar.gz: f34e2d2b3e1363e63dec4be1b04f9131e16af4f9c08063db207aa7c5e9ff317a20c329a1c86e8a7ab1ec8c5bc295c72c3dbeb4bc8908cc5345a6c5f76b8570e1

data/.semver

@@ -1,6 +1,5 @@
 ---
 :major: 0
 :minor: 0
-:patch: 2
+:patch: 3
 :special: ''
-:metadata: ''

data/Gemfile.lock

@@ -6,7 +6,7 @@ GEM
     awesome_print (1.7.0)
     binding_of_caller (0.7.2)
       debug_inspector (>= 0.0.1)
-    builder (3.2.2)
+    builder (3.2.3)
     byebug (9.0.6)
     coderay (1.1.1)
     debug_inspector (0.0.2)
@@ -28,7 +28,7 @@ GEM
     hashie (3.4.6)
     highline (1.7.8)
     interception (0.5)
-    json (2.0.2)
+    json (2.0.3)
     juwelier (2.3.4)
       builder
       bundler (>= 1.13)
@@ -103,7 +103,7 @@ GEM
     simplecov-html (0.10.0)
     slop (3.6.0)
     thread_safe (0.3.5)
-    yard (0.9.7)
+    yard (0.9.8)
 
 PLATFORMS
   ruby

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2016 Fred Mitchell
+Copyright (c) 2016-2017 Fred Mitchell
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.org

@@ -1,5 +1,5 @@
 #+OPTIONS: broken-links:mark
-* Table of Contents                                                     :TOC_5_gh:
+* FXRuby Enhancement Table of Contents                             :TOC_5_gh:
  - [[#fxruby-enhancement][fxruby-enhancement]]
    - [[#introduction][Introduction]]
    - [[#installation][Installation]]
@@ -13,15 +13,15 @@
        - [[#the-queue_ding-queues][The Queue_Ding Queues]]
          - [[#enhancementingress][Enhancement.ingress]]
          - [[#enhancementegress][Enhancement.egress]]
-       - [[#api--dsl][API & DSL]]
-         - [[#ref-refc-and-tagging-your-objects][ref(), refc() and tagging your objects]]
-         - [[#fox_component-and-fox_instance][fox_component and fox_instance]]
-         - [[#fx_app][fx_app]]
-         - [[#instance][instance]]
-         - [[#ingress_handler][ingress_handler]]
-         - [[#deferred_setup][deferred_setup]]
-         - [[#mapping-between-fx_-declarations-and-the-fx-fxruby-objects][Mapping between fx_* declarations and the FX* FXRuby objects]]
-         - [[#bindingfx][binding.fx]]
+     - [[#api--dsl][API & DSL]]
+       - [[#ref-refc-and-tagging-your-objects][ref(), refc() and tagging your objects]]
+       - [[#fox_component-and-fox_instance][fox_component and fox_instance]]
+       - [[#fx_app][fx_app]]
+       - [[#instance][instance]]
+       - [[#ingress_handler][ingress_handler]]
+       - [[#deferred_setup][deferred_setup]]
+       - [[#mapping-between-fx_-declarations-and-the-fx-fxruby-objects][Mapping between fx_* declarations and the FX* FXRuby objects]]
+       - [[#bindingfx][binding.fx]]
      - [[#examples][Examples]]
        - [[#hello-world-example-full-the-enhancement-way][Hello World example (full) the Enhancement Way]]
        - [[#hello-world-the-old-fxruby-way][Hello World the old fxruby way:]]
@@ -36,10 +36,10 @@
 
 * fxruby-enhancement
 ** Introduction
-   The fxruby library is an excellent wrapper for the FOX toolkit.
+   The fxruby library is an excellent wrapper for the FOX Toolkit.
    However, it reflects the C++-ness of FOX, rather than being more
    Ruby-like. As such, creating composed objects with it tends to be
-   rather ugly and cumbersome. For every new component you create with
+   rather cumbersome, given its C++ roots. For every new component you create with
    fxruby, you are handed back a reference to that object, which you'll
    need to store somewhere. And then all the subsequent child objects
    will need to be passed pointers to the parent objects.
@@ -75,7 +75,7 @@
    will automatically include it. However fxruby has a c-extension
    that must compile properly on your system. Normally, this is not
    a concern, but it is something to be aware of.
-
+   
 ** Documentation
 *** In General
     fxruby-enhancement (which we will refer to as "Enhancement" from time
@@ -219,114 +219,186 @@
       #+begin_src
       #+end_src
 
-**** API & DSL
-***** ref(), refc() and tagging your objects
-      In an effort to eliminate the fuss and bother with
-      scoping issues and object reference, ref(:some_tag) will
-      retrive the FXRuby instance object so tagged with :some_tag.
-
-      You may have anonymous, i.e., untagged objects, and those will
-      not be findable by ref(). It is not necessary to tag all objects,
-      either.
-
-      refc() is similar to ref(), except it retrives the underlying 
-      component object insted. Indeed, the following are equivalent
-      operations:
-      #+begin_src ruby
-      ref(:some_tag)
-      refc(:some_tag).inst
-      #+end_src
-
-      There may be some edge cases where you might want to
-      reference the underlying component ahead of FXRuby object
-      instaniation, but in the vast majority of the cases, it should
-      be unnecessary. My goal is to enable to do what you need, not
-      to restrict you. You may need it for debugging, etc.
-
-      Underlying, the component object is really a subclass of OpenScript.
-      While you may like to stuff some additional data there, 
-      this is frowned upon because it might conflict with Enhancement.
-      If you have a need for this, please do a issue in GitHub.
-
-***** fox_component and fox_instance
-      fox_component and fox_instance are roughly the
-      equivalent of refc() and ref(), respecively. The
-      difference mainly being that fox_component does no
-      sanity checking, and is therefore slightly faster.
-
-      At some point, they may be merged, but for now don't 
-      count on it.
-
-      To initialize and run your app, you customairly do the
-      following:
-      #+begin_src ruby
-      fox_component :app do |app|
-        app.launch
-      end
-      #+end_src
-
-      Which presumes your fx_app declaration was tagged with
-      :app as follows:
-      #+begin_src ruby
-      fx_app :app do
-        app_name "Your Amazingly Cool Application"
-        vendor_name "YouDaMan"
-        ...
-      end
-      #+end_src
-
-      This is the only time you will reference the component
-      object directly for the obvious reason that you must start
-      from someonere.
-
-***** fx_app
-      To begin the declaration of your app, you must do the
-      following somewhere:
-      #+begin_src ruby
-      fx_app :app do
-        app_name "The Forbin Project"
-        vendor_name "Colossus"
-        ...
-      end
-      #+end_src
-
-      Typeically you'd do this inside of a module, but you could do it also
-      in a class body. Please see the examples.
-
-***** TODO instance
-***** TODO ingress_handler
-***** TODO deferred_setup
-***** TODO Mapping between fx_* declarations and the FX* FXRuby objects
-***** binding.fx   
-      This is a way to split up your layouts into different .fx "modules", purely for
-      organizational reasons. For example,
-
-      #+begin_src ruby
-      binding.fx "overview"
-      #+end_src
-
-      will load the overview.fx portion of the GUI, which happens to be a tab contents
-      in the tab book, which in our case looks like:
-
-      #+begin_src ruby
-      # Overview Tab
-
-      fx_tab_item { text "&Overview" }
-      fx_horizontal_frame (:overview_info) {
-        opts STD_FRAME|LAYOUT_FILL_Y
+*** API & DSL
+**** ref(), refc() and tagging your objects
+     In an effort to eliminate the fuss and bother with
+     scoping issues and object reference, ref(:some_tag) will
+     retrive the FXRuby instance object so tagged with :some_tag.
+
+     You may have anonymous, i.e., untagged objects, and those will
+     not be findable by ref(). It is not necessary to tag all objects,
+     either.
+
+     refc() is similar to ref(), except it retrives the underlying 
+     component object insted. Indeed, the following are equivalent
+     operations:
+     #+begin_src ruby
+     ref(:some_tag)
+     refc(:some_tag).inst
+     #+end_src
+
+     There may be some edge cases where you might want to
+     reference the underlying component ahead of FXRuby object
+     instaniation, but in the vast majority of the cases, it should
+     be unnecessary. My goal is to enable to do what you need, not
+     to restrict you. You may need it for debugging, etc.
+
+     Underlying, the component object is really a subclass of OpenScript.
+     While you may like to stuff some additional data there, 
+     this is frowned upon because it might conflict with Enhancement.
+     If you have a need for this, please do a issue in GitHub.
+
+**** fox_component and fox_instance
+     fox_component and fox_instance are roughly the
+     equivalent of refc() and ref(), respecively. The
+     difference mainly being that fox_component does no
+     sanity checking, and is therefore slightly faster.
+
+     At some point, they may be merged, but for now don't 
+     count on it.
+
+     To initialize and run your app, you customairly do the
+     following:
+     #+begin_src ruby
+     fox_component :app do |app|
+       app.launch
+     end
+     #+end_src
+
+     Which presumes your fx_app declaration was tagged with
+     :app as follows:
+     #+begin_src ruby
+     fx_app :app do
+       app_name "Your Amazingly Cool Application"
+       vendor_name "YouDaMan"
+       ...
+     end
+     #+end_src
+
+     This is the only time you will reference the component
+     object directly for the obvious reason that you must start
+     from someonere.
+
+**** fx_app
+     To begin the declaration of your app, you must do the
+     following somewhere:
+     #+begin_src ruby
+     fx_app :app do
+       app_name "The Forbin Project"
+       vendor_name "Colossus"
+       ...
+     end
+     #+end_src
+
+     Typeically you'd do this inside of a module, but you could do it also
+     in a class body. Please see the examples.
+
+**** instance
+     Inside of your component declaration, you will undoubtly
+     want to specify what you want to do once the FXRuby object
+     is actually instantiated. This is what the instance clause
+     will allow you to do. Your code block there will be passed
+     a reference to the FXRuby object, allowing you to set up
+     connections, change the component state, etc.
+
+     There are some added benefits as well. When making a connection,
+     with the normal FXRuby, you would do something like this:
+     #+begin_src ruby
+     ...
+     aButton.connect(SEL_COMMAND)  { |sender, selector, data|
+       ... code to handle this event ...
+     }
+     #+end_src
+
+     But with Enhancement, you would be able to do it thusly:
+     #+begin_src ruby
+     fx_button(:my_button) {
+       ... configs for this FXButton object ...
+       instance { |button|
+         button.sel_command { |sender, selector, data|
+           ... code to handle this event ...
+         }
+       }
+     }
+     #+end_src
+
+     which will make it feel more Ruby-like and less C++-like.
+
+**** ingress_handler
+     ingress_handler will allow you to set up the handler for
+     messages coming in from an external source to FXRuby thread,
+     such as RabbitMQ, network connections, databases, or anything else.
+     It allows you to do clean multhreaded Ruby without the normal worries
+     of semaphores and synchronization and the like -- it is all
+     handled for you "magically" behind the scenes!
+
+     You may have as many ingress_handlers specified as you like, as
+     each one needs to have a tag, and the tags are used to dispatch
+     the messages.
+
+     Here is an example taken from RubyNEAT Panel:
+     #+begin_src ruby
+     ingress_handler :status do |type, status|
+       suc, st = status.response
+      
+       wlist = ref :ov_conn_neaters_widget_list
+       wlist.clearItems
+       st[:neaters].each { |neater| wlist.appendItem neater }
+
+       nlist = ref :ov_conn_neurons_list
+       nlist.clearItems
+       st[:neurons].each { |neuron| nlist.appendItem neuron}
+     end
+     #+end_src
+     
+     Here you can see that a status message has been dispatched to 
+     this ingress_handler, and that the message contains a list of
+     'neaters' and 'neurons' that are being sent to the wlist
+     and nlist list (:ov_conn_neaters_widget_list and :ov_conn:_neurons_list),
+     respecively.
+
+     You may declare your ingress_handler anywhere in your code and have 
+     the expected happen.
+
+**** TODO deferred_setup
+**** TODO Mapping between fx_* declarations and the FX* FXRuby objects
+**** binding.fx   
+     This is a way to split up your layouts into different .fx "modules", purely for
+     organizational reasons. For example,
+
+     #+begin_src ruby
+     binding.fx "overview"
+     #+end_src
+
+     will load the overview.fx portion of the GUI, which happens to be a tab contents
+     in the tab book, which in our case looks like:
+
+     #+begin_src ruby
+     # Overview Tab
+
+     fx_tab_item { text "&Overview" }
+     fx_horizontal_frame (:overview_info) {
+       opts STD_FRAME|LAYOUT_FILL_Y
   
-        fx_group_box (:ov_connections_group) {
-          text "Connections"
-          opts STD_GROUPBOX|LAYOUT_FILL_Y
+       fx_group_box (:ov_connections_group) {
+         text "Connections"
+         opts STD_GROUPBOX|LAYOUT_FILL_Y
     
-          fx_vertical_frame {
-            opts LAYOUT_FILL_Y|LAYOUT_FILL_X #|PACK_UNIFORM_HEIGHT
+         fx_vertical_frame {
+           opts LAYOUT_FILL_Y|LAYOUT_FILL_X #|PACK_UNIFORM_HEIGHT
       
-            fx_group_box (:ov_conn_rabbitmq) {
-      ...
-      #+end_src
+           fx_group_box (:ov_conn_rabbitmq) {
+     ...
+     #+end_src
     
 *** Examples
+    Because this is a spinoff project of the ongoing RubyNEAT
+    effort, there is a splendid RubyNEAT Panel example, that
+    is still in the works. However, you are free to look at the
+    code that is there to get good ideas.
+
+    https://github.com/flajann2/rubyneat-panel/tree/master/lib/rubyneat-panel
+
     Class-based enhancement (this has not been tested yet!!!):
     #+begin_src ruby
     class Main < FXMainWindow
@@ -796,14 +868,16 @@ end
     More examples can be found [[file:examples][HERE]].
 
 ** Release Notes
-   | Version |       Date | Notes           |
-   |---------+------------+-----------------|
-   |   0.0.2 | 2017-01-11 | Initial release |
+   | Version |       Date | Notes                                                   |
+   |---------+------------+---------------------------------------------------------|
+   |   0.0.2 | 2017-01-11 | Initial release                                         |
+   |   0.0.3 | 2017-01-15 | Needed to require fox16/colors for FXColor to be loaded |
 
 ** Known Issues
-   | Version |       Date | Issues                     |
-   |---------+------------+----------------------------|
-   |   0.0.2 | 2017-01-11 | Not enough example code!!! |
+   | Version |       Date | Issues                                                |
+   |---------+------------+-------------------------------------------------------|
+   |   0.0.2 | 2017-01-11 | Not enough example code!!! Need more documentation!!! |
+
 
 ** Contributing to fxruby-enhancement
  

data/fxruby-enhancement.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: fxruby-enhancement 0.0.2 ruby lib
+# stub: fxruby-enhancement 0.0.3 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "fxruby-enhancement".freeze
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Fred Mitchell".freeze]
-  s.date = "2017-01-11"
+  s.date = "2017-01-15"
   s.description = "The fxruby library is an excellent wrapper for the FOX toolkit. However, it reflects the\n  C++-ness of FOX, rather than being more Ruby-like. As such, creating composed objects with\n  it tends to be rather ugly and cumbersome.\n\n  fxruby-enhancement is a wrapper for the wrapper, to \"rubyfy\" it and make it more easy to \n  use for Rubyists. \n\n  fxruby-enhancement is basically a DSL of sorts, and every effort has been taken to make \n  it intuitive to use. Once you get the hang of it, you should be able to look at the FXRuby\n  API documentation and infer the DSL construct for fxruby-enhancement.".freeze
   s.email = "fred.mitchell@gmx.de".freeze
   s.extra_rdoc_files = [

data/lib/fxruby-enhancement.rb

@@ -1,4 +1,5 @@
 require 'fox16'
+require 'fox16/colors'
 require 'ostruct'
 require 'awesome_print'
 require 'forwardable'

data/lib/fxruby-enhancement/enhancement.rb

@@ -57,7 +57,7 @@ module Fox
               @ingress_delay = @ms_ingress_delay_min
               until @ingress.empty?
                 dispatch_to, payload = @ingress.next
-                raise "Unknown dispatch #{dispatch_to}" unless @ingress_map.member? dispatch_to
+                raise "Unknown dispatch ':#{dispatch_to}'" unless @ingress_map.member? dispatch_to
                 @ingress_map[dispatch_to].(dispatch_to, payload)
               end
             else

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fxruby-enhancement
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Fred Mitchell
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-11 00:00:00.000000000 Z
+date: 2017-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: semver2