nats-pure 2.0.0.pre.rc1 → 2.0.0.pre.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 210e29c9b6fcc68e5c89e841a068c1a389ac78a67cadcb639161d0d5c02c4bf0
-  data.tar.gz: 2b181886b3a96277ae494cdda48b8bf16e9721666294ea69440976b85888b40c
+  metadata.gz: d16ee062f4cee20fd50abb3d9f78a2e2aa3c92648717ae4e6906e93255920d89
+  data.tar.gz: d4fa9ee8eb06ca8379493de124d7c125dd15a929550316c943be9bd2ae8d8743
 SHA512:
-  metadata.gz: 910ffb697d692a3040fd6b40e835d1a2486f16525a5e814ea33dfdb2e732dd6ba3f1876b5e6dbc7dee07e9491154a6c181b41b2db08988434d9e48900ae3dcf0
-  data.tar.gz: a4e4d9cc9be95d1c67331576c814841b7b7784986a6ac9503ec44846e5dfbf2af978990fe482c8a9ea1064112ab54b4c65cfc619a931a20904f712d2896547a1
+  metadata.gz: ec7aa2c9dd3ce098d7ebdd083ecabe581ebe22302d5cd452feb4e718bebf2b453c455ad6786a0f9bfb7a34f49e348ba9829184521a7f161fbd9ba96df6f39383
+  data.tar.gz: 8667b8373d87a4f905723f881991645c48a731bafd98a6a533316857fa6a6e56e0493edb753a4b9b01be62fa52b6a82c2a32269e337f4f82e105f48ed8602100

data/lib/nats/io/kv.rb

@@ -0,0 +1,172 @@
+# 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_relative 'errors'
+
+module NATS
+  class KeyValue
+    KV_OP = "KV-Operation"
+    KV_DEL = "DEL"
+    KV_PURGE = "PURGE"
+    MSG_ROLLUP_SUBJECT = "sub"
+    MSG_ROLLUP_ALL = "all"
+
+    def initialize(opts={})
+      @name = opts[:name]
+      @stream = opts[:stream]
+      @pre = opts[:pre]
+      @js = opts[:js]
+    end
+
+    # When a key is not found because it was deleted.
+    class KeyDeletedError < NATS::Error; end
+
+    # When there was no bucket present.
+    class BucketNotFoundError < NATS::Error; end
+
+    # When it is an invalid bucket.
+    class BadBucketError < NATS::Error; end
+
+    # get returns the latest value for the key.
+    def get(key)
+      msg = @js.get_last_msg(@stream, "#{@pre}#{key}")
+      entry = Entry.new(bucket: @name, key: key, value: msg.data, revision: msg.seq)
+
+      if not msg.headers.nil?
+        op = msg.headers[KV_OP]
+        raise KeyDeletedError.new("nats: key was deleted") if op == KV_DEL or op == KV_PURGE
+      end
+
+      entry
+    end
+
+    # put will place the new value for the key into the store
+    # and return the revision number.
+    def put(key, value)
+      @js.publish("#{@pre}#{key}", value)
+    end
+
+    # delete will place a delete marker and remove all previous revisions.
+    def delete(key)
+      hdrs = {}
+      hdrs[KV_OP] = KV_DEL
+      @js.publish("#{@pre}#{key}", header: hdrs)
+    end
+
+    # status retrieves the status and configuration of a bucket.
+    def status
+      info = @js.stream_info(@stream)
+      BucketStatus.new(info, @name)
+    end
+
+    Entry = Struct.new(:bucket, :key, :value, :revision, keyword_init: true) do
+      def initialize(opts={})
+        rem = opts.keys - members
+        opts.delete_if { |k| rem.include?(k) }
+        super(opts)
+      end
+    end
+
+    class BucketStatus
+      attr_reader :bucket
+
+      def initialize(info, bucket)
+        @nfo = info
+        @bucket = bucket
+      end
+
+      def values
+        @nfo.state.messages
+      end
+
+      def history
+        @nfo.config.max_msgs_per_subject
+      end
+
+      def ttl
+        @nfo.config.max_age / 1_000_000_000
+      end
+    end
+    
+    module API      
+      KeyValueConfig = Struct.new(:bucket, :description, :max_value_size,
+                                  :history, :ttl, :max_bytes, :storage, :replicas,
+                                  keyword_init: true) do
+        def initialize(opts={})
+          rem = opts.keys - members
+          opts.delete_if { |k| rem.include?(k) }
+          super(opts)
+        end
+      end
+    end
+
+    module Manager
+      def key_value(bucket)
+        stream = "KV_#{bucket}"
+        begin
+          si = stream_info(stream)
+        rescue NATS::JetStream::Error::NotFound
+          raise BucketNotFoundError.new("nats: bucket not found")
+        end
+        if si.config.max_msgs_per_subject < 1
+          raise BadBucketError.new("nats: bad bucket")
+        end
+
+        KeyValue.new(
+          name: bucket,
+          stream: stream,
+          pre: "$KV.#{bucket}.",
+          js: self,
+        )
+      end
+
+      def create_key_value(config)
+        config = if not config.is_a?(JetStream::API::StreamConfig)
+                   KeyValue::API::KeyValueConfig.new(config)
+                 else
+                   config
+                 end
+        config.history ||= 1
+        config.replicas ||= 1
+        if config.ttl
+          config.ttl = config.ttl * 1_000_000_000
+        end
+
+        stream = JetStream::API::StreamConfig.new(
+          name: "KV_#{config.bucket}",
+          subjects: ["$KV.#{config.bucket}.>"],
+          max_msgs_per_subject: config.history,
+          max_bytes: config.max_bytes,
+          max_age: config.ttl,
+          max_msg_size: config.max_value_size,
+          storage: config.storage,
+          num_replicas: config.replicas,
+          allow_rollup_hdrs: true,
+          deny_delete: true,
+        )
+        resp = add_stream(stream)
+
+        KeyValue.new(
+          name: config.bucket,
+          stream: stream.name,
+          pre: "$KV.#{config.bucket}.",
+          js: self,
+        )
+      end
+
+      def delete_key_value(bucket)
+        delete_stream("KV_#{bucket}")
+      end
+    end
+  end
+end

data/lib/nats/io/version.rb

@@ -15,7 +15,7 @@
 module NATS
   module IO
     # VERSION is the version of the client announced on CONNECT to the server.
-    VERSION = "2.0.0-rc1".freeze
+    VERSION = "2.0.0-rc2".freeze
 
     # LANG is the lang runtime of the client announced on CONNECT to the server.
     LANG = "#{RUBY_ENGINE}#{RUBY_VERSION}".freeze

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nats-pure
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.rc1
+  version: 2.0.0.pre.rc2
 platform: ruby
 authors:
 - Waldemar Quevedo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-29 00:00:00.000000000 Z
+date: 2022-01-26 00:00:00.000000000 Z
 dependencies: []
 description: NATS is an open-source, high-performance, lightweight cloud messaging
   system.
@@ -23,6 +23,7 @@ files:
 - lib/nats/io/client.rb
 - lib/nats/io/errors.rb
 - lib/nats/io/js.rb
+- lib/nats/io/kv.rb
 - lib/nats/io/msg.rb
 - lib/nats/io/parser.rb
 - lib/nats/io/subscription.rb