polyphony 0.99.3 → 0.99.5

data/lib/polyphony/extensions/io.rb

@@ -108,7 +108,7 @@ class ::IO
       def double_splice(src, dest)
         Polyphony.backend_double_splice(src, dest)
       end
-    
+
       # Tees data from the source to the desination.
       #
       # @param src [IO, Polyphony::Pipe] source to tee from
@@ -232,7 +232,7 @@ class ::IO
     Polyphony.backend_write(self, str)
     self
   end
-  
+
   # @!visibility private
   alias_method :orig_gets, :gets
 
@@ -350,24 +350,16 @@ class ::IO
     buf ? readpartial(maxlen, buf) : readpartial(maxlen)
   end
 
-  # call-seq:
-  #   io.read_loop { |data| ... }
-  #   io.read_loop(maxlen) { |data| ... }
-  #
   # Reads up to `maxlen` bytes at a time in an infinite loop. Read data
   # will be passed to the given block.
   #
   # @param maxlen [Integer] maximum bytes to receive
-  # @yield [String] handler block
+  # @yield [String] read data
   # @return [void]
   def read_loop(maxlen = 8192, &block)
     Polyphony.backend_read_loop(self, maxlen, &block)
   end
 
-  # call-seq:
-  #   io.feed_loop(receiver, method)
-  #   io.feed_loop(receiver, method) { |result| ... }
-  #
   # Receives data from the io in an infinite loop, passing the data to the given
   # receiver using the given method. If a block is given, the result of the
   # method call to the receiver is passed to the block.
@@ -384,7 +376,6 @@ class ::IO
   #
   # @param receiver [any] receiver object
   # @param method [Symbol] method to call
-  # @yield [any] block to handle result of method call to receiver
   # @return [void]
   def feed_loop(receiver, method = :call, &block)
     Polyphony.backend_feed_loop(self, receiver, method, &block)

data/lib/polyphony/extensions/openssl.rb

@@ -89,12 +89,6 @@ class ::OpenSSL::SSL::SSLSocket
   # @!visibility private
   alias_method :orig_read, :read
 
-  # call-seq:
-  #   socket.read -> string
-  #   socket.read(maxlen) -> string
-  #   socket.read(maxlen, buf) -> buf
-  #   socket.read(maxlen, buf, buf_pos) -> buf
-  #
   # Reads from the socket. If `maxlen` is given, reads up to `maxlen` bytes from
   # the socket, otherwise reads to `EOF`. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
@@ -123,12 +117,6 @@ class ::OpenSSL::SSL::SSLSocket
     buf
   end
 
-  # call-seq:
-  #   socket.readpartial(maxlen) -> string
-  #   socket.readpartial(maxlen, buf) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos, raise_on_eof) -> buf
-  #
   # Reads up to `maxlen` from the socket. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
   # given, reads into the given offset (in bytes) in the given buffer. If the
@@ -162,17 +150,11 @@ class ::OpenSSL::SSL::SSLSocket
     result
   end
 
-  # call-seq:
-  #   socket.recv_loop { |data| ... }
-  #   socket.recv_loop(maxlen) { |data| ... }
-  #   socket.read_loop { |data| ... }
-  #   socket.read_loop(maxlen) { |data| ... }
-  #
   # Receives up to `maxlen` bytes at a time in an infinite loop. Read buffers
   # will be passed to the given block.
   #
   # @param maxlen [Integer] maximum bytes to receive
-  # @yield [String] handler block
+  # @yield [String] read data
   # @return [void]
   def read_loop(maxlen = 8192)
     while (data = sysread(maxlen))
@@ -279,12 +261,9 @@ class ::OpenSSL::SSL::SSLServer
     orig_close
   end
 
-  # call-seq:
-  #   socket.accept_loop { |conn| ... }
-  #
   # Accepts incoming connections in an infinite loop.
   #
