nats-pure 2.4.0 → 2.5.0

data/lib/nats/service/status.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module NATS
+  class Service
+    class Status
+      attr_reader :service, :started_at
+
+      def initialize(service)
+        @service = service
+        @started_at = Time.now
+      end
+
+      def basic
+        {
+          name: service.name,
+          id: service.id,
+          version: service.version,
+          metadata: service.metadata
+        }
+      end
+
+      def info
+        {
+          **basic,
+          description: service.description,
+          endpoints: service.endpoints.map do |endpoint|
+            {
+              name: endpoint.name,
+              subject: endpoint.subject,
+              queue_group: endpoint.queue,
+              metadata: endpoint.metadata
+            }
+          end
+        }
+      end
+
+      def stats
+        {
+          **basic,
+          started: started_at.utc.iso8601,
+          endpoints: service.endpoints.map do |endpoint|
+            endpoint_stats(endpoint)
+          end
+        }
+      end
+
+      private
+
+      def endpoint_stats(endpoint)
+        endpoint.stats.synchronize do
+          {
+            name: endpoint.name,
+            subject: endpoint.subject,
+            queue_group: endpoint.queue,
+            num_requests: endpoint.stats.num_requests,
+            processing_time: endpoint.stats.processing_time,
+            average_processing_time: endpoint.stats.average_processing_time,
+            num_errors: endpoint.stats.num_errors,
+            last_error: endpoint.stats.last_error,
+            data: service.callbacks.call(:stats, endpoint)
+          }
+        end
+      end
+    end
+  end
+end

data/lib/nats/service/validator.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module NATS
+  class Service
+    module Validator
+      REGEX = {
+        name: /[A-Za-z0-9\-_]+$/,
+        version: /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/,
+        subject: /^[^ >]*[>]?$/,
+        queue: /^[^ >]*[>]?$/
+      }.freeze
+
+      class << self
+        def validate(values)
+          raise InvalidNameError unless valid?(values, :name)
+          raise InvalidVersionError unless valid?(values, :version)
+          raise InvalidSubjectError unless valid?(values, :subject) || nil?(values, :subject)
+          raise InvalidQueueError unless valid?(values, :queue) || nil?(values, :queue)
+        end
+
+        def valid?(values, key)
+          !values.has_key?(key) || values[key] =~ REGEX[key]
+        end
+
+        def nil?(values, key)
+          values.has_key?(key) && values[key].nil?
+        end
+      end
+    end
+  end
+end

data/lib/nats/service.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "monitor"
+
+require_relative "service/group"
+require_relative "service/endpoint"
+require_relative "service/errors"
+
+require_relative "service/validator"
+require_relative "service/callbacks"
+require_relative "service/monitoring"
+require_relative "service/status"
+require_relative "service/stats"
+
+module NATS
+  class Service
+    include MonitorMixin
+
+    DEFAULT_QUEUE = "q"
+
+    attr_reader :client, :name, :id, :version, :description, :metadata, :queue
+    attr_reader :monitoring, :status, :callbacks, :groups, :endpoints
+
+    def initialize(client, options)
+      super()
+      validate(options)
+
+      setup_options(options)
+      setup_internals(client)
+    end
+
+    def on_stats(&block)
+      callbacks.register(:stats, &block)
+    end
+
+    def on_stop(&block)
+      callbacks.register(:stop, &block)
+    end
+
+    def stopped?
+      !!@stopped
+    end
+
+    def stop(error = nil)
+      return if stopped?
+
+      synchronize do
+        monitoring&.stop
+        endpoints&.each(&:stop)
+
+        callbacks&.call(:stop, error)
+      end
+    ensure
+      synchronize { @stopped = true }
+    end
+
+    def reset
+      endpoints.each(&:reset)
+    end
+
+    def info
+      status.info
+    end
+
+    def stats
+      status.stats
+    end
+
+    def service
+      self
+    end
+
+    def subject
+      nil
+    end
+
+    private
+
+    def validate(options)
+      Validator.validate(options.slice(:name, :version, :queue))
+    end
+
+    def setup_options(options)
+      @name = options[:name]
+      @version = options[:version]
+      @description = options[:description]
+      @metadata = options[:metadata].freeze
+      @queue = options[:queue] || DEFAULT_QUEUE
+    end
+
+    def setup_internals(client)
+      @client = client
+      @id = NATS::NUID.next
+
+      @monitoring = Monitoring.new(self)
+      @status = Status.new(self)
+      @callbacks = Callbacks.new(self)
+
+      @groups = Groups.new(self)
+      @endpoints = Endpoints.new(self)
+    end
+  end
+
+  class Services < NATS::Utils::List
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+      super
+    end
+
+    def add(options)
+      client.synchronize do
+        service = NATS::Service.new(client, options)
+        insert(service)
+
+        service
+      end
+    end
+  end
+end

data/lib/nats/utils/list.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module NATS
+  class Utils
+    class List
+      include Enumerable
+
+      attr_reader :parent
+
+      def initialize(parent)
+        @parent = parent
+        @items = Set.new
+      end
+
+      def each
+        @items.each do |item|
+          yield item
+        end
+      end
+
+      def insert(item)
+        @items << item
+      end
+    end
+  end
+end

data/lib/nats-pure.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require "nats/io/client"
+require "nats/utils/list"
+require "nats/service"

data/lib/nats.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # 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.
@@ -12,8 +14,10 @@
 # limitations under the License.
 #
 
-require 'nats/io/client'
-require 'nats/nuid'
+require "nats/utils/list"
+require "nats/io/client"
+require "nats/service"
+require "nats/nuid"
 
 # A thread safe Ruby client for the NATS messaging system (https://nats.io).
 #
@@ -25,15 +29,15 @@ require 'nats/nuid'
 #
 #   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: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Waldemar Quevedo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-22 00:00:00.000000000 Z
+date: 2025-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -24,6 +24,160 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: uri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: securerandom
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nkeys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: resolv-replace
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: NATS is an open-source, high-performance, lightweight cloud messaging
   system.
 email:
@@ -32,8 +186,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
+- lib/nats-pure.rb
 - lib/nats.rb
 - lib/nats/client.rb
 - lib/nats/io/client.rb
@@ -65,6 +221,16 @@ files:
 - lib/nats/io/version.rb
 - lib/nats/io/websocket.rb
 - lib/nats/nuid.rb
+- lib/nats/service.rb
+- lib/nats/service/callbacks.rb
+- lib/nats/service/endpoint.rb
+- lib/nats/service/errors.rb
+- lib/nats/service/group.rb
+- lib/nats/service/monitoring.rb
+- lib/nats/service/stats.rb
+- lib/nats/service/status.rb
+- lib/nats/service/validator.rb
+- lib/nats/utils/list.rb
 - sig/nats/io/client.rbs
 - sig/nats/io/errors.rbs
 - sig/nats/io/jetstream.rbs
@@ -95,7 +261,12 @@ files:
 homepage: https://nats.io
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/nats-io/nats-pure.rb/issues
+  changelog_uri: https://github.com/nats-io/nats-pure.rb/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/nats-io/nats-pure.rb
+  homepage_uri: https://github.com/nats-io/nats-pure.rb
+  source_code_uri: https://github.com/nats-io/nats-pure.rb
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -104,14 +275,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: NATS is an open-source, high-performance, lightweight cloud messaging system.