msgpack-rpc-stack 0.7.0 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd76cc71b043173ef94c8f7d21041a9ac2490c03f2cfc936ad3dddb3e0cb40b8
-  data.tar.gz: b0d2e72657bf2e3bca72870f9f1ca7388178cf33d708080a3f0ec32531aa2a47
+  metadata.gz: 8b687418a1a9a272d68e0fdcf9dc186f9c7cb424d26bf1ea00257ee957e905bf
+  data.tar.gz: 0bc7c33e5e91070e051d4d3e2dbf7d44735e584e327a4a6992e573793ed1be40
 SHA512:
-  metadata.gz: f8ae673b9d04a9ea9ff4baaad08b4d4c1af92df50f93f8f72fcc4941171c1c05eea8a8ff7438a43b92c804f79a3f1a64824ff8225e4a4e22fafc03896a864dc4
-  data.tar.gz: 74142d315c72fe443f8fcf5aaf952a453ffae01a19208d332a73ad93a662bb7690429f07aa8d73a543962cdf68b532cf3e31b1b13d969f171cfbc2948aa5cdaf
+  metadata.gz: 17bff07e8d05495571b1a2492b5ad00c269b031ef526442eda3af8297886d7c7a7bce511ffce6334272962f7cab4f9f6b312af3e800bf2311159b91b375838cd
+  data.tar.gz: f197aaf7b86bb57f654a5cbe3ec632afcea0ab6716ade19ff5500517a9afdaa34ba852728e9eae2040aede41ade4e30ce93189d0a72d53601ecf7fe3aa861672

data/lib/msgpack/rpc/client.rb

@@ -12,6 +12,20 @@ require 'msgpack/rpc'
 
 module MessagePack
   module Rpc
+    #
+    # Module that implemented client protocol of MessagePack-RPC.
+    # 
+    # @abstract
+    #   Include from the class that implements the rpc client. 
+    #   When the client implementation class receives data from the
+    #   communication line, it must call the receive_data() method and pass
+    #   received data to the MessagePack::Rpc::Client module.
+    #   Also, the client implementation class should define a method
+    #   send_data() to actually send the data. Call this method from
+    #   within the MessagePack::Rpc::Client module if necessary
+    #   (Implement send_data() method to accept string objects in arguments).
+    #   If you receive a protocol level error, override the on_error() method.
+    #
     module Client
       class << self
         def included(klass)
@@ -67,6 +81,27 @@ module MessagePack
       end
       private :error_occured
 
+      #
+      # call the procedure of peer rpc server
+      #
+      # @param [Symbol] meth
+      #   target procedure name.
+      #
+      # @param [Array] args
+      #   arguments for procedure.
+      #
+      # @return [Integer]
+      #   assigned mesaage id
+      #
+      # @yield [res, err]
+      #   callback that is when the procedure call completes.
+      #
+      # @yieldparam [Object] res
+      #   responce of procedure when procedure successed.
+      #
+      # @yieldparam [Object] err
+      #   error data of procedure when procedure failed.
+      #
       def call(meth, *args, &blk)
         raise ArgumentError.new("handler is not spcified") if not blk
 
@@ -78,14 +113,34 @@ module MessagePack
         return id
       end
 
-      def notify(meth, *args)
-        send_data([2, meth, args].to_msgpack)
-      end
-
+      #
+      # cacel the call message
+      #
+      # @param [Integer] id
+      #   message id of calling message (return value of
+      #   MessagePack::Rpc::Client#call())
+      #
+      # @note
+      #    When this method is called, the procedure call corresponding to
+      #   the ID specified in the argument is cancelled.
+      #
       def cancel(id)
         session_map.delete(id)
       end
 
+      #
+      # send the notification to peer rpc server
+      #
+      # @param [Symbol] meth
+      #   notify name
+      #
+      # @param [Array] args
+      #   argument for notification
+      #
+      def notify(meth, *args)
+        send_data([2, meth, args].to_msgpack)
+      end
+
       def eval_response(resp)
         if not resp.kind_of?(Array)
           error_occured("responce is not array")
@@ -128,10 +183,27 @@ module MessagePack
       end
       private :eval_response
 
+      #
+      # emqueu the received datagram to communication buffer
+      #
+      # @param [Blob] data
+      #   recevied data from rpc server.
+      #
+      # @note
+      #   Use this method for datagram communication. \
+      #   Use it when it is guaranteed that data is exchanged \
+      #   in packets (it works a bit faster).
+      #
       def receive_dgram(data)
         eval_response(MessagePack.unpack(data, self.class.msgpack_options))
       end
 
+      #
+      # emqueu the received data to communication buffer
+      #
+      # @param [Blob] data
+      #   recevied data from rpc server.
+      #
       def receive_stream(data)
         begin
           unpacker.feed_each(data) {|resp| eval_response(resp)}
@@ -145,6 +217,16 @@ module MessagePack
         end
       end
 
+      #
+      # define the notify method
+      #
+      # @param [Symbol] name
+      #   notification name
+      #
+      # @yield [*args]
+      #    callback that is when received the notification
+      #   from peer rpc server.
+      #
       def on(name, &blk)
         raise ArgumentError.new("handler is not spcified") if not blk
         notify_handler[name] = blk

