gloox 0.1 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80dc33a83d1cefb944faedb5ce6226c9cdae8c6ddf29d65d90ad0c758f2940bb
-  data.tar.gz: d931ba3575cb52360374b0c3ed6ce65164a00eafb01f5f967ac7a43a69460638
+  metadata.gz: eccb784208387659ae3be5e58844eb75e4e140bf9baeb9779a55e99d1f7a24b4
+  data.tar.gz: a5efd4428b5b4817a625358ec2762230c670e21a8c70b6d4f569dce452e306e8
 SHA512:
-  metadata.gz: f26d5ff881ce062b70bf478ef7e056fae8c1e989216d1dbd34ea14935df655bc70e63c614790e07604952fb65d5399bcc67502d3f761d333e6b8da1dc6990e0f
-  data.tar.gz: 31d045c3fb13018903580ff249fc1b83d8b90101eb4465da0d606817f449e5bc3e038a278ddccc0d81da9ba61dd335b092539c799fc1d3bcd25dfa19aade5209
+  metadata.gz: c2a1c23e5d171d8ecd457f0e4073b689f1601fddb49f7d3b07e3346dc41f9d7a4f7ec496e8a7c74c4aa9c87164ab34c5aafa3ceb92f7e34dd599612f279b5080
+  data.tar.gz: adc38b3f34f3db15d92f0c75192e7e340d9a97ca334a0b08dab002087903c542c7f43e9821125fcaf1edd4f2c069148802e77a678ed5b1d1a33695a4cb36ce05

data/Gemfile

@@ -16,10 +16,20 @@ group :prof do
     gem 'memory_profiler'
 end
 
-gem "toq", path: '../toq'
-gem "slotz", path: '../slotz'
-gem "tiq", path: '../tiq'
-gem "raktr", path: '../raktr'
-gem 'msgpack'
+if File.exist? '../toq'
+    gem "toq", path: '../toq'
+end
+
+if File.exist? '../slotz'
+    gem "slotz", path: '../slotz'
+end
+
+if File.exist? '../tiq'
+    gem "tiq", path: '../tiq'
+end
+
+if File.exist? '../raktr'
+    gem "raktr", path: '../raktr'
+end
 
 gemspec

data/README.md

@@ -1,78 +1,122 @@
 # GlooX (pronounced _glue-X_)
 
