cuboid 0.1.3 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9533dcacaf536c3e740993765c95acabe9ef309f47d0ee9abb17057ba20248b
-  data.tar.gz: 0557ca182b8e7589dca448e75062bb87444716b6d36a7fc257d678efa7090fd3
+  metadata.gz: 99e1706f1f0771fae638ae08cf525077625255e3cda4b3a7ff09e92c192692c4
+  data.tar.gz: 77f486938d14f0f579ccc1d4f3f20d0265c9d3590095912c667d28494f03013b
 SHA512:
-  metadata.gz: 1ceff653d44e2821fc770c6913fdb9de57922bbfd809f20a043746c2c0f2ddb0103f1e77156bdb103047fd6770bf2968ad9183db5ad6bf623a73965848082be1
-  data.tar.gz: 96d5ef822e102d7200068b192ef9f4817d0dba02e4d01a8f83c6aaafa7d2d997947d170bee8a344d61f7657ad29d54e0d7b30042c874e5f53dade035a20f15c2
+  metadata.gz: 5bc2b6bcb5d51deeccb44292aebacca47ded75cafeff7085bb9c645a108a58524b6c0a89bd11f521ec58a7e40cf3565d1d4a3c8dd5e9b8fe880a2226c2575209
+  data.tar.gz: 031e775efa26dfc56d51823e8b00687a7727a72c22c78ab76b126b8fb2b7dc94ae79ea595a23eba3b2c1a121b08237adb542d4ad1783f38d9ebe4933eb7bb2ea

data/CHANGELOG.md

@@ -1,7 +1,10 @@
+# 0.1.5
+
+* Fixed relative path for application source path detection.
+
 # 0.1.3
 
-* `Agent`
-  * `#preferred`, `#spawn`: Replaced `load_balance` override with `direct` `strategy`.
+* Replaced `Arachni::RPC` and `Arachni::Reactor` with `Toq` and `Raktr`.
 
 # 0.1.0
 

data/README.md

@@ -30,7 +30,7 @@ It offers:
 * Developer freedom.
   * Apart from keeping _Data_ and _State_ separate not many other rules to follow.
     * Only if interested in _suspensions_ and can also be left to the last minute
-      if necessary -- in cases of Ractor enforced isolation  for example.
+      if necessary -- in cases of `Ractor` enforced isolation for example.
 
 ## Entities
 
@@ -144,7 +144,7 @@ _**Application**_ itself.
 
 A simple RPC is employed, specs for 3rd party implementations can be found at:
 
-https://github.com/Arachni/arachni-rpc/wiki
+https://github.com/toq/arachni-rpc/wiki
 
 Each _**Application**_ can extend upon this and expose an API via its _**Instance**_'s 
 RPC interface.
@@ -162,13 +162,130 @@ service's interface.
 
 ## Examples
 
-See `examples/`.
-
 ### MyApp
 
 Tutorial application going over different APIs and **Cuboid** _**Application**_
 options and specification.
 
