async-nats 0.1.0

data/examples/basic-tls.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# Copyright 2016-2018 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 "openssl"
+
+nats = NATS::IO::Client.new
+
+nats.on_error do |e|
+  puts "Error: #{e}"
+  puts e.backtrace
+end
+
+tls_context = OpenSSL::SSL::SSLContext.new
+tls_context.ssl_version = :TLSv1_2
+
+# Deactivating this makes it possible to connect to server
+# skipping hostname validation...
+tls_context.verify_mode = OpenSSL::SSL::VERIFY_PEER
+tls_context.verify_hostname = true
+
+# Set the RootCAs
+tls_context.cert_store = OpenSSL::X509::Store.new
+ca_file = File.read("./spec/configs/certs/nats-service.localhost/ca.pem")
+tls_context.cert_store.add_cert(OpenSSL::X509::Certificate.new(ca_file))
+
+# The server is setup to use a wildcard certificate for:
+#
+# *.clients.nats-service.localhost
+#
+# so given the options above, having a wrong domain would
+# make the client connection fail with an error
+#
+# Error: SSL_connect returned=1 errno=0 state=error: certificate verify failed (error number 1)
+#
+server = "nats://server-A.clients.nats-service.localhost:4222"
+
+nats.connect(servers: [server], tls: {context: tls_context})
+puts "Connected to #{nats.connected_server}"
+
+nats.subscribe(">") do |msg, reply, subject|
+  puts "Received on '#{subject} #{reply}': #{msg}"
+  nats.publish(reply, "A" * 100) if reply
+end
+
+total = 0
+payload = "c"
+loop do
+  nats.publish("hello.#{total}", payload)
+
+  begin
+    nats.flush(1)
+
+    # Request which waits until given a response or a timeout
+    msg = nats.request("hello", "world")
+    puts "Received on '#{msg.subject} #{msg.reply}': #{msg.data}"
+
+    total += 1
+    sleep 1
+  rescue NATS::IO::Timeout
+    puts "ERROR: flush timeout"
+  end
+end

data/examples/basic-usage.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# Copyright 2016-2018 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"
+
+nats = NATS::IO::Client.new
+
+nats.connect(servers: ["nats://127.0.0.1:4222"])
+puts "Connected to #{nats.connected_server}"
+
+# Simple subscriber
+nats.subscribe("foo.>") { |msg, reply, subject| puts "[Received] on '#{subject}': '#{msg}'" }
+
+# Simple Publisher
+nats.publish("foo.bar.baz", "Hello World!")
+
+# Unsubscribing
+sub = nats.subscribe("bar") { |msg| puts "Received : '#{msg}'" }
+sub.unsubscribe(2)
+
+# Subscribers which reply to requests
+nats.subscribe("help") do |msg, reply, subject|
+  puts "[Received] on '#{subject}' #{reply}: '#{msg}'"
+  nats.publish(reply, "I'll help!") if reply
+end
+
+nats.subscribe(">") do |msg, reply, subject|
+  puts "[Received] via wildcard on '#{subject}' #{reply}: '#{msg}'"
+  nats.publish(reply, "Hi") if reply
+end
+
+# Requests happens asynchronously if given a callback
+nats.request("help", "world", max: 2) do |response|
+  puts "[Response] to '#{response.subject}': #{response.data}'"
+end
+
+# Request without a callback waits for the response or times out.
+begin
+  msg = nats.request("help", "please", timeout: 1.0)
+  puts "[Response] '#{msg.subject}': #{msg.data}"
+rescue NATS::IO::Timeout
+  puts "nats: request timed out"
+end
+
+# Server roundtrip which fails if it does not happen within 500ms
+begin
+  nats.flush(0.5)
+rescue NATS::IO::Timeout
+  puts "nats: flush timeout"
+end
+
+# Closes connection to NATS
+nats.close

data/examples/basic.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Copyright 2016-2018 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"
+
+nats = NATS::IO::Client.new
+
+nats.connect(servers: ["nats://127.0.0.1:4222"])
+puts "Connected to #{nats.connected_server}"
+
+nats.subscribe(">") do |msg, reply, subject|
+  puts "Received on '#{subject} #{reply}': #{msg}"
+  nats.publish(reply, "A" * 100) if reply
+end
+
+total = 0
+payload = "b"
+loop do
+  nats.publish("hello.#{total}", payload)
+
+  begin
+    nats.flush(1)
+
+    # Request which waits until given a response or a timeout
+    msg = nats.request("hello", "world")
+    puts "Received on '#{msg.subject} #{msg.reply}': #{msg.data}"
+
+    total += 1
+    sleep 0.0001 if total % 1000 == 0
+  rescue NATS::IO::Timeout
+    puts "ERROR: flush timeout"
+  end
+end

