service_mesh 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fef05ef9dacd492215d76304b8f1938056e862e35c0e0450f7b120213bf7e8d7
-  data.tar.gz: 97cb3e42dc4797d618d3eacf61aa3d2ba994887aa94ee88d37d90b6b04211fb6
+  metadata.gz: edccbfa1e181934bed8df91ecb53d15849335cb10730450e088fee1e28ac44ef
+  data.tar.gz: 64cbe1ba2b464e7ccd1dc840066eedf2dd0cd4639804af86e0fde65615cf064c
 SHA512:
-  metadata.gz: c7da5185432f80a50b73ec3942c736367455bc337918b7afba2b8393a1575353e54a9fbdb54d98aeaf03c7b0922766490a8da075c8daf4d2a58087044e1e448b
-  data.tar.gz: 4418d34275bc4dd1d532b4b84f48361967601275181c64c50c5cb7ca7177ddecd9ebdedbb773d813d07e55307efeb24b63c2753a8c6881ea66803e1e619f3127
+  metadata.gz: bdff9e8e86405e3fcca5df769e800d317df47307d4974c88f9161728c165242ecfa7acf72880bfb41b2606f310c30a6fd6cf35dbb56d22dab202d27e1201725f
+  data.tar.gz: c3513ecbc6ae3832509419f8f3b9e9c93c637199eb6d8fd9b9183ef4046bf75d53dd3cc1cc73ee6d16dcaa2b116626956068ce3e3569404aba69bb90e0bc3e7a

data/README.md

@@ -1,15 +1,11 @@
 # service-mesh-ruby
 