+See `examples/my_app`.
+
+### Parallel code on same host
+
+To run code in parallel on the same machine utilising multiple cores, with each
+instance isolated to its own process, you can use something like the following:
+
+```ruby
+require 'cuboid'
+
+class Sleeper < Cuboid::Application
+
+    def run
+        sleep options['time']
+    end
+
+end
+
+return if $0 != __FILE__
+
+sleepers = []
+sleepers << Sleeper.spawn( :instance )
+sleepers << Sleeper.spawn( :instance )
+sleepers << Sleeper.spawn( :instance )
+
+sleepers.each do |sleeper|
+    sleeper.run( time: 5 )
+end
+
+sleep 0.1 while sleepers.map(&:busy?).include?( true )
+```
+
+    time bundle exec ruby same_host.rb
+    [...]
+    real    0m6,506s
+    user    0m0,423s
+    sys     0m0,063s
+
+### Parallel code on different hosts
+
+In this example we'll be using `Agents` to spawn instances from 3 different hosts.
+
+#### Host 1
+
+```ruby
+require 'cuboid'
+
+class Sleeper < Cuboid::Application
+
+    def run
+        sleep options['time']
+    end
+
+end
+
+return if $0 != __FILE__
+
+Sleeper.spawn( :agent, port: 7331 )
+```
+
+    bundle exec ruby multiple_hosts_1.rb
+
+#### Host 2
+
+```ruby
+require 'cuboid'
+
+class Sleeper < Cuboid::Application
+
+    def run
+        sleep options['time']
+    end
+
+end
+
+return if $0 != __FILE__
+
+Sleeper.spawn( :agent, port: 7332, peer: 'host1:7331' )
+```
+
+    bundle exec ruby multiple_hosts_2.rb
+
+#### Host 3
+
+```ruby
+require 'cuboid'
+
+class Sleeper < Cuboid::Application
+
+    def run
+        sleep options['time']
+    end
+
+end
+
+return if $0 != __FILE__
+
+grid_agent = Sleeper.spawn( :agent, port: 7333, peer: 'host1:7331' )
+
+sleepers = []
+3.times do
+    connection_info = grid_agent.spawn
+    sleepers << Sleeper.connect( connection_info )
+end
+
+sleepers.each do |sleeper|
+    sleeper.run( time: 5 )
+end
+
+sleep 0.1 while sleepers.map(&:busy?).include?( true )
+```
+
+    time bundle exec ruby multiple_hosts_3.rb
+    real    0m7,318s
+    user    0m0,426s
+    sys     0m0,091s
+
+
+_You can replace `host1` with `localhost` and run all examples on the same terminal._
 
 ## License
 

data/Rakefile

@@ -55,3 +55,20 @@ task :clean do
     files.each { |file| puts "  * #{file}" }
     FileUtils.rm files
 end
+
+desc 'Build the gem.'
+task build: [ :clean ] do
+    sh "gem build cuboid.gemspec"
+end
+
+desc 'Build and install the gem.'
+task install: [ :build ] do
+    sh "gem install cuboid-#{Cuboid::VERSION}.gem"
+end
+
+desc 'Push a new version to Rubygems'
+task publish: [ :build ] do
+    sh "git tag -a v#{Cuboid::VERSION} -m 'Version #{Cuboid::VERSION}'"
+    sh "gem push cuboid-#{Cuboid::VERSION}.gem"
+end
+task release: [ :publish ]

data/cuboid.gemspec

@@ -53,7 +53,7 @@ Gem::Specification.new do |s|
     s.add_dependency 'sinatra-contrib',     '2.1.0'
 
     # RPC client/server implementation.
-    s.add_dependency 'arachni-rpc',         '~> 0.2.1.4'
+    s.add_dependency 'toq',                 '~> 0.0.1'
 
     s.add_dependency 'vmstat',              '2.3.0'
     s.add_dependency 'sys-proctable',       '1.1.5'

data/lib/cuboid/application.rb

@@ -174,7 +174,7 @@ class Application
                 last_const = last_const.const_get( const_name.to_sym )
             end
 
-            last_const.const_source_location( app.to_sym ).first
+            File.expand_path last_const.const_source_location( app.to_sym ).first
         end
 
         def spawn( type, options = {}, &block )

data/lib/cuboid/processes/agents.rb

@@ -25,7 +25,7 @@ class Agents
     #
     # @return   [RPC::Client::Agent]
     def connect( url, options = nil )
-        Arachni::Reactor.global.run_in_thread if !Arachni::Reactor.global.running?
+        Raktr.global.run_in_thread if !Raktr.global.running?
 
         fresh = false
         if options

data/lib/cuboid/processes/executables/agent.rb

@@ -1,5 +1,5 @@
 require Options.paths.lib  + 'rpc/server/agent'
 
-Arachni::Reactor.global.run do
+Raktr.global.run do
     RPC::Server::Agent.new
 end

data/lib/cuboid/processes/executables/scheduler.rb

@@ -1,5 +1,5 @@
 require Options.paths.lib  + 'rpc/server/scheduler'
 
-Arachni::Reactor.global.run do
+Raktr.global.run do
     RPC::Server::Scheduler.new
 end