-  # @yield [OpenSSL::SSL::SSLSocket] block receiving accepted sockets
+  # @yield [OpenSSL::SSL::SSLSocket] accepted socket
   # @return [void]
   def accept_loop(ignore_errors = true)
     loop do

data/lib/polyphony/extensions/pipe.rb

@@ -72,7 +72,7 @@ class Polyphony::Pipe
   end
 
   # Writes to the pipe.
-  
+
   # @param buf [String] data to write
   # @param args [any] further arguments to pass to Polyphony.backend_write
   # @return [Integer] bytes written
@@ -81,7 +81,7 @@ class Polyphony::Pipe
   end
 
   # Writes to the pipe.
-  
+
   # @param buf [String] data to write
   # @return [Integer] bytes written
   def <<(buf)
@@ -89,12 +89,6 @@ class Polyphony::Pipe
     self
   end
 
-  # call-seq:
-  #   pipe.gets(limit, chomp)
-  #   pipe.gets(separator, limit, chomp)
-  #
-  # Reads a single line from the pipe.
-  #
   # @param sep [String] line separator
   # @param _limit [Integer, nil] line length limit
   # @param _chomp [boolean, nil] whether to chomp the read line
@@ -134,7 +128,7 @@ class Polyphony::Pipe
   LINEFEED_RE = /\n$/.freeze
 
   # Writes a line with line feed to the pipe.
-  # 
+  #
   # @param args [Array] zero or more lines
   def puts(*args)
     if args.empty?
@@ -183,16 +177,12 @@ class Polyphony::Pipe
   # Runs a read loop.
   #
   # @param maxlen [Integer] maximum bytes to read
-  # @yield [String] read block
+  # @yield [String] read data
   # @return [void]
   def read_loop(maxlen = 8192, &block)
     Polyphony.backend_read_loop(self, maxlen, &block)
   end
 
-  # call-seq:
-  #   pipe.feed_loop(receiver, method)
-  #   pipe.feed_loop(receiver, method) { |result| ... }
-  #
   # Receives data from the pipe in an infinite loop, passing the data to the
   # given receiver using the given method. If a block is given, the result of
   # the method call to the receiver is passed to the block.
@@ -209,7 +199,6 @@ class Polyphony::Pipe
   #
   # @param receiver [any] receiver object
   # @param method [Symbol] method to call
-  # @yield [any] block to handle result of method call to receiver
   # @return [void]
   def feed_loop(receiver, method = :call, &block)
     Polyphony.backend_feed_loop(self, receiver, method, &block)

data/lib/polyphony/extensions/socket.rb

@@ -28,18 +28,15 @@ end
 class ::Socket < ::BasicSocket
 
   # Accepts an incoming connection.
-  
+
   # @return [TCPSocket] new connection
   def accept
     Polyphony.backend_accept(self, TCPSocket)
   end
 
-  # call-seq:
-  #   socket.accept_loop { |conn| ... }
-  #
   # Accepts incoming connections in an infinite loop.
   #
-  # @yield [Socket] block receiving accepted sockets
+  # @yield [Socket] accepted socket
   # @return [void]
   def accept_loop(&block)
     Polyphony.backend_accept_loop(self, TCPSocket, &block)
@@ -61,12 +58,6 @@ class ::Socket < ::BasicSocket
   # @!visibility private
   alias_method :orig_read, :read
 
-  # call-seq:
-  #   socket.read -> string
-  #   socket.read(maxlen) -> string
-  #   socket.read(maxlen, buf) -> buf
-  #   socket.read(maxlen, buf, buf_pos) -> buf
-  #
   # Reads from the socket. If `maxlen` is given, reads up to `maxlen` bytes from
   # the socket, otherwise reads to `EOF`. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
@@ -98,11 +89,6 @@ class ::Socket < ::BasicSocket
     buf
   end
 
-  # call-seq:
-  #   socket.recv(maxlen) -> string
-  #   socket.recv(maxlen, flags) -> string
-  #   socket.recv(maxlen, flags, buf) -> buf
-  #
   # Receives up to `maxlen` bytes from the socket. If `outbuf` is given, it is
   # used as the buffer to receive into, otherwise a new string is allocated and
   # used as buffer.