-The Ruby contract for the
-[Service Mesh API Specification](https://github.com/Paymentbox-com/service-mesh-api),
-packaged as the gem `service_mesh`. It holds what every transport and every
+service-mesh-ruby is the Ruby contract for the
+[Service Mesh API Specification](https://github.com/Paymentbox-com/service-mesh-api).
+It is packaged as the gem `service_mesh`. It holds what every transport and every
 caller must agree on, and nothing that moves bytes. Transports are separate
 gems that depend on it and implement `Client` and `Runtime`.
 
-The [gRPC Service Mesh API](https://github.com/Paymentbox-com/grpc-service-mesh-api) is a protocol layer that generates code against this contract from protobuf
-definitions, through its Ruby library [grpc-service-mesh-ruby](https://github.com/Paymentbox-com/grpc-service-mesh-ruby). Other protocol layers may be implemented 
-to do the same. 
-
 ## Install
 
 ```ruby
@@ -21,34 +17,27 @@ Requires Ruby 3.3 or newer. The gem has no runtime dependencies.
 
 ## What it Implements
 
-- The value types from the specification: `ServiceMesh::Target`, `ServiceMesh::ServiceMap`, 
-  `ServiceMesh::Message`, `ServiceMesh::Endpoint` and `ServiceMesh::Subscriber`.
+- The value types from the specification: `ServiceMesh::Target`, `ServiceMesh::ServiceMap`,
+  `ServiceMesh::Message`, `ServiceMesh::Endpoint`, and `ServiceMesh::Subscriber`.
 - Target Kinds are implemented as `:route` and `:topic`. A `Target` built with a kind outside the two
   raises `KindMismatch`.
 - `Message#payload` is always `Encoding::BINARY`.
-- `Target#same_channel?` compares segments and kind and ignores metadata. 
-- The configuration keys the specification defines: `DEPLOYMENT_GROUP_KEY`,
-  `CONSUMER_GROUP_KEY`, and the value `CONSUMER_GROUP_NONE`.
+- `Target#same_channel?` compares segments and kind and ignores metadata.
+- The configuration keys the specification defines. `DEPLOYMENT_GROUP_KEY` is runtime
+  configuration. `CONSUMER_GROUP_KEY`, with the value `CONSUMER_GROUP_NONE`, is `Endpoint` and
+  `Subscriber` metadata.
 - The errors defined by the specification as `ServiceMesh::Error`: `ServiceMesh::KindMismatch`,
-  `ServiceMesh::InvalidTarget`, `ServiceMesh::NoDeploymentGroup`.
+  `ServiceMesh::InvalidTarget`, and `ServiceMesh::NoDeploymentGroup`.
 - A conformance suite a transport runs against its own `Client` and
   `Runtime`.
 
-`Client` and `Runtime` are duck types. The specification names their methods;
-a transport satisfies the contract by responding to them and by passing the
+`Client` and `Runtime` are duck types. The specification names their methods,
+and a transport satisfies the contract by responding to them and by passing the
 conformance suite.
 
-## Transports
-
-- NATS: [service-mesh-nats-ruby](https://github.com/Paymentbox-com/service-mesh-nats-ruby),
-  gem `service_mesh_nats`.
-
-The Go counterpart of this gem is
-[service-mesh-go](https://github.com/Paymentbox-com/service-mesh-go).
-
 ## Usage
 
-A transport that implements Client and Runtime according to the specification will used the
+A transport that implements `Client` and `Runtime` according to the specification uses the
 types defined here.
 
 ```ruby
@@ -84,10 +73,18 @@ RSpec.describe MyTransport do
 end
 ```
 
-The suite covers kind checks, the deployment group requirement, request and
-reply with metadata both ways, publish, the consumer-group delivery
-permutations across two runtimes, a standalone client refusing requests after
-close, the runtime's client being the one it was given and closed by stop, the lifecycle state machine, and drain completing and expiring.
+The suite covers:
+
+- kind checks
+- the deployment group requirement
+- request and reply with metadata both ways
+- publish
+- the consumer-group delivery permutations across two runtimes
+- a standalone client refusing requests after close
+- the runtime's client being the one it was given and closed by stop
+- the lifecycle state machine
+- drain completing and expiring
+
 Anything that names a transport's own errors, config keys, or address syntax
 stays in the transport's specs.
 
@@ -97,10 +94,9 @@ stays in the transport's specs.
 mise install
 just install
 just check      # lint, test, build
+just test       # tests only
 ```
 
-## Tests
-
-```
-just test
-```
+Releasing is described in [publishing.md](publishing.md). `just bump patch`,
+`just bump minor`, or `just bump major` raises the version in
+`lib/service_mesh/version.rb` and commits that file.

data/lib/service_mesh/rspec.rb

@@ -161,14 +161,18 @@ RSpec.shared_examples "a service mesh transport" do
       end
     end
 
-    it "honours a group set on the target rather than the binding" do
+    it "ignores a group set on the target, which carries none" do
       count = Queue.new
       %w[a b].each do |group|
         t = ServiceMesh::Target.new(segments: topic_target.segments, kind: :topic, metadata: {ServiceMesh::CONSUMER_GROUP_KEY => group})
         serve(config_for("same"), subscribers: [subscriber(t, ->(_) { count << true })])
       end
+
       client.publish(message(topic_target))
-      wait_until { count.size == 2 }
+
+      wait_until { count.size >= 1 }
+      sleep 0.1 # let an unwanted extra delivery show up
+      expect(count.size).to eq(1)
     end
   end
 

data/lib/service_mesh/types.rb

@@ -4,7 +4,10 @@ module ServiceMesh
   KINDS = %i[route topic].freeze
 
   # Configuration keys the specification defines. Everything else belongs to
-  # a transport.
+  # a transport. DEPLOYMENT_GROUP_KEY is runtime configuration, and nothing
+  # else carries it. CONSUMER_GROUP_KEY is Endpoint and Subscriber metadata;
+  # when it is unset or empty, the runtime's deployment group applies, and
+  # CONSUMER_GROUP_NONE means no group. A Target carries neither.
   DEPLOYMENT_GROUP_KEY = "deployment_group"
   CONSUMER_GROUP_KEY = "consumer_group"
   CONSUMER_GROUP_NONE = "none"

data/lib/service_mesh/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ServiceMesh
-  VERSION = "0.4.1"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,17 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: service_mesh
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
+- Bryant Morrill
 - Paymentbox
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
+- bryantreadmorrill@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []