nobject 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c44de9099814f0327fda7a884decbc6d497f43c071cc284da9ead26b3f2af1a
+  data.tar.gz: e1ecc6b707af2c069e8e7a09e2c47063a6d1d2c73f4a6735d541f8fbb4a0abaf
+SHA512:
+  metadata.gz: 6770a322292eee28e9bbc9a3cccb0715443beeaba48abeed033c7108ae741a6d8b809eab6511a4f55a133fa9d697d11b322073c034c4efea26bc84c5b0832c82
+  data.tar.gz: 0dada952eaef1de493b835fddff04b89ea5c0401ba989a45dadcb2ba0092d9730ae02cdabf679a5678ea39b49182e3730dfcb6ccaaba1e3d37eab8dad573de12

data/lib/nobject.rb

@@ -0,0 +1,35 @@
+require 'socket'
+
+# this class wraps a local object, listens for method invocations over the
+# network, and sends the method invocations onwards to the local object.
+class Nobject
+  def initialize(socket)
+    @socket = socket
+    obj_size = @socket.recv(8).unpack('Q>').first
+    @obj = Marshal.load(@socket.recv(obj_size))
+  end
+
+  def serve!
+    Thread.new do
+      loop do
+        msg_size = @socket.recv(8).unpack('Q>').first
+        msg = Marshal.load(@socket.recv(msg_size))
+
+        result = @obj.send(msg[:method], *msg[:args]) #local_method, *msg[:args])
+        network_return([
+          :ok,
+          result
+        ])
+      end
+    end
+  end
+
+  def network_return(data)
+    data_bytes = Marshal.dump(data)
+
+    @socket.send([data_bytes.length].pack('Q>'), 0)
+    @socket.send(data_bytes, 0)
+  end
+end
+
+class Nobject::NoMethodError < NameError; end

data/lib/nobject_server.rb

@@ -0,0 +1,42 @@
+require 'socket'
+require_relative './nobject'
+
+##
+# this class listens for incoming requests to store an object over the network,
+# accepts connections and then hands those sockets off to server object storage
+# and invocation.
+class NobjectServer
+  def initialize(port)
+    @server = TCPServer.new(port)
+    @keep_running = true
+    @nobjects = []
+  end
+
+  def alive?
+    @keep_running
+  end
+
+  def start!
+    loop do
+      break unless @keep_running
+
+      begin
+        incoming_socket = @server.accept_nonblock
+        Nobject.new(incoming_socket).serve!
+      rescue IO::EAGAINWaitReadable => e
+        # no connection pending
+        begin
+          IO.select([@server])
+          retry
+        rescue Interrupt, IRB::Abort
+          @keep_running = false
+          @server&.close
+        end
+      end
+    end
+  end
+
+  def stop!
+    @keep_running = false
+  end
+end

data/lib/proxy_nobject.rb

@@ -0,0 +1,47 @@
+require 'socket'
+
+# this is the class that accepts instantiated objects in the main program, and
+# then pushes them to a remote server
+class ProxyNobject
+  # host: the hostname of the server to push obj to
+  # port: the port number of the server to push obj to
+  # obj: the obj to store over the network
+  def initialize(host, port, obj)
+    @socket = TCPSocket.new(host, port)
+    obj_bytes = Marshal.dump(obj)
+
+    @socket.send([obj_bytes.length].pack('Q>'), 0)
+    @socket.send(obj_bytes, 0)
+  end
+
+  def method_missing(method, *args, **kwargs, &block)
+    msg = { method: method, args: args }
+    msg_bytes = Marshal.dump(msg)
+
+    @socket.send([msg_bytes.length].pack('Q>'), 0)
+    @socket.send(msg_bytes, 0)
+
+    return_size = @socket.recv(8).unpack('Q>').first
+    return_data = Marshal.load(@socket.recv(return_size))
+
+    case return_data.first
+    when :ok then return_data.last
+    when :raise then raise return_data.last
+    else
+      raise ProxyNobject::UnknownReturnDataType.new("unknown data type '#{return_data.first}' within ProxyNobject (ProxyNobject::UnknownReturnDataType)")
+    end
+  end
+
+  #####################################
+  # method overridden from Object class
+  #####################################
+  def !~(other);      method_missing(:is_a?, other);  end
+  def <=>(other);     method_missing(:<=>, other);    end
+  def ===(other);     method_missing(:<=>, other);    end
+  def is_a?(klass);   method_missing(:is_a?, klass);  end
+  def inspect;        method_missing(:inspect);       end
+  def object_id;      method_missing(:object_id);     end
+end
+
+class ProxyNobject::UnknownReturnDataType < RuntimeError; end
+class ProxyNobject::InvalidMethod < RuntimeError; end

metadata

@@ -0,0 +1,42 @@
+--- !ruby/object:Gem::Specification
+name: nobject
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+bindir: bin
+cert_chain: []
+date: 2025-03-31 00:00:00.000000000 Z
+dependencies: []
+description: network-hosted objects that you can call methods on as if they were local
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/nobject.rb
+- lib/nobject_server.rb
+- lib/proxy_nobject.rb
+homepage: https://github.com/jefflunt/nobject
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: network-hosted objects that you can call methods on as if they were local
+test_files: []