@@ -118,27 +104,17 @@ class ::Socket < ::BasicSocket
     Polyphony.backend_recv(self, outbuf || +'', maxlen, 0)
   end
 
-  # call-seq:
-  #   socket.recv_loop { |data| ... }
-  #   socket.recv_loop(maxlen) { |data| ... }
-  #   socket.read_loop { |data| ... }
-  #   socket.read_loop(maxlen) { |data| ... }
-  #
   # Receives up to `maxlen` bytes at a time in an infinite loop. Read buffers
   # will be passed to the given block.
   #
   # @param maxlen [Integer] maximum bytes to receive
-  # @yield [String] handler block
+  # @yield [String] received data
   # @return [void]
   def recv_loop(maxlen = 8192, &block)
     Polyphony.backend_recv_loop(self, maxlen, &block)
   end
   alias_method :read_loop, :recv_loop
 
-  # call-seq:
-  #   socket.feed_loop(receiver, method)
-  #   socket.feed_loop(receiver, method) { |result| ... }
-  #
   # Receives data from the socket in an infinite loop, passing the data to the
   # given receiver using the given method. If a block is given, the result of
   # the method call to the receiver is passed to the block.
@@ -155,7 +131,6 @@ class ::Socket < ::BasicSocket
   #
   # @param receiver [any] receiver object
   # @param method [Symbol] method to call
-  # @yield [any] block to handle result of method call to receiver
   # @return [void]
   def feed_loop(receiver, method = :call, &block)
     Polyphony.backend_recv_feed_loop(self, receiver, method, &block)
@@ -179,12 +154,6 @@ class ::Socket < ::BasicSocket
     end
   end
 
-  # call-seq:
-  #   socket.readpartial(maxlen) -> string
-  #   socket.readpartial(maxlen, buf) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos, raise_on_eof) -> buf
-  #
   # Reads up to `maxlen` from the socket. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
   # given, reads into the given offset (in bytes) in the given buffer. If the
@@ -246,7 +215,7 @@ class ::Socket < ::BasicSocket
   class << self
   # @!visibility private
   alias_method :orig_getaddrinfo, :getaddrinfo
-    
+
     # Resolves the given addr using a worker thread from the default thread
     # pool.
     #
@@ -291,7 +260,7 @@ class ::TCPSocket < ::IPSocket
 
   # @!visibility private
   alias_method :orig_close, :close
-  
+
   # Closes the socket.
   #
   # @return [TCPSocket] self
@@ -302,7 +271,7 @@ class ::TCPSocket < ::IPSocket
 
   # @!visibility private
   alias_method :orig_setsockopt, :setsockopt
-  
+
   # Calls `setsockopt` with the given arguments.
   #
   # @return [TCPSocket] self
@@ -313,7 +282,7 @@ class ::TCPSocket < ::IPSocket
 
   # @!visibility private
   alias_method :orig_closed?, :closed?
-  
+
   # Returns true if the socket is closed.
   #
   # @return [bool] is socket closed
@@ -356,12 +325,6 @@ class ::TCPSocket < ::IPSocket
   # @!visibility private
   alias_method :orig_read, :read
 
-  # call-seq:
-  #   socket.read -> string
-  #   socket.read(maxlen) -> string
-  #   socket.read(maxlen, buf) -> buf
-  #   socket.read(maxlen, buf, buf_pos) -> buf
-  #
   # Reads from the socket. If `maxlen` is given, reads up to `maxlen` bytes from
   # the socket, otherwise reads to `EOF`. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
@@ -393,11 +356,6 @@ class ::TCPSocket < ::IPSocket
     buf
   end
 
