nats-pure 0.6.0 → 2.0.0.pre.alpha

data/lib/nats/io/msg.rb

@@ -0,0 +1,56 @@
+# Copyright 2016-2021 The NATS Authors
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+require_relative 'js'
+
+module NATS
+  class Msg
+    attr_accessor :subject, :reply, :data, :header
+
+    # Enhance it with ack related methods from JetStream to ack msgs.
+    include JetStream::Msg::AckMethods
+
+    def initialize(opts={})
+      @subject = opts[:subject]
+      @reply   = opts[:reply]
+      @data    = opts[:data]
+      @header  = opts[:header]
+      @nc      = opts[:nc]
+      @sub     = opts[:sub]
+      @ackd    = false
+      @meta    = nil
+    end
+
+    def respond(data='')
+      return unless @nc
+      if self.header
+        dmsg = self.dup
+        dmsg.subject = self.reply
+        dmsg.data = data
+        @nc.publish_msg(dmsg)
+      else
+        @nc.publish(self.reply, data)
+      end
+    end
+
+    def respond_msg(msg)
+      return unless @nc
+      @nc.publish_msg(msg)
+    end
+
+    def inspect
+      hdr = ", header=#{@header}" if @header
+      "#<NATS::Msg(subject: \"#{@subject}\", reply: \"#{@reply}\", data: #{@data.slice(0, 10).inspect}#{hdr})>"
+    end
+  end
+end

data/lib/nats/io/parser.rb

@@ -16,6 +16,7 @@ module NATS
   module Protocol
 
     MSG      = /\AMSG\s+([^\s]+)\s+([^\s]+)\s+(([^\s]+)[^\S\r\n]+)?(\d+)\r\n/i
+    HMSG     = /\AHMSG\s+([^\s]+)\s+([^\s]+)\s+(([^\s]+)[^\S\r\n]+)?([\d]+)\s+(\d+)\r\n/i
     OK       = /\A\+OK\s*\r\n/i
     ERR      = /\A-ERR\s+('.+')?\r\n/i
     PING     = /\APING\s*\r\n/i
@@ -49,6 +50,7 @@ module NATS
         @sid = nil
         @reply = nil
         @needed = nil
+        @header_needed = nil
       end
 
       def parse(data)
@@ -61,26 +63,30 @@ module NATS
               @buf = $'
               @sub, @sid, @reply, @needed = $1, $2.to_i, $4, $5.to_i
               @parse_state = AWAITING_MSG_PAYLOAD
+            when HMSG
+              @buf = $'
+              @sub, @sid, @reply, @header_needed, @needed = $1, $2.to_i, $4, $5.to_i, $6.to_i
+              @parse_state = AWAITING_MSG_PAYLOAD
             when OK # No-op right now
               @buf = $'
             when ERR
               @buf = $'
-              @nc.process_err($1)
+              @nc.send(:process_err, $1)
             when PING
               @buf = $'
-              @nc.process_ping
+              @nc.send(:process_ping)
             when PONG
               @buf = $'
-              @nc.process_pong
+              @nc.send(:process_pong)
             when INFO
               @buf = $'
               # First INFO message is processed synchronously on connect,
               # and onwards we would be receiving asynchronously INFO commands
               # signaling possible changes in the topology of the NATS cluster.
-              @nc.process_info($1)
+              @nc.send(:process_info, $1)
             when UNKNOWN
               @buf = $'
-              @nc.process_err("Unknown protocol: #{$1}")
+              @nc.send(:process_err, "Unknown protocol: #{$1}")
             else
               # If we are here we do not have a complete line yet that we understand.
               return
@@ -89,9 +95,17 @@ module NATS
 
           when AWAITING_MSG_PAYLOAD
             return unless (@needed && @buf.bytesize >= (@needed + CR_LF_SIZE))
-            @nc.process_msg(@sub, @sid, @reply, @buf.slice(0, @needed))
-            @buf = @buf.slice((@needed + CR_LF_SIZE), @buf.bytesize)
-            @sub = @sid = @reply = @needed = nil
+            if @header_needed
+              hbuf = @buf.slice(0, @header_needed)
+              payload = @buf.slice(@header_needed, (@needed-@header_needed))
+              @nc.send(:process_msg, @sub, @sid, @reply, payload, hbuf)
+              @buf = @buf.slice((@needed + CR_LF_SIZE), @buf.bytesize)
+            else
+              @nc.send(:process_msg, @sub, @sid, @reply, @buf.slice(0, @needed), nil)
+              @buf = @buf.slice((@needed + CR_LF_SIZE), @buf.bytesize)
+            end
+
+            @sub = @sid = @reply = @needed = @header_needed = nil
             @parse_state = AWAITING_CONTROL_LINE
             @buf = nil if (@buf && @buf.empty?)
           end

data/lib/nats/io/subscription.rb

@@ -0,0 +1,92 @@
+# Copyright 2016-2021 The NATS Authors
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module NATS
+
+  # A Subscription represents interest in a given subject.
+  # 
+  # @example Create NATS subscription with callback.
+  #   require 'nats/client'
+  # 
+  #   nc = NATS.connect("demo.nats.io")
+  #   sub = nc.subscribe("foo") do |msg|
+  #     puts "Received [#{msg.subject}]: #{}"
+  #   end
+  # 
+  class Subscription
+    include MonitorMixin
+
+    attr_accessor :subject, :queue, :future, :callback, :response, :received, :max, :pending, :sid
+    attr_accessor :pending_queue, :pending_size, :wait_for_msgs_t, :wait_for_msgs_cond, :is_slow_consumer
+    attr_accessor :pending_msgs_limit, :pending_bytes_limit
+    attr_accessor :nc
+    attr_accessor :jsi
+    attr_accessor :closed
+
+    def initialize
+      super # required to initialize monitor
+      @subject  = ''
+      @queue    = nil
+      @future   = nil
+      @callback = nil
+      @response = nil
+      @received = 0
+      @max      = nil
+      @pending  = nil
+      @sid      = nil
+      @nc       = nil
+      @closed   = nil
+
+      # State from async subscriber messages delivery
+      @pending_queue       = nil
+      @pending_size        = 0
+      @pending_msgs_limit  = nil
+      @pending_bytes_limit = nil
+      @wait_for_msgs_t     = nil
+      @is_slow_consumer    = false
+
+      # Sync subscriber
+      @wait_for_msgs_cond = nil
+    end
+
+    # Auto unsubscribes the server by sending UNSUB command and throws away
+    # subscription in case already present and has received enough messages.
+    def unsubscribe(opt_max=nil)
+      @nc.send(:unsubscribe, self, opt_max)
+    end
+
+    # next_msg blocks and waiting for the next message to be received.
+    def next_msg(opts={})
+      timeout = opts[:timeout] ||= 0.5
+      synchronize do
+        return @pending_queue.pop if not @pending_queue.empty?
+
+        # Wait for a bit until getting a signal.
+        MonotonicTime::with_nats_timeout(timeout) do
+          wait_for_msgs_cond.wait(timeout)
+        end
+
+        if not @pending_queue.empty?
+          return @pending_queue.pop
+        else
+          raise NATS::Timeout
+        end
+      end
+    end
+
+    def inspect
+      "#<NATS::Subscription(subject: \"#{@subject}\", queue: \"#{@queue}\", sid: #{@sid})>"
+    end
+  end
+end

data/lib/nats/io/version.rb

@@ -1,4 +1,4 @@
-# Copyright 2016-2018 The NATS Authors
+# Copyright 2016-2021 The NATS Authors
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -14,9 +14,13 @@
 
 module NATS
   module IO
-    # NOTE: These are all announced to the server on CONNECT
-    VERSION  = "0.6.0"
-    LANG     = "#{RUBY_ENGINE}2".freeze
+    # VERSION is the version of the client announced on CONNECT to the server.
+    VERSION = "2.0.0-alpha".freeze
+
+    # LANG is the lang runtime of the client announced on CONNECT to the server.
+    LANG = "#{RUBY_ENGINE}#{RUBY_VERSION}".freeze
+
+    # PROTOCOL is the supported version of the protocol in the client.
     PROTOCOL = 1
   end
 end

data/lib/nats.rb

@@ -0,0 +1,39 @@
+# Copyright 2021 The NATS Authors
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'nats/io/client'
+require 'nats/nuid'
+
+# A thread safe Ruby client for the NATS messaging system (https://nats.io).
+#
+# @example Service example
+#   nc = NATS.connect("demo.nats.io")
+#   nc.subscribe("foo") do |msg|
+#     msg.respond("Hello World")
+#   end
+#
+#   resp = nc.request("foo")
+#   puts "Received: #{msg.data}"
+# 
+# 
+# @example Stream example
+#   nc = NATS.connect("demo.nats.io")
+#   sub = nc.subscribe("foo")
+# 
+#   nc.publish("foo")
+#   msg = sub.next_msg
+#   puts "Received: #{msg.data}"
+# 
+module NATS
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nats-pure
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 2.0.0.pre.alpha
 platform: ruby
 authors:
 - Waldemar Quevedo
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-06-19 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies: []
 description: NATS is an open-source, high-performance, lightweight cloud messaging
   system.
@@ -18,15 +18,21 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/nats.rb
+- lib/nats/client.rb
 - lib/nats/io/client.rb
+- lib/nats/io/errors.rb
+- lib/nats/io/js.rb
+- lib/nats/io/msg.rb
 - lib/nats/io/parser.rb
+- lib/nats/io/subscription.rb
 - lib/nats/io/version.rb
 - lib/nats/nuid.rb
 homepage: https://nats.io
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -37,12 +43,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: NATS is an open-source, high-performance, lightweight cloud messaging system.
 test_files: []