<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Guides on Davish.Sendr</title><link>https://davidchen617.github.io/Davish.Sendr/guides/</link><description>Recent content in Guides on Davish.Sendr</description><generator>Hugo</generator><language>en-US</language><atom:link href="https://davidchen617.github.io/Davish.Sendr/guides/index.xml" rel="self" type="application/rss+xml"/><item><title>Registering handlers</title><link>https://davidchen617.github.io/Davish.Sendr/guides/registering-handlers/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/registering-handlers/</guid><description>&lt;p&gt;Covers manual registration for requests, commands, and queries. For streams, see the&#10;&amp;ldquo;Streams&amp;rdquo; section below. For the source-generated alternative, see&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/"&gt;Enabling source generation&lt;/a&gt;. Background on how these&#10;kinds relate is in &lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/"&gt;Dispatch model&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="requests"&gt;Requests&lt;a class="anchor" href="#requests"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;IRequest&lt;/code&gt; for a command with no return value:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrder&lt;/span&gt;(Guid Id) : IRequest;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;CreateOrder&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(CreateOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; for request/response:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrder&lt;/span&gt;(Guid Id) : IRequest&amp;lt;OrderDto&amp;gt;;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderDto&lt;/span&gt;(Guid Id, &lt;span style="color:#66d9ef"&gt;string&lt;/span&gt; Number);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;GetOrder, OrderDto&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task&amp;lt;OrderDto&amp;gt; HandleAsync(GetOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.FromResult(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; OrderDto(request.Id, &lt;span style="color:#e6db74"&gt;&amp;#34;SO-001&amp;#34;&lt;/span&gt;));&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Register both, then dispatch through &lt;code&gt;ISender&lt;/code&gt;:&lt;/p&gt;</description></item><item><title>Using decorators</title><link>https://davidchen617.github.io/Davish.Sendr/guides/using-decorators/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/using-decorators/</guid><description>&lt;p&gt;Background on the pipeline model and ordering rules is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/decorator-pipeline/"&gt;Decorator pipeline&lt;/a&gt;. This guide shows the manual and&#10;generated ways to attach one.&lt;/p&gt;&#10;&lt;h2 id="manual-xdecoratorwitht"&gt;Manual: &lt;code&gt;x.Decorator.With&amp;lt;T&amp;gt;()&lt;/code&gt;&lt;a class="anchor" href="#manual-xdecoratorwitht"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Pass a &lt;code&gt;configure&lt;/code&gt; delegate to the registration call and chain &lt;code&gt;With&amp;lt;T&amp;gt;()&lt;/code&gt; in outer-to-inner&#10;order:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&amp;gt;(x =&amp;gt; x.Decorator&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;TransactionDecorator&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;LoggingDecorator&amp;gt;());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Here &lt;code&gt;TransactionDecorator&lt;/code&gt; is outermost (runs first and last); &lt;code&gt;LoggingDecorator&lt;/code&gt; is nested&#10;inside it.&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;LoggingDecorator&lt;/span&gt;(ILogger&amp;lt;LoggingDecorator&amp;gt; logger)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; : IRequestDecorator, IRequestDecorator.WithResponse&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;async&lt;/span&gt; Task HandleAsync&amp;lt;TRequest&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;where&lt;/span&gt; TRequest : IRequest&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;async&lt;/span&gt; Task&amp;lt;TResponse&amp;gt; HandleAsync&amp;lt;TRequest, TResponse&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate&amp;lt;TResponse&amp;gt; next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;where&lt;/span&gt; TRequest : IRequest&amp;lt;TResponse&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; response = &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; response;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Implementing both &lt;code&gt;IRequestDecorator&lt;/code&gt; and &lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt; on one class lets&#10;it wrap both &lt;code&gt;IRequest&lt;/code&gt; and &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; handlers. The same pattern applies to&#10;&lt;code&gt;ICommandDecorator&lt;/code&gt;/&lt;code&gt;ICommandDecorator.WithResponse&lt;/code&gt;, &lt;code&gt;IQueryDecorator&lt;/code&gt;,&#10;&lt;code&gt;IStreamRequestDecorator&lt;/code&gt;, and &lt;code&gt;INotificationDecorator&lt;/code&gt; — see&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/"&gt;Publishing notifications&lt;/a&gt; for the notification-specific setup.&lt;/p&gt;</description></item><item><title>Publishing notifications</title><link>https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/</guid><description>&lt;p&gt;Background on Sequence/Parallel semantics and exception aggregation is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/notification-model/"&gt;Notification model&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="define-the-notification-and-its-handlers"&gt;Define the notification and its handlers&lt;a class="anchor" href="#define-the-notification-and-its-handlers"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderPlaced&lt;/span&gt;(Guid OrderId) : INotification;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;ReserveInventoryHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;SendConfirmationEmailHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="register-manual"&gt;Register: manual&lt;a class="anchor" href="#register-manual"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Call &lt;code&gt;AddSendrNotification()&lt;/code&gt; once, then register every handler for a notification type in a&#10;single &lt;code&gt;AddNotificationHandler&lt;/code&gt; call, assigning each one to the Sequence and/or Parallel&#10;group:&lt;/p&gt;</description></item><item><title>Enabling source generation</title><link>https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/</guid><description>&lt;p&gt;Background on what the generator does and why is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/compile-time-discovery/"&gt;Compile-time discovery&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="install"&gt;Install&lt;a class="anchor" href="#install"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;3.5.0&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&amp;gt;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr.Generators&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;2.1.0&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;PrivateAssets=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;all&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;PrivateAssets=&amp;quot;all&amp;quot;&lt;/code&gt; keeps the generator itself (an analyzer-style package) from flowing&#10;into downstream consumers of the project.&lt;/p&gt;&#10;&lt;h2 id="turn-it-on"&gt;Turn it on&lt;a class="anchor" href="#turn-it-on"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services.AddSendr(o =&amp;gt; o.UseGenerators());&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services.AddSendrNotification(o =&amp;gt; o.UseGenerators());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;AddSendr()&lt;/code&gt;/&lt;code&gt;AddSendrNotification()&lt;/code&gt; alone (without &lt;code&gt;UseGenerators()&lt;/code&gt;) keep the default&#10;reflection-based sender/publisher. Once &lt;code&gt;UseGenerators()&lt;/code&gt; is used, manual &lt;code&gt;AddXHandler&lt;/code&gt;/&#10;&lt;code&gt;AddNotificationHandler&lt;/code&gt; calls for that same sender/publisher do not extend its dispatch&#10;table — pick one registration style per sender and per publisher.&lt;/p&gt;</description></item><item><title>Migrating from deprecated packages</title><link>https://davidchen617.github.io/Davish.Sendr/guides/migrating-from-deprecated-packages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/migrating-from-deprecated-packages/</guid><description>&lt;p&gt;Three packages are deprecated compatibility shims. Each has no content of its own — it&#10;exists only so that a project already referencing it keeps resolving, via a dependency on&#10;the package it was merged into — and each is slated for removal in a future major version.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Deprecated package&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Merged into&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Since&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt; 3.1.0+&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt; carried &lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;ICommandHandler&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt;/&lt;code&gt;IQueryHandler&lt;/code&gt;.&#10;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt; and &lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt; carried&#10;&lt;code&gt;INotification&lt;/code&gt;/&lt;code&gt;INotificationHandler&lt;/code&gt;/&lt;code&gt;INotificationDecorator&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt; (and the&#10;&lt;code&gt;AddSendrNotification&lt;/code&gt;/&lt;code&gt;AddNotificationHandler&lt;/code&gt; registration surface). All of these types&#10;live in the &lt;code&gt;Davish.Sendr&lt;/code&gt; namespace both before and after the move, so migrating is a&#10;package-reference change, not a &lt;code&gt;using&lt;/code&gt;/namespace change:&lt;/p&gt;</description></item><item><title>Tracing</title><link>https://davidchen617.github.io/Davish.Sendr/guides/tracing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/tracing/</guid><description>&lt;p&gt;Sendr emits &lt;a href="https://learn.microsoft.com/dotnet/api/system.diagnostics.activity"&gt;&lt;code&gt;Activity&lt;/code&gt;&lt;/a&gt;&#10;spans for every request, command, query, and notification it dispatches. The spans come from&#10;one &lt;code&gt;ActivitySource&lt;/code&gt; named &lt;code&gt;Davish.Sendr&lt;/code&gt;, so any listener that can subscribe to an&#10;&lt;code&gt;ActivitySource&lt;/code&gt; by name — OpenTelemetry&amp;rsquo;s tracer provider, or your own &lt;code&gt;ActivityListener&lt;/code&gt; —&#10;can collect them.&lt;/p&gt;&#10;&lt;p&gt;Nothing is emitted until a listener subscribes. There is no switch to turn on in&#10;&lt;code&gt;AddSendr()&lt;/code&gt;, &lt;code&gt;AddSendrNotification()&lt;/code&gt;, or &lt;code&gt;UseGenerators()&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;The exact span names and tags are listed in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/reference/tracing-spans-and-tags/"&gt;Tracing spans and tags&lt;/a&gt;.&lt;/p&gt;</description></item></channel></rss>