data/lib/cuboid/processes/instances.rb

@@ -28,7 +28,7 @@ class Instances
     # @return   [RPC::Client::Instance]
     #
     def connect( url, token = nil )
-        Arachni::Reactor.global.run_in_thread if !Arachni::Reactor.global.running?
+        Raktr.global.run_in_thread if !Raktr.global.running?
 
         token ||= @list[url]
         @list[url] ||= token

data/lib/cuboid/processes/manager.rb

@@ -1,5 +1,5 @@
 require 'singleton'
-require 'arachni/reactor'
+require 'raktr'
 
 module Cuboid
 module Processes
@@ -156,7 +156,7 @@ class Manager
 
     # Stops the Reactor.
     def kill_reactor
-        Arachni::Reactor.stop
+        Raktr.stop
     rescue
         nil
     end

data/lib/cuboid/processes/schedulers.rb

@@ -23,7 +23,7 @@ class Schedulers
     #
     # @return   [RPC::Client::Scheduler]
     def connect( url, options = nil )
-        Arachni::Reactor.global.run_in_thread if !Arachni::Reactor.global.running?
+        Raktr.global.run_in_thread if !Raktr.global.running?
 
         fresh = false
         if options

data/lib/cuboid/rpc/client/agent.rb

@@ -16,14 +16,14 @@ class Agent
 
     def initialize( url, options = nil )
         @client = Base.new( url, nil, options )
-        @node   = Arachni::RPC::Proxy.new( @client, 'node' )
+        @node   = Toq::Proxy.new( @client, 'node' )
 
         Cuboid::Application.application.agent_services.keys.each do |name|
             self.class.send( :attr_reader, name.to_sym )
 
             instance_variable_set(
               "@#{name}".to_sym,
-              Arachni::RPC::Proxy.new( @client, name )
+              Toq::Proxy.new( @client, name )
             )
         end
     end

data/lib/cuboid/rpc/client/base.rb

@@ -1,4 +1,4 @@
-require 'arachni/rpc'
+require 'toq'
 require_relative '../serializer'
 
 module Cuboid
@@ -6,7 +6,7 @@ module RPC
 class Client
 
 # @author Tasos "Zapotek" Laskos <tasos.laskos@gmail.com>
-class Base < Arachni::RPC::Client
+class Base < Toq::Client
     attr_reader :url
 
     # @param    [String]    url

data/lib/cuboid/rpc/client/instance/service.rb

@@ -5,7 +5,7 @@ class Client
 class Instance
 
 # @author Tasos "Zapotek" Laskos <tasos.laskos@gmail.com>
-class Proxy < Arachni::RPC::Proxy
+class Proxy < Toq::Proxy
 
     def initialize( client )
         super client, 'instance'

data/lib/cuboid/rpc/client/instance.rb

@@ -24,10 +24,10 @@ class Instance
             )
 
             client = new( url, token, options )
-            Arachni::Reactor.global.delay( 0.1 ) do |task|
+            Raktr.global.delay( 0.1 ) do |task|
                 client.alive? do |r|
                     if r.rpc_exception?
-                        Arachni::Reactor.global.delay( 0.1, &task )
+                        Raktr.global.delay( 0.1, &task )
                         next
                     end
 
@@ -45,7 +45,7 @@ class Instance
         @client   = Base.new( url, token, options )
 
         @instance = Proxy.new( @client )
-        @options  = Arachni::RPC::Proxy.new( @client, 'options' )
+        @options  = Toq::Proxy.new( @client, 'options' )
 
         # map Agent handlers
         Cuboid::Application.application.instance_services.keys.each do |name|
@@ -53,7 +53,7 @@ class Instance
 
             instance_variable_set(
               "@#{name}".to_sym,
-              Arachni::RPC::Proxy.new( @client, name )
+              Toq::Proxy.new( @client, name )
             )
         end
     end

data/lib/cuboid/rpc/server/agent/node.rb

@@ -65,7 +65,7 @@ class Server::Agent::Node
 
         log_updated_peers
 