data/examples/clustered.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# Copyright 2016-2018 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"
+
+$stdout.sync = true
+nats = NATS::IO::Client.new
+
+nats.on_reconnect do
+  puts "Reconnected to server at #{nats.connected_server}"
+end
+
+nats.on_disconnect do
+  puts "Disconnected!"
+end
+
+nats.on_close do
+  puts "Connection to NATS closed"
+end
+
+nats.on_error do |e|
+  puts "Error: #{e}"
+  puts e.backtrace
+end
+
+servers = ["nats://127.0.0.1:4222", "nats://127.0.0.1:4223"]
+
+cluster_opts = {
+  servers: servers,
+  reconnect_time_wait: 1,
+  max_reconnect_attempts: -1, # Infinite reconnects
+  ping_interval: 10,
+  dont_randomize_servers: true,
+  connect_timeout: 2
+}
+
+puts "Attempting to connect to #{servers.first}..."
+nats.connect(cluster_opts)
+
+puts "Connected to #{nats.connected_server}"
+
+msgs_sent = 0
+msgs_received = 0
+bytes_sent = 0
+bytes_received = 0
+
+nats.subscribe("hello") { |msg|
+  msgs_received += 1
+  bytes_received += msg.data.size
+}
+
+Thread.new do
+  loop do
+    puts "#{Time.now} #{Thread.list.count} - [Sent/Received] #{msgs_sent}/#{msgs_received} msgs (#{msgs_sent - msgs_received}) | [Received] #{bytes_sent}/#{bytes_received} B (#{bytes_sent - bytes_received})"
+    sleep 1
+  end
+end
+
+loop do
+  sleep 0.00001
+
+  payload = "world.#{msgs_sent}"
+  nats.publish("hello", payload)
+  msgs_sent += 1
+  bytes_sent += payload.size
+end

data/examples/service_api/basic.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "nats"
+
+client = NATS.connect
+
+service = client.services.add(
+  name: "calc",
+  version: "1.0.0",
+  description: "description"
+)
+
+service.on_stop do
+  puts "Service stopped at #{Time.now}"
+end
+
+service.endpoints.add("min") do |message|
+  min = JSON.parse(message.data).min
+  message.respond(min.to_json)
+end
+
+service.endpoints.add("max") do |message|
+  max = JSON.parse(message.data).max
+  message.respond(max.to_json)
+end
+
+min = client.request("min", [5, 100, -7, 34].to_json)
+max = client.request("max", [5, 100, -7, 34].to_json)
+
+puts "min = #{min.data}, max = #{max.data}"
+
+service.stop

data/examples/service_api/discovery.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "nats"
+
+client = NATS.connect
+
+service = client.services.add(
+  name: "calc",
+  version: "1.0.0"
+)
+
+service.endpoints.add("nothing") do |message|
+  message.respond("nothing")
+end
+
+puts <<~PING
+=== PING ===
+#{client.request("$SRV.PING.calc").data}
+PING
+
+puts <<~INFO
+=== INFO ===
+#{client.request("$SRV.INFO.calc").data}
+INFO
+
+puts <<~STATS
+=== STATS ===
+#{client.request("$SRV.STATS.calc").data}
+STATS
+
+service.stop

data/examples/service_api/errors.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "nats"
+
+client = NATS.connect
+
+service = client.services.add(
+  name: "calc",
+  version: "1.0.0"
+)
+
+service.endpoints.add("raise-error") do |message|
+  raise "raise error"
+end
+
+service.endpoints.add("class-error") do |message|
+  message.respond_with_error(StandardError.new("class error"))
+end
+
+service.endpoints.add("string-error") do |message|
+  message.respond_with_error("string error")
+end
+
+service.endpoints.add("hash-error") do |message|
+  message.respond_with_error(code: 503, description: "hash error")
+end
+
+puts client.request("raise-error").header
+puts client.request("class-error").header
+puts client.request("string-error").header
+puts client.request("hash-error").header
+
+service.stop

data/examples/service_api/groups.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "nats"
+
+client = NATS.connect
+
+service = client.services.add(
+  name: "calc",
+  version: "1.0.0"
+)
+
+arth = service.groups.add("arth")
+agg = service.groups.add("agg")
+
+arth.endpoints.add("sum") do |message|
+  sum = JSON.parse(message.data).sum
+  message.respond(sum.to_json)
+end
+
+agg.endpoints.add("avg") do |message|
+  data = JSON.parse(message.data)
+  message.respond((data.sum / data.size.to_f).to_json)
+end
+
+sum = client.request("arth.sum", [3, 4, 5, 7].to_json)
+avg = client.request("agg.avg", [3, 4, 5, 7].to_json)
+
+puts "sum = #{sum.data}, avg = #{avg.data}"
+
+service.stop

data/examples/service_api/stats.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "nats"
+
+client = NATS.connect
+
+service = client.services.add(
+  name: "calc",
+  version: "1.0.0"
+)
+
+service.on_stats do |endpoint|
+  errors = endpoint.stats.num_errors
+  requests = endpoint.stats.num_requests
+
+  { error_rate: (100.0 * errors / requests).round(2) }
+end
+
+service.endpoints.add("divide") do |message|
+  dividend, divisor = JSON.parse(message.data)
+  message.respond((dividend / divisor).to_json)
+end
+
+client.request("divide", [5, 2].to_json)
+client.request("divide", [7, 0].to_json)
+client.request("divide", [3, 1].to_json)
+client.request("divide", [4, 2].to_json)
+client.request("divide", [8, 0].to_json)
+
+puts <<~INFO
+=== Info ===
+#{service.info}
+INFO
+
+puts <<~STATS
+=== Stats ===
+#{service.stats}
+STATS
+
+service.stop