nats-io/nats.net v2.1.0-preview.1

NATS.Net v2.1.0-preview.1

on GitHub

This is a preview version of NATS.Net client with a few big improvements.

What's Changed

• Expose ReplyTo on NatsJSMsg by @rickdotnet in #314
• Suggested fixes to interfaces by @sspates in #297
• Use System.IO.Pipelines for sending by @caleblloyd in #303
• NatsSub cancellation token race fix by @mtmk in #325

New Contributors

• @rickdotnet made their first contribution in #314
• @sspates made their first contribution in #297

Full Changelog: v2.0.3...v2.1.0-preview.1

Big thanks to our contributors @sspates, @rickdotnet, @to11mtm and @jasper-d. You're awesome! 💯

The main improvement with this release comes in #303 thanks to @caleblloyd's implementation of System.IO.Pipelines for send buffers. We have seen great improvement on memory performance with this fix reducing GC load significantly. 🚀

Happy coding! ❤️

Breaking Changes

There are a few changes that might require minimal code changes on some applications. Please check the list and test your applications as always:

• Publish options WaitUntilSent and the error handler callback are now not used and marked as such. #303
• NatsConnection members HeaderParser and GetStats() are changed to be internal. See #297 for details
• You might observe behaviour changes in cancellation. You might need to handle TaskCanceledException and OperationCanceledException in your calls to make sure token cancellations are processed gracefully.

Nuget Packages

NATS.Net

This is the main meta package containing all other packages except serialization.

dotnet add package NATS.Net --version 2.1.0-preview.1

If you are not deploying Native AOT you can also use ad-hoc JSON serialization:

dotnet add package NATS.Client.Serializers.Json --version 2.1.0-preview.1

Individual Packages

dotnet add package NATS.Client.Core --version 2.1.0-preview.1
dotnet add package NATS.Client.Hosting --version 2.1.0-preview.1
dotnet add package NATS.Client.JetStream --version 2.1.0-preview.1
dotnet add package NATS.Client.KeyValueStore --version 2.1.0-preview.1
dotnet add package NATS.Client.ObjectStore --version 2.1.0-preview.1
dotnet add package NATS.Client.Services --version 2.1.0-preview.1
dotnet add package NATS.Client.Serializers.Json --version 2.1.0-preview.1