-        Arachni::Reactor.global.at_interval( @options.agent.ping_interval ) do
+        Raktr.global.at_interval( @options.agent.ping_interval ) do
             ping
             check_for_comebacks
         end
@@ -152,7 +152,7 @@ class Server::Agent::Node
                 block.call( @nodes_info_cache )
             end
 
-            Arachni::Reactor.global.create_iterator( peers ).map( each, after )
+            Raktr.global.create_iterator( peers ).map( each, after )
         else
             block.call( @nodes_info_cache )
         end

data/lib/cuboid/rpc/server/agent/service.rb

@@ -45,7 +45,7 @@ class Server::Agent::Service
     # Performs an asynchronous map operation over all running instances.
     #
     # @param [Proc]  each
-    #   Block to be passed {Client::Instance} and `Arachni::Reactor::Iterator`.
+    #   Block to be passed {Client::Instance} and `Raktr::Iterator`.
     # @param [Proc]  after
     #   Block to be passed the Array of results.
     def map_instances( each, after )
@@ -58,7 +58,7 @@ class Server::Agent::Service
     # Performs an asynchronous iteration over all running instances.
     #
     # @param [Proc]  block
-    #   Block to be passed {Client::Instance} and `Arachni::Reactor::Iterator`.
+    #   Block to be passed {Client::Instance} and `Raktr::Iterator`.
     def each_instance( &block )
         wrap = proc do |instance, iterator|
             block.call( connect_to_instance( instance ), iterator )
@@ -88,15 +88,15 @@ class Server::Agent::Service
     #
     # @param    [Block] block
     def run_asap( &block )
-        Arachni::Reactor.global.next_tick( &block )
+        Raktr.global.next_tick( &block )
     end
 
     # @param    [Array]    list
     #
-    # @return   [Arachni::Reactor::Iterator]
+    # @return   [Raktr::Iterator]
     #   Iterator for the provided array.
     def iterator_for( list, max_concurrency = 10 )
-        Arachni::Reactor.global.create_iterator( list, max_concurrency )
+        Raktr.global.create_iterator( list, max_concurrency )
     end
 
     # @return   [Array<Hash>]

data/lib/cuboid/rpc/server/agent.rb

@@ -137,7 +137,7 @@ class Agent
             block.call nodes.sort_by { |_, score| adjust_score_by_strategy.call score }[0][0]
         end
 
-        Arachni::Reactor.global.create_iterator( @node.peers ).map( each, after )
+        Raktr.global.create_iterator( @node.peers ).map( each, after )
     end
 
     # Spawns an {Instance}.
@@ -294,7 +294,7 @@ class Agent
 
     # Starts the agent's server
     def run
-        Arachni::Reactor.global.on_error do |_, e|
+        Raktr.global.on_error do |_, e|
             print_error "Reactor: #{e}"
 
             e.backtrace.each do |l|
@@ -314,7 +314,7 @@ class Agent
     def shutdown
         Thread.new do
             print_status 'Shutting down...'
-            Arachni::Reactor.global.stop
+            Raktr.global.stop
         end
     end
 

data/lib/cuboid/rpc/server/base.rb

@@ -1,5 +1,5 @@
 require 'ostruct'
-require 'arachni/rpc'
+require 'toq'
 require_relative '../serializer'
 
 module Cuboid
@@ -10,7 +10,7 @@ class Server
 #
 # @private
 # @author Tasos "Zapotek" Laskos <tasos.laskos@gmail.com>
-class Base < Arachni::RPC::Server
+class Base < Toq::Server
 
     # @param    [Hash]   options
     # @option options [Integer]  :host

data/lib/cuboid/rpc/server/instance.rb

@@ -74,7 +74,7 @@ class Instance
             trap( signal ){ shutdown if !@options.datastore.do_not_trap }
         end
 
-        Arachni::Reactor.global.run do
+        Raktr.global.run do
             _run
         end
     end
@@ -123,7 +123,7 @@ class Instance
     #
     # @see #report
     def abort_and_generate_report