data/lib/msgpack/rpc/server.rb

@@ -12,8 +12,89 @@ require 'msgpack/rpc'
 
 module MessagePack
   module Rpc
+
+    #
+    # Module that implemented server protocol of MessagePack-RPC.
+    # 
+    # @abstract
+    #   Include from the class that implements the rpc server. You can expose
+    #   When the client implementation class receives data from the
+    #   communication line, it must call the receive_data() method and pass
+    #   received data to the MessagePack::Rpc::Server module.
+    #   Also, the client implementation class should define a method
+    #   send_data() to actually send the data. Call this method from
+    #   within the MessagePack::Rpc::Server module if necessary
+    #   (Implement send_data() method to accept string objects in arguments).
+    #   If you receive a protocol level error, override the on_error() method.
+    #   the methods defined in that class as RPC procedures.
+    #
     module Server
       class << self
+        #
+        # @!method msgpack_options(**opts)
+        #   set MessagePack::Unpacker option.
+        #
+        #   @example set :symbolize_keys option
+        #     class Server
+        #       include MessagePack::Rpc::Server
+        #
+        #       msgpack_options = {:symbolize_keys => true}
+        #
+        #       def test(data)
+        #         # data's key are symbolized.
+        #         return data[:data]
+        #       end
+        #       remote_public :test
+        #     end
+
+        #
+        # @!method remote_public(name)
+        #   expose syncronous procedure.
+        #   The return value of the method exposed by this method is the 
+        #   return value of the procedure. If an exception occurs, the
+        #   exception is returned as an error value.
+        #
+        #   @param [Symbol] name
+        #     target method name.
+        #
+        #   @example expose syncronous procedure
+        #     class Server
+        #       include MessagePack::Rpc::Server
+        #
+        #       def test(id)
+        #         raise("id isnot defined") if id.nil?
+        #         return "hello #{id}"
+        #       end
+        #       remote_public :test
+        #     end
+        #
+
+        #
+        # @!method remote_async(name)
+        #   expose asynchronous procedure.
+        #   The method exposed by this method takes a deferred object as its
+        #   first argument. Returns the processing result asynchronously
+        #   through this object.
+        #
+        #   @param [Symbol] name
+        #     target method name.
+        #
+        #   @example expose asyncronous procedure
+        #     class Server
+        #       include MessagePack::Rpc::Server
+        #
+        #       def test(df, id)
+        #         if id.nil?
+        #           df.reject("id isnot defined")
+        #         else
+        #           df.resolve("hello #{id}")
+        #         end
+        #       end
+        #       remote_async :test
+        #     end
+        #
+
+        # @!visibility protected
         def included(klass)
           m = Module.new {
             @@error = Class.new(StandardError) {
@@ -197,10 +278,30 @@ module MessagePack
       end
       private :eval_message
 
+      #
+      # send the notification to peer rpc client
+      #
+      # @param [Symbol] meth
+      #   notify name
+      #
+      # @param [Array] args
+      #   argument for notification
+      #
       def notify(meth, *args)
         send_data([2, meth, args].to_msgpack)
       end
 
+      #
+      # emqueu the received datagram to communication buffer
+      #
+      # @param [Blob] data
+      #   recevied data from peer rpc client.
+      #
+      # @note
+      #   Use this method for datagram communication.
+      #   Use it when it is guaranteed that data is exchanged
+      #   in packets (it works a bit faster).
+      #
       def receive_dgram(data)
         msg = MessagePack.unpack(data, self.class.msgpack_options)
 
@@ -211,6 +312,12 @@ module MessagePack
         eval_message(msg)
       end
 
+      #
+      # emqueu the received data to communication buffer
+      #
+      # @param [Blob] data
+      #   recevied data from peer rpc client.
+      #
       def receive_stream(data)
         begin
           unpacker.feed_each(data) {|msg| eval_message(msg)}

data/lib/msgpack/rpc/version.rb

@@ -1,5 +1,5 @@
 module MessagePack
   module Rpc
-    VERSION = "0.7.0"
+    VERSION = "0.7.3"
   end
 end

data/msgpack-rpc-stack.gemspec

@@ -35,7 +35,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 2.4.0"
 
-  spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_dependency "msgpack", "~> 1.2.6"
+  spec.add_development_dependency "bundler", ">= 2.1"
+  spec.add_development_dependency "rake", ">= 12.3.3"
+  spec.add_dependency "msgpack", ">= 1.6.0"
 end

metadata

@@ -1,57 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: msgpack-rpc-stack
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.3
 platform: ruby
 authors:
 - Hiroshi Kuwagata
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-04 00:00:00.000000000 Z
+date: 2023-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: msgpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.6
+        version: 1.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.6
+        version: 1.6.0
 description: A module of implementation MessagePack-RPC stack
 email:
 - kgt9221@gmail.com
@@ -94,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.4.8
 signing_key: 
 specification_version: 4
 summary: MessagePack-RPC module