-Bringing [Qadron](https://github.com/qadron) together, as a very special glue.
+**An effort to make distributed computing a joy!**
 
-## Agents
+**Do you really need more, or could you do away with less?**
 
-`GlooX::Agent` offers _Agent_ representations, _server-side_ presences if you must,
-of armed `Tiq::Nodes`.
+**Lean and mean never fails.**
+
+**Introducing GlooX, your new "cloud" taming solution, under Mozilla Public License v2.**
+
+_Bringing [Qadron](https://github.com/qadron) together, as a very special glue._
+
+## Table of Contents
+
+- [GlooX::Node](#nodes) `<` [Tiq::Node](https://github.com/qadron/tiq)
+  - [Add-ons](#add-ons)
+  - [Groups](#groups)
+- [Provisioning](#provisioning)
+- [Security](#security)
+
+## Nodes
+
+`GlooX::Node` offers _Node_ representations, _server-side_ presences if you must,
+of armed `Tiq::Node`s.
 
 They allow for spawning/loading of Processes on remote Nodes, with auto load-balancing
 across their Grid.
 
+`demo.rb:`
 ```ruby
 require 'gloox'
 
-# Start off with two Agents, in a Grid of their own
-agent  = GlooX::Agent.new( url: 'localhost:9997' ).start
-agent2 = GlooX::Agent.new( url: 'localhost:9999', peer: 'localhost:9997' ).start
+# Setup a Grid of 2, the children will load-balance and connect to the most available node.
+node = GlooX::Node.new( url: '0.0.0.0:9997' )
+node.start
+
+node2 = GlooX::Node.new( url: '0.0.0.0:9999', peer: '0.0.0.0:9997' )
+node2.start
 
-# Connect over the network for RPC.
-c = Tiq::Client.new( agent2.url )
+# Switchover to network communication over RPC.
+c = GlooX::Client.new( url: node2.url )
 
-p c.spawn(
+c.spawn(
   'Child',
-  "#{File.dirname(__FILE__)}/test/child.rb",
-  { e: 27 } # Global options set for the spawned Child.
+  "#{File.dirname(__FILE__)}/child.rb",
+  { url: '0.0.0.0:8888', parent_url: '0.0.0.0:9999', daemonize: true }
 )
 
-p c.utilization
-# => 0.7281599728827168
+# Setup the client-side child communication over RPC.
+child_client = GlooX::Client.new( url: '0.0.0.0:8888' )
 
-p "--- #{c.preferred}"
-#=> localhost:9997
+# Call the child-implemented method over RPC.
+p child_client.all_well?
+# => :yes!
 ```
 
+`child.rb:`
 ```ruby
+require 'gloox'
+
 p $options
-class Child
-    Slotz::Reservation.provision( self,
-        disk:   1 * 1_000_000_000, # bytes
-        memory: 20 * 1_000_000_000 # bytes
-)
+# => {:url=>"localhost:8888", :parent_url=>"localhost:9999", :ppid=>846068, :tmpdir=>"/tmp", :execute=>true}
+
+class Child < GlooX::Node
+    Slotz::Reservation.provision(
+      self,
+      disk:   1 * 1_000_000_000, # bytes
+      memory: 1 * 1_000_000_000 # bytes
+    )
+
+    def all_well?
+        :yes!
+    end
 end
+
+# Time to execute, sniff was taken care of on prior file inclusion.
+return unless $execute
+
+# Start the child-node server, not included in the Grid, only given its own bind URL.
+c = Child.new( url: $options[:url] )
+c.start
+
+# Setup communication to the parent.
+parent = GlooX::Client.new( url: $options[:parent_url] )
+
+p parent.alive?
+# => true
 ```
 
 ### Add-ons
 
 For the _Add-on_ feature see [Tiq](https://github.com/qadron/tiq?tab=readme-ov-file#add-ons).
 
-## Groups
+### Groups/Channels
 
-You can group and/or assing duty/purpose to your _Agents_ by creating channels/shared structures across them.
+You can group and/or assign duty/purpose to your _Nodes_ by creating channels/shared structures across them.
 
-There is one such example below, where two Agents share a group named `my_agents`, in addition to the group `data`, 
-used for internal purposes.
+There is one such example below, where two Nodes share a group named `my_nodes`, in addition to the group `channel`, 
+used for initial/internal purposes.
 
 ```ruby
 require 'gloox'
 
-n1 = GlooX::Agent.new( url: "localhost:9999" ).start
-n2 = GlooX::Agent.new( url: "localhost:9998", peer: 'localhost:9999' ).start
+n1 = GlooX::Node.new( url: "0.0.0.0:9999" ).start
+n2 = GlooX::Node.new( url: "0.0.0.0:9998", peer: '0.0.0.0:9999' ).start
 
 # Add as many groups/channels/shared-data structures as you want.
-n1.create_group_handler 'my_agents'
+n1.create_channel 'my_nodes'
 sleep 1
 
-n2.my_agents.on_set :a1 do |k, v|
+n2.my_nodes.on_set :a1 do |k, v|
     p "#{k} => #{v}"
     # => "a1 => 99"
 end
 
-n1.my_agents.set :a1, 99
+n1.my_nodes.set :a1, 99
 sleep 1
 
-p n2.my_agents.get :a1
+p n2.my_nodes.get :a1
 # => 99
 ```
 
@@ -99,9 +143,17 @@ end
 All communications are TLS encrypted by default, using [Raktr](https://github.com/qadron/raktr) to facilitate network
 communications for RPC, with RPC being offered by [Toq](https://github.com/qadron/toq).
 
-4 environment variables will have you sleeping safe and sound:
+7 environment variables will have you sleeping safe and sound:
+
+* Certificate Authority (`RAKTR_TLS_CA`)
+* Server
+  * Certificate (`RAKTR_TLS_SERVER_CERTIFICATE`)
+  * Private Key (`RAKTR_TLS_SERVER_PRIVATE_KEY`)
+  * Public Key (`RAKTR_TLS_SERVER_PUBLIC_KEY`)
+* Client
+  * Certificate (`RAKTR_TLS_CLIENT_CERTIFICATE`)
+  * Private Key (`RAKTR_TLS_CLIENT_PRIVATE_KEY`)
+  * Public Key (`RAKTR_TLS_CLIENT_PUBLIC_KEY`)
 
-* Certificate Authority (RAKTR_TLS_CA)
-* Private Key (RAKTR_TLS_PRIVATE_KEY)
-* Public Key (RAKTR_TLS_PUBLIC_KEY)
-* Certificate (RAKTR_TLS_CERTIFICATE)
+Helper:
+https://raw.githubusercontent.com/qadron/raktr/refs/heads/master/spec/support/fixtures/pems/generate-tls-certs.sh

data/gloox.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |s|
     s.date              = Time.now.strftime( '%Y-%m-%d' )
     s.summary           = ''
 
-    s.homepage          = 'https://github.com/qadron/cuboid'
+    s.homepage          = 'https://github.com/qadron/gloox'
     s.email             = 'tasos.laskos@gmail.com'
     s.authors           = [ 'Tasos Laskos' ]
     s.licenses          = ['MPL v2']
@@ -27,9 +27,9 @@ Gem::Specification.new do |s|
 
     s.add_dependency 'awesome_print',       '1.9.2'
     s.add_dependency 'bundler'
+    s.add_dependency 'msgpack'
     s.add_dependency 'slotz'
     s.add_dependency 'tiq'
-    s.add_dependency 'toq'
 
     s.description = <<DESCRIPTION
 DESCRIPTION

data/lib/gloox/client.rb

@@ -0,0 +1,12 @@
+require 'tiq'
+
+module GlooX
+class Client < Tiq::Client
+    attr_reader :url
+
+    def initialize( options = {} )
+        super( options[:url], options )
+    end
+
+end
+end

data/lib/gloox/{agent.rb → node.rb}

@@ -2,8 +2,8 @@ require 'slotz'
 require 'tiq'
 
 module GlooX
-class Agent < Tiq::Node
-    PREFERENCE_STRATEGIES = Set.new([:horizontal, :vertical, :direct])
+class Node < Tiq::Node
+    PREFERENCE_STRATEGIES = Set.new([nil, :horizontal, :vertical, :direct])
 
     def initialize(*)
         super
@@ -11,15 +11,15 @@ class Agent < Tiq::Node
         @loader = Slotz::Loader.new
     end
 
-    def spawn( *args )
+    def spawn( *args, &block )
         probable_strategy = args.shift
         strategy = probable_strategy.to_s.to_sym
 
         if PREFERENCE_STRATEGIES.include? strategy
-            spawn2( strategy, *args )
+            spawn2( strategy, *args, &block )
         else
             args.unshift probable_strategy
-            spawn2( nil, *args )
+            spawn2( nil, *args, &block )
         end
 
         nil
@@ -81,10 +81,16 @@ class Agent < Tiq::Node
 
     private
 
-    def spawn2( strategy = nil, *args )
+
+    def spawn2( strategy = nil, *args, &block )
         if !grid_member?
-            @loader.load( *args )
-            return
+            pid = @loader.load( *args )
+
+            if block_given?
+                block.call pid
+                return
+            end
+            return pid
         end
 
         preferred strategy do |preferred_url|
@@ -93,14 +99,17 @@ class Agent < Tiq::Node
             end
 
             if preferred_url == @url
-                @loader.load( *args )
-                next
+                pid = @loader.load( *args )
+                block.call pid if block_given?
+                return pid
             end
 
-            connect_to_peer( preferred_url ).spawn( :direct, *args ) {}
+            connect_to_peer( preferred_url ).spawn( :direct, *args, &block )
         end
 
         nil
+    rescue => e
+        ap e
     end
 end
 end

data/lib/gloox/utilities.rb

@@ -0,0 +1,28 @@
+module Gloox
+module Utilities
+
+    def self.available_port_mutex
+        @available_port_mutex ||= Mutex.new
+    end
+    available_port_mutex
+
+    def available_port( range = nil )
+        available_port_mutex.synchronize do
+            loop do
+                port = self.random_port( range )
+                return port if port_available?( port )
+            end
+        end
+    end
+
+    def random_port( range = nil )
+        range ||= [1025, 65535]
+        first, last = range
+        range = (first..last).to_a
+
+        range[ rand( range.last - range.first ) ]
+    end
+
+end
+end
+

data/lib/gloox/version.rb

@@ -1,3 +1,3 @@
 module GlooX
-    VERSION = '0.1'
+    VERSION = '0.3'
 end

data/lib/gloox.rb

@@ -1,4 +1,6 @@
-require_relative 'gloox/agent'
+module GlooX
+    require_relative 'gloox/utilities'
+    require_relative 'gloox/client'
+    require_relative 'gloox/node'
 
-module Gloox
 end

data/spec/gloox/groups_spec.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'GlooX Groups' do
+  let(:node1) { GlooX::Node.new(url: 'localhost:9999').start }
+  let(:node2) { GlooX::Node.new(url: 'localhost:9998', peer: 'localhost:9999').start }
+
+  before do
+    node1.create_channel('my_nodes')
+    sleep 1
+  end
+
+  after do
+      node1.stop
+      node2.stop
+      sleep 2
+  end
+
+  it 'shares data between nodes in a group' do
+    node2.my_nodes.on_set(:a1) { |k, v| @result = "#{k} => #{v}" }
+    node1.my_nodes.set(:a1, 99)
+    sleep 1
+    expect(@result).to eq('a1 => 99')
+  end
+end

data/spec/gloox/node_spec.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe GlooX::Node do
+  let(:node_port) { 9999 }
+  let(:node) { described_class.new(url: "0.0.0.0:#{node_port}" ) }
+  let(:spawn_options) do
+      [
+        'MyNode',
+        "#{File.dirname(__FILE__)}/../support/fixtures/child_node.rb",
+        { url: '0.0.0.0:8888' }
+      ]
+  end
+
+  before :each do
+      node.start
+  end
+  after :each do
+      node.shutdown
+      sleep 2
+  end
+
+  describe '#start' do
+    it 'starts the node successfully' do
+      expect { node }.not_to raise_error
+    end
+  end
+
+  describe '#spawn' do
+    it 'spawns a process with default strategy' do
+        pending
+      expect { node.spawn( *spawn_options ) }.not_to raise_error
+    end
+
+    it 'spawns a process with default strategy' do
+      node.spawn( *spawn_options )
+      sleep 1
+
+      client = Tiq::Client.new( 'localhost:8888' )
+      expect(client.alive?).to be_truthy
+    end
+
+    it 'raises an error for an unknown strategy' do
+        pending
+        expect { node.spawn(:unknown, 'Child', 'child.rb', { e: 27 }) }.to raise_error(ArgumentError, /Unknown strategy/)
+    end
+  end
+
+  describe '#utilization' do
+    it 'returns the current utilization' do
+      expect(node.utilization).to be_a(Float)
+    end
+  end
+
+  describe '#preferred' do
+    context 'with a valid strategy' do
+      it 'returns the preferred URL' do
+        node.start
+        node.preferred(:horizontal) do |url|
+          expect(url).to eq('localhost:9997')
+        end
+      end
+    end
+
+    context 'with an invalid strategy' do
+      it 'raises an error' do
+        expect do
+          node.preferred(:invalid) {}
+        end.to raise_error(ArgumentError, /Unknown strategy/)
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'rspec'
+require 'gloox'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+end

data/spec/support/fixtures/child_node.rb

@@ -0,0 +1,8 @@
+require 'gloox'
+
+class MyNode < Tiq::Node
+end
+
+return unless $execute
+
+my_node = MyNode.new( url: $options[:url] ).server.start

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: gloox
 version: !ruby/object:Gem::Version
-  version: '0.1'
+  version: '0.3'
 platform: ruby
 authors:
 - Tasos Laskos
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-25 00:00:00.000000000 Z
+date: 2026-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -39,7 +38,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: slotz
+  name: msgpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +52,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tiq
+  name: slotz
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +66,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: toq
+  name: tiq
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -85,21 +84,26 @@ email: tasos.laskos@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.md
 - LICENSE.md
+- README.md
 files:
 - Gemfile
 - LICENSE.md
 - README.md
 - gloox.gemspec
 - lib/gloox.rb
-- lib/gloox/agent.rb
+- lib/gloox/client.rb
+- lib/gloox/node.rb
+- lib/gloox/utilities.rb
 - lib/gloox/version.rb
-homepage: https://github.com/qadron/cuboid
+- spec/gloox/groups_spec.rb
+- spec/gloox/node_spec.rb
+- spec/spec_helper.rb
+- spec/support/fixtures/child_node.rb
+homepage: https://github.com/qadron/gloox
 licenses:
 - MPL v2
 metadata: {}
-post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -115,8 +119,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: ''
-test_files: []
+test_files:
+- spec/gloox/groups_spec.rb
+- spec/gloox/node_spec.rb
+- spec/spec_helper.rb
+- spec/support/fixtures/child_node.rb