-        @application.clean_up
+        @application.abort!
         generate_report
     end
 
@@ -294,7 +294,7 @@ class Instance
 
     # Starts  RPC service.
     def _run
-        Arachni::Reactor.global.on_error do |_, e|
+        Raktr.global.on_error do |_, e|
             print_error "Reactor: #{e}"
 
             e.backtrace.each do |l|

data/lib/cuboid/rpc/server/scheduler.rb

@@ -399,7 +399,7 @@ class Scheduler
     end
 
     def reactor
-        Arachni::Reactor.global
+        Raktr.global
     end
 
     def trap_interrupts( &block )

data/lib/version

@@ -1 +1 @@
-0.1.3
+0.1.6

data/spec/cuboid/rest/server_spec.rb

@@ -204,7 +204,7 @@ describe Cuboid::Rest::Server do
                 post url, invalid: 'blah'
 
                 expect(response_code).to eq 500
-                expect(response_data['error']).to eq 'Arachni::RPC::Exceptions::RemoteException'
+                expect(response_data['error']).to eq 'Toq::Exceptions::RemoteException'
                 expect(response_data).to include 'backtrace'
             end
 
@@ -658,7 +658,7 @@ describe Cuboid::Rest::Server do
             it 'returns 500' do
                 put url, 'localhost:383838'
                 expect(response_code).to eq 500
-                expect(response_data['error']).to eq 'Arachni::RPC::Exceptions::ConnectionError'
+                expect(response_data['error']).to eq 'Toq::Exceptions::ConnectionError'
             end
         end
     end
@@ -821,7 +821,7 @@ describe Cuboid::Rest::Server do
                     post url, invalid: 'blah'
 
                     expect(response_code).to eq 500
-                    expect(response_data['error']).to eq 'Arachni::RPC::Exceptions::RemoteException'
+                    expect(response_data['error']).to eq 'Toq::Exceptions::RemoteException'
                     expect(response_data).to include 'backtrace'
                 end
             end
@@ -876,7 +876,7 @@ describe Cuboid::Rest::Server do
                 put url, 'localhost:393939'
 
                 expect(response_code).to eq 500
-                expect(response_data['error']).to eq 'Arachni::RPC::Exceptions::ConnectionError'
+                expect(response_data['error']).to eq 'Toq::Exceptions::ConnectionError'
                 expect(response_data['description']).to include 'Connection closed'
             end
         end
@@ -992,7 +992,7 @@ describe Cuboid::Rest::Server do
 
                 get url
                 expect(response_data.size).to be 1
-                expect(response_data[@id]['error']).to eq 'Arachni::RPC::Exceptions::ConnectionError'
+                expect(response_data[@id]['error']).to eq 'Toq::Exceptions::ConnectionError'
                 expect(response_data[@id]['description']).to include 'Connection closed [Connection refused - connect(2) for'
             end
         end

data/spec/cuboid/rpc/client/base_spec.rb

@@ -18,7 +18,7 @@ class Server
     end
 
     def start
-        Arachni::Reactor.global.run_in_thread if !Arachni::Reactor.global.running?
+        Raktr.global.run_in_thread if !Raktr.global.running?
         @server.start
         sleep( 0.1 ) while !@server.ready?
     end
@@ -86,7 +86,7 @@ describe Cuboid::RPC::Client::Base do
                         begin
                             client = described_class.new( server.url, nil, client_ssl_options )
                             client.call( "foo.bar" )
-                        rescue Arachni::RPC::Exceptions::ConnectionError
+                        rescue Toq::Exceptions::ConnectionError
                             raised = true
                         end
 
@@ -102,7 +102,7 @@ describe Cuboid::RPC::Client::Base do
                         begin
                             client = described_class.new( server.url, nil, empty_options )
                             client.call( "foo.bar" )
-                        rescue Arachni::RPC::Exceptions::ConnectionError
+                        rescue Toq::Exceptions::ConnectionError
                             raised = true
                         end
 
@@ -137,7 +137,7 @@ describe Cuboid::RPC::Client::Base do
                         begin
                             client = described_class.new( server.url, nil, empty_options )
                             client.call( "foo.bar" )
