dapr 0.1.17 → 0.1.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13ce22237006e209c4a40049d3a95efc8f1ce02ac0381453a7c67c1171a9f212
-  data.tar.gz: 8a0f1317ea37de9b33ccffdfb714d25e3ff946dc58562a783c6e082f638dc237
+  metadata.gz: 67d8484ce4365b192ba1756fa63085371e3224370b500a341a3ca2428581a0d3
+  data.tar.gz: c97c4d0b0e40940039f83dc041a81897b958086ba38d1a96b560d6e86dc25874
 SHA512:
-  metadata.gz: 6f871e883715d58a76177a9dbeb52a27ef43eeb5c49e71aaf0fbe844594b81ffaa5e760ae4ecf42fac5a3f1d2904f35194bcf309611aeb256d6b8b4543c4c6f1
-  data.tar.gz: 5875a5e190d97170fb58fc60f8a99be4aeb85280a46d66794ae8e390f390dae3c2e9d82cbb3cf4a0d7c1ca13f9fbba38edd49380a5427817cd93fce20c7b202f
+  metadata.gz: b19abf8c5983476ee14abfe9235fc84f34055a6ab49148bc9eef369a56ee20ca56e5f36e491e1de0e08c3c5cf85b3cb1bc4aad8696f442aaa21eb041f3e5f461
+  data.tar.gz: 565d9d2296feda65259fc5c0b30c5f462a6c44399ae97b7b3d1581751e541c9dc46fa9a1023bfe0924358b3ef870a5c857b17dd9b1263e03531606f8a286c47a

data/Readme.adoc

@@ -6,7 +6,17 @@
 :caution-caption: :fire:
 :warning-caption: :warning:
 endif::[]
-:dapr-building-block: https://docs.dapr.io/concepts/building-blocks-overview/[Dapr Building Block]
+:dapr-building-block: https://docs.dapr.io/concepts/building-blocks-concept/[Dapr Building Block]
+:pubsub-block: https://docs.dapr.io/developing-applications/building-blocks/pubsub/pubsub-overview/[Dapr Pub/Sub Building Block]
+:state-block: https://docs.dapr.io/developing-applications/building-blocks/state-management/state-management-overview/[Dapr State Management Building Block]
+:actors-block: https://docs.dapr.io/developing-applications/building-blocks/actors/actors-overview/[Dapr Actor Building Block]
+:binding-block: https://docs.dapr.io/developing-applications/building-blocks/bindings/bindings-overview/[Dapr Binding Building Block]
+:secret-block: https://docs.dapr.io/developing-applications/building-blocks/secrets/secrets-overview/[Dapr Secret Building Block]
+:configuration-block: https://docs.dapr.io/developing-applications/building-blocks/configuration/configuration-api-overview/[Dapr Configuration Building Block]
+:distributed-lock-block: https://docs.dapr.io/developing-applications/building-blocks/distributed-lock/distributed-lock-api-overview/[Dapr Distributed Lock Building Block]
+:workflow-block: https://docs.dapr.io/developing-applications/building-blocks/workflow/workflow-overview/[Dapr Workflow Building Block]
+:cryptography-block: https://docs.dapr.io/developing-applications/building-blocks/cryptography/cryptography-overview/[Dapr Cryptography Building Block]
+
 
 == Overview
 
@@ -34,7 +44,11 @@ is a more opinionated and higher-level abstraction.
 Each {dapr-building-block} is exposed as a class under the `Rubyists::Dapr::Client` or
 `Rubyists::Dapr::Service` namespace.
 
-=== Publish a message
+=== Pub/Sub
+
+Implementation of {pubsub-block}
+
+==== Publish a message
 
 [source,ruby]
 ----
@@ -47,6 +61,66 @@ publisher.publish('topic-name', { message: 'Hello, Dapr!', from: 'Ruby' })
 <2> Create a new publisher for the `pubsub-name` pubsub component. This component must be defined in the Dapr runtime.
 <3> Publish a message to the `topic-name` topic.
 
+==== Subscribe to topics
+
+Subscriptions in Dapr work a little different than you may be used to. Instead of subscribing to a topic
+then looping through consumed messages, you define a fully-fledged service that Dapr will
+send each message to in the topic(s) that you specify. This unique appreach allows you to
+focus on the business logic of your service, rather than the plumbing of message consumption.
+
+[source,ruby]
+----
+require 'dapr/service/subscriber'
+handler = ->(event) { puts "Got event: #{event}" } <1>
+pubsub_name = 'pubsub' <2>
+topics = 'TOPIC-A' <3>
+sub = Rubyists::Dapr::Service::Subscriber.new(pubsub_name:, topics:, handler:) <4>
+sub.start! <5>
+----
+<1> Define a handler that will be called for each message received. `event` will be a `CloudEvents::Event` instance.
++
+NOTE: The handler can be anything that responds to `#call`, such as a lambda, proc, or instance. Sky's the limit! (Dependency injection, anyone?)
++
+<2> The name of the Dapr pubsub component this subscriber will utilize.
+<3> The name of the topic(s) to subscribe to.
++
+TIP: Multiple topics can be subscribed to simultaneously by passing an array of topic names to the `topics` argument.
++
+<4> Create a new subscriber for the `pubsub` pubsub component, subscribing to the `TOPIC-A` topic.
+<5> Start the subscriber. This will block the current thread and call the handler for each message received.
+
+=== State Management
+
+Implementation of {state-block}
+
+=== Actors
+
+Implementation of {actors-block}
+
+=== Bindings
+
+Implementation of {binding-block}
+
+=== Secrets
+
+Implementation of {secret-block}
+
+=== Configuration
+
+Implementation of {configuration-block}
+
+=== Distributed Lock
+
+Implementation of {distributed-lock-block}
+
+=== Workflow
+
+Implementation of {workflow-block}
+
+=== Cryptography
+
+Implementation of {cryptography-block}
+
 == Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/dapr/version.rb

@@ -2,6 +2,6 @@
 
 module Rubyists
   module Dapr
-    VERSION = '0.1.17'
+    VERSION = '0.1.19'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dapr
 version: !ruby/object:Gem::Version
-  version: 0.1.17
+  version: 0.1.19
 platform: ruby
 authors:
 - Tj (bougyman) Vanderpoel
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-04-16 00:00:00.000000000 Z
+date: 2024-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dapr-ruby