-  # call-seq:
-  #   socket.recv(maxlen) -> string
-  #   socket.recv(maxlen, flags) -> string
-  #   socket.recv(maxlen, flags, buf) -> buf
-  #
   # Receives up to `maxlen` bytes from the socket. If `outbuf` is given, it is
   # used as the buffer to receive into, otherwise a new string is allocated and
   # used as buffer.
@@ -413,27 +371,17 @@ class ::TCPSocket < ::IPSocket
     Polyphony.backend_recv(self, outbuf || +'', maxlen, 0)
   end
 
-  # call-seq:
-  #   socket.recv_loop { |data| ... }
-  #   socket.recv_loop(maxlen) { |data| ... }
-  #   socket.read_loop { |data| ... }
-  #   socket.read_loop(maxlen) { |data| ... }
-  #
   # Receives up to `maxlen` bytes at a time in an infinite loop. Read buffers
   # will be passed to the given block.
   #
   # @param maxlen [Integer] maximum bytes to receive
-  # @yield [String] handler block
+  # @yield [String] received data
   # @return [void]
   def recv_loop(maxlen = 8192, &block)
     Polyphony.backend_recv_loop(self, maxlen, &block)
   end
   alias_method :read_loop, :recv_loop
 
-  # call-seq:
-  #   socket.feed_loop(receiver, method)
-  #   socket.feed_loop(receiver, method) { |result| ... }
-  #
   # Receives data from the socket in an infinite loop, passing the data to the
   # given receiver using the given method. If a block is given, the result of
   # the method call to the receiver is passed to the block.
@@ -450,18 +398,11 @@ class ::TCPSocket < ::IPSocket
   #
   # @param receiver [any] receiver object
   # @param method [Symbol] method to call
-  # @yield [any] block to handle result of method call to receiver
   # @return [void]
   def feed_loop(receiver, method = :call, &block)
     Polyphony.backend_recv_feed_loop(self, receiver, method, &block)
   end
 
-  # call-seq:
-  #   socket.readpartial(maxlen) -> string
-  #   socket.readpartial(maxlen, buf) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos, raise_on_eof) -> buf
-  #
   # Reads up to `maxlen` from the socket. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
   # given, reads into the given offset (in bytes) in the given buffer. If the
@@ -530,7 +471,7 @@ class ::TCPServer < ::TCPSocket
   alias_method :orig_accept, :accept
 
   # Accepts an incoming connection.
-  
+
   # @return [TCPSocket] new connection
   def accept
     Polyphony.backend_accept(@io, TCPSocket)
@@ -544,19 +485,15 @@ class ::TCPServer < ::TCPSocket
     #     server.accept_loop { |c| handle_connection(c) }
     #   end
     #
-    # @yield [TCPSocket] code block
     # @return [any] return value of code block
     def multishot_accept(&block)
       Polyphony.backend_multishot_accept(@io, &block)
     end
   end
 
-  # call-seq:
-  #   socket.accept_loop { |conn| ... }
-  #
   # Accepts incoming connections in an infinite loop.
   #
-  # @yield [TCPSocket] handler block
+  # @yield [TCPSocket] accepted socket
   # @return [void]
   def accept_loop(&block)
     Polyphony.backend_accept_loop(@io, TCPSocket, &block)
@@ -564,7 +501,7 @@ class ::TCPServer < ::TCPSocket
 
   # @!visibility private
   alias_method :orig_close, :close
-  
+
   # Closes the server socket.
   #
   # @return [TCPServer] self
@@ -580,18 +517,15 @@ class ::UNIXServer < ::UNIXSocket
   alias_method :orig_accept, :accept
 
   # Accepts an incoming connection.
-  
+
   # @return [UNIXSocket] new connection
   def accept
     Polyphony.backend_accept(self, UNIXSocket)
   end
 
-  # call-seq:
-  #   socket.accept_loop { |conn| ... }
-  #
   # Accepts incoming connections in an infinite loop.
   #
-  # @yield [UNIXSocket] handler block
+  # @yield [UNIXSocket] accepted socket
   # @return [void]
   def accept_loop(&block)
     Polyphony.backend_accept_loop(self, UNIXSocket, &block)
@@ -602,13 +536,7 @@ end
 class ::UNIXSocket < ::BasicSocket
   # @!visibility private
   alias_method :orig_read, :read
-  
-  # call-seq:
-  #   socket.read -> string
-  #   socket.read(maxlen) -> string
-  #   socket.read(maxlen, buf) -> buf
-  #   socket.read(maxlen, buf, buf_pos) -> buf
-  #
+
   # Reads from the socket. If `maxlen` is given, reads up to `maxlen` bytes from
   # the socket, otherwise reads to `EOF`. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
@@ -640,11 +568,6 @@ class ::UNIXSocket < ::BasicSocket
     buf
   end
 
-  # call-seq:
-  #   socket.recv(maxlen) -> string
-  #   socket.recv(maxlen, flags) -> string
-  #   socket.recv(maxlen, flags, buf) -> buf
-  #
   # Receives up to `maxlen` bytes from the socket. If `outbuf` is given, it is
   # used as the buffer to receive into, otherwise a new string is allocated and
   # used as buffer.
@@ -660,27 +583,17 @@ class ::UNIXSocket < ::BasicSocket
     Polyphony.backend_recv(self, outbuf || +'', maxlen, 0)
   end
 
-  # call-seq:
-  #   socket.recv_loop { |data| ... }
-  #   socket.recv_loop(maxlen) { |data| ... }
-  #   socket.read_loop { |data| ... }
-  #   socket.read_loop(maxlen) { |data| ... }
-  #
   # Receives up to `maxlen` bytes at a time in an infinite loop. Read buffers
   # will be passed to the given block.
   #
   # @param maxlen [Integer] maximum bytes to receive
-  # @yield [String] handler block
+  # @yield [String] received data
   # @return [void]
   def recv_loop(maxlen = 8192, &block)
     Polyphony.backend_recv_loop(self, maxlen, &block)
   end
   alias_method :read_loop, :recv_loop
 
-  # call-seq:
-  #   socket.feed_loop(receiver, method)
-  #   socket.feed_loop(receiver, method) { |result| ... }
-  #
   # Receives data from the socket in an infinite loop, passing the data to the
   # given receiver using the given method. If a block is given, the result of
   # the method call to the receiver is passed to the block.
@@ -697,7 +610,6 @@ class ::UNIXSocket < ::BasicSocket
   #
   # @param receiver [any] receiver object
   # @param method [Symbol] method to call
-  # @yield [any] block to handle result of method call to receiver
   # @return [void]
   def feed_loop(receiver, method = :call, &block)
     Polyphony.backend_recv_feed_loop(self, receiver, method, &block)
@@ -729,12 +641,6 @@ class ::UNIXSocket < ::BasicSocket
     Polyphony.backend_send(self, mesg, 0)
   end
 
-  # call-seq:
-  #   socket.readpartial(maxlen) -> string
-  #   socket.readpartial(maxlen, buf) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos) -> buf
-  #   socket.readpartial(maxlen, buf, buf_pos, raise_on_eof) -> buf
-  #
   # Reads up to `maxlen` from the socket. If `buf` is given, it is used as the
   # buffer to read into, otherwise a new string is allocated. If `buf_pos` is
   # given, reads into the given offset (in bytes) in the given buffer. If the

data/lib/polyphony/extensions/thread.rb

@@ -12,7 +12,6 @@ class ::Thread
 
   # Initializes the thread.
   # @param args [Array] arguments to pass to thread block
-  # @yield [any] thread block
   # @return [void]
   def initialize(*args, &block)
     @join_wait_queue = []
@@ -34,12 +33,6 @@ class ::Thread
   # @!visibility private
   alias_method :orig_join, :join
 
-  # call-seq:
-  #   thread.join -> result
-  #   thread.join(timeout) -> result
-  #   thread.await -> result
-  #   thread.await(timeout) -> result
-  # 
   # Waits for the thread to terminate and returns its return value. If the
   # thread terminated with an uncaught exception, it is propagated to the
   # waiting fiber. If a timeout interval is specified, the thread will be
@@ -64,11 +57,6 @@ class ::Thread
   # @!visibility private
   alias_method :orig_raise, :raise
 
-  # call-seq:
-  #   thread.raise
-  #   thread.raise(exception_class)
-  #   thread.raise(exception_instance)
-  # 
   # Raises an exception in the context of the thread. If no exception is given,
   # a `RuntimeError` is raised.
   #
@@ -136,7 +124,6 @@ class ::Thread
 
   # Sets the idle handler for the thread's backend.
   #
-  # @yield [] idle handler
   # @return [Proc] idle handler
   def on_idle(&block)
     backend.idle_proc = block

data/lib/polyphony/extensions/timeout.rb

@@ -13,7 +13,6 @@ module ::Timeout
   # @param sec [Number] timeout period in seconds
   # @param klass [Class] exception class
   # @param message [String] exception message
-  # @yield [] code to run
   # @return [any] block's return value
   def self.timeout(sec, klass = Timeout::Error, message = 'execution expired', &block)
     cancel_after(sec, with_exception: [klass, message], &block)

data/lib/polyphony/net.rb

@@ -4,16 +4,11 @@ require_relative './extensions/socket'
 require_relative './extensions/openssl'
 
 module Polyphony
-  
+
   # A more elegant networking API
   module Net
     class << self
 
-      # call-seq:
-      #   Polyphony::Net.tcp_connect(host, port) -> TCPSocket
-      #   Polyphony::Net.tcp_connect(host, port, secure: true) -> SSLSocket
-      #   Polyphony::Net.tcp_connect(host, port, secure_context: ctx) -> SSLSocket
-      #
       # Create a TCP connection to the given host and port, returning the new
       # socket. If `opts[:secure]` is true, or if an SSL context is given in
       # `opts[:secure_context]`, a TLS handshake is performed, and an SSLSocket
@@ -21,7 +16,9 @@ module Polyphony
       #
       # @param host [String] hostname
       # @param port [Integer] port number
-      # @param opts [Hash] connection options
+      # @param opts [Hash] options to use
+      # @option opts [boolean] :secure use a default context as SSL context, return `SSLSocket` instance
+      # @option opts [OpenSSL::SSL::SSLContext] :secure_context SSL context to use, return `SSLSocket` instance
       # @return [TCPSocket, SSLSocket] connected socket
       def tcp_connect(host, port, opts = {})
         socket = TCPSocket.new(host, port)
@@ -57,7 +54,7 @@ module Polyphony
       # context will select the first protocol from the list given by the client
       # that appears in the list of given protocols, according to the specified
       # order.
-      # 
+      #
       # @param context [SSLContext] SSL context
       # @param protocols [Array] array of supported protocols
       # @return [void]

data/lib/polyphony/version.rb

@@ -2,5 +2,5 @@
 
 module Polyphony
   # @!visibility private
-  VERSION = '0.99.3'
+  VERSION = '0.99.5'
 end

data/lib/polyphony.rb

@@ -43,11 +43,7 @@ module Polyphony
       end
     end
 
-    # call-seq:
-    #   Polyphony.watch_process(cmd)
-    #   Polyphony.watch_process { sleep 1 }
-    # 
-    # Lubnches a process using either a command or a block for a forked process,
+    # Launches a process using either a command or a block for a forked process,
     # waiting for the child process to terminate.
     def watch_process(cmd = nil, &block)
       Polyphony::Process.watch(cmd, &block)
@@ -136,7 +132,7 @@ module Polyphony
   $VERBOSE = nil
   Object.const_set(:Queue, Polyphony::Queue)
   Object.const_set(:Mutex, Polyphony::Mutex)
-  
+
   require 'monitor'
   Object.const_set(:Monitor, Polyphony::Mutex)