-                        rescue Arachni::RPC::Exceptions::InvalidToken
+                        rescue Toq::Exceptions::InvalidToken
                             raised = true
                         end
 

data/spec/cuboid/rpc/client/instance_spec.rb

@@ -16,7 +16,7 @@ describe Cuboid::RPC::Client::Instance do
                 it 'should fail to connect' do
                     expect do
                         described_class.new( subject.url, 'blah' ).alive?
-                    end.to raise_error Arachni::RPC::Exceptions::InvalidToken
+                    end.to raise_error Toq::Exceptions::InvalidToken
                 end
             end
         end

data/spec/cuboid/rpc/server/agent/node_spec.rb

@@ -11,11 +11,11 @@ describe Cuboid::RPC::Server::Agent::Node do
         c = Cuboid::RPC::Client::Base.new(
             "#{Cuboid::Options.rpc.server_address}:#{port}"
         )
-        c = Arachni::RPC::Proxy.new( c, 'node' )
+        c = Toq::Proxy.new( c, 'node' )
 
         begin
             c.alive?
-        rescue Arachni::RPC::Exceptions::ConnectionError
+        rescue Toq::Exceptions::ConnectionError
             sleep 0.1
             retry
         end

data/spec/cuboid/rpc/server/base_spec.rb

@@ -3,7 +3,7 @@ require "#{Cuboid::Options.paths.lib}/rpc/server/base"
 
 describe Cuboid::RPC::Server::Base do
     before( :each ) do
-        Arachni::Reactor.global.run_in_thread
+        Raktr.global.run_in_thread
     end
 
     let(:subject) { Cuboid::RPC::Server::Base.new(
@@ -11,7 +11,7 @@ describe Cuboid::RPC::Server::Base do
     ) }
     let(:port) { available_port }
 
-    it 'supports UNIX sockets', if: Arachni::Reactor.supports_unix_sockets? do
+    it 'supports UNIX sockets', if: Raktr.supports_unix_sockets? do
         server = Cuboid::RPC::Server::Base.new(
             socket: "#{Dir.tmpdir}/cuboid-base-#{Cuboid::Utilities.generate_token}"
         )

data/spec/cuboid/rpc/server/instance_spec.rb

@@ -5,7 +5,7 @@ require "#{fixtures_path}/mock_app"
 describe 'Cuboid::RPC::Server::Instance' do
     let(:subject) { instance_spawn( application: "#{fixtures_path}/mock_app.rb" ) }
 
-    it 'supports UNIX sockets', if: Arachni::Reactor.supports_unix_sockets? do
+    it 'supports UNIX sockets', if: Raktr.supports_unix_sockets? do
         socket = "#{Dir.tmpdir}/cuboid-instance-#{Cuboid::Utilities.generate_token}"
         subject = instance_spawn(
           socket:      socket,
@@ -203,7 +203,9 @@ describe 'Cuboid::RPC::Server::Instance' do
     end
 
     describe '#abort_and_generate_report' do
-        it "cleans-up and returns the report as #{Cuboid::Report}" do
+        it "cleans-up and returns the report as #{Cuboid::Report}", focus: true do
+            subject.run
+
             expect(subject.abort_and_generate_report).to be_kind_of Cuboid::Report
         end
     end
@@ -239,7 +241,7 @@ describe 'Cuboid::RPC::Server::Instance' do
             it 'raises ArgumentError' do
                 expect do
                     subject.run invalid: :stuff
-                end.to raise_error Arachni::RPC::Exceptions::RemoteException
+                end.to raise_error Toq::Exceptions::RemoteException
             end
         end
 
@@ -300,7 +302,7 @@ describe 'Cuboid::RPC::Server::Instance' do
             expect(subject.shutdown).to be_truthy
             sleep 4
 
-            expect { subject.alive? }.to raise_error Arachni::RPC::Exceptions::ConnectionError
+            expect { subject.alive? }.to raise_error Toq::Exceptions::ConnectionError
         end
     end