Pulsar.Client
2.18.0
See the version list below for details.
dotnet add package Pulsar.Client --version 2.18.0
NuGet\Install-Package Pulsar.Client -Version 2.18.0
<PackageReference Include="Pulsar.Client" Version="2.18.0" />
<PackageVersion Include="Pulsar.Client" Version="2.18.0" />
<PackageReference Include="Pulsar.Client" />
paket add Pulsar.Client --version 2.18.0
#r "nuget: Pulsar.Client, 2.18.0"
#addin nuget:?package=Pulsar.Client&version=2.18.0
#tool nuget:?package=Pulsar.Client&version=2.18.0
pulsar-client-dotnet
Contributions and stars ★ are most welcome!
Pulsar.Client nuget | Pulsar.Client.Otel nuget
Supported pulsar cluster versions: 2.4+
Find examples of usage in /examples folder. We are trying to keep api similar to the Java client, so please take a look at it's documentation to understand possible options available. You can also join telegram chat https://t.me/pro_pulsar for further discussions.
Features list (based on Client Feature Matrix):
- Basic Producer/Consumer API
- Partitioned topics
- Batching
- Chunking
- Compression
- TLS
- Authentication (token, tls, oauth2)
- Reader API
- Proxy Support
- Effectively-Once
- Schema (All types, Multi-version)
- Consumer seek
- Multi-topics consumer
- Topics regex consumer
- Compacted topics
- User defined properties
- Reader hasMessageAvailable
- Hostname verification
- Multi Hosts Service Url
- Key_shared subscription
- Key based batcher
- Negative Acknowledge
- Delayed/scheduled messages
- Dead Letter Policy
- Interceptors
- Transactions
- Statistics
- End-to-end Encryption
- SubscriptionInitialPosition
- Cumulative Ack
- Batch-Index Ack
- SNI Routing
- Table view
Quick contributing guide
Common steps before building
- Fork and clone locally
- Install dotnet tools:
dotnet tool restore
- Restore packages:
dotnet restore
MacOS steps before building:
- Install Snappy:
brew install snappy
- Install Libzstd:
brew install zstd
Ubuntu steps before building:
- Install Snappy:
sudo apt-get install -y libsnappy-dev
- Install Libzstd:
sudo apt-get install -y libzstd-dev
Building and Testing
- Build the solution:
dotnet build
(dotnet core sdk required) This will install required tools and then you can use any IDE to build solution - Make your modifications
- Run unit tests:
cd tests/UnitTests
&&dotnet test
- (Optional) If changes are made in Client logic, run Integration tests. Before running do the following
- Install pulsar cluster:
- MacOS guide:
brew tap streamlio/homebrew-formulae
brew install streamlio/homebrew-formulae/pulsar
brew install streamlio/homebrew-formulae/bookkeeper
brew services start pulsar
brew services start bookkeeper
- Run commands in
/tests/IntegrationTests/commands.txt
- Change
pulsarAddress
in Common.fs to point your pulsar cluster - Ensure
public/default
namespace with default settings - Ensure
public/retention
namespace with time or storage size retention configured
- Install pulsar cluster:
- Send a Pull Request
Maintaners
- @Lanayx
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Apache.Avro (>= 1.12.0)
- AvroSchemaGenerator (>= 2.10.0)
- FSharp.Core (>= 9.0.100)
- FSharp.UMX (>= 1.1.0)
- K4os.Compression.LZ4 (>= 1.3.8)
- Microsoft.Bcl.AsyncInterfaces (>= 9.0.0)
- Microsoft.Extensions.Caching.Memory (>= 9.0.0)
- Microsoft.Extensions.Http (>= 9.0.0)
- Microsoft.Extensions.Logging (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- Microsoft.IO.RecyclableMemoryStream (>= 3.0.1)
- NSec.Cryptography (= 20.2.0)
- PemUtils (>= 3.0.0.82)
- Pipelines.Sockets.Unofficial (>= 2.2.8)
- protobuf-net (>= 3.2.45)
- protobuf-net.Reflection (>= 3.2.12)
- Snappy.Standard (>= 0.2.0)
- System.IO.Pipelines (>= 9.0.0)
- System.Text.Json (>= 9.0.0)
- System.Threading.Channels (>= 9.0.0)
- zlib.net-mutliplatform (>= 1.0.8)
- ZstdNet (>= 1.4.5)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Pulsar.Client:
Package | Downloads |
---|---|
Pulsar.Client.Otel
OpenTelemetry plugin for Pulsar.Client |
|
Zq.Utils.Core
.NET Standard2.0、.NET Standard2.1、.NET5、.NET6版本工具类 |
|
DotNetCore.CAP.Pulsar
Distributed transaction solution in micro-service base on eventually consistency, also an eventbus with Outbox pattern. |
|
SnD.Sdk
SDK for Sneaks&Data OSS Projects |
|
RJ.Commons.Pulsar
Default Pulsar API for Aries project. |
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on Pulsar.Client:
Repository | Stars |
---|---|
dotnetcore/CAP
Distributed transaction solution in micro-service base on eventually consistency, also an eventbus with Outbox pattern
|
|
LeonKou/NetPro
🌈An enhanced version with clean architecture of asp.netcore,efficiently manage startup,Support for netcore3.1/6.0
|
Version | Downloads | Last updated |
---|---|---|
3.9.2 | 265 | 3 days ago |
3.9.1 | 934 | 14 days ago |
3.9.0 | 957 | 21 days ago |
3.8.1 | 5,307 | a month ago |
3.8.0 | 1,369 | a month ago |
3.7.0 | 20,292 | 2 months ago |
3.6.2 | 41,013 | 4 months ago |
3.6.1 | 39,570 | 5 months ago |
3.6.0 | 117,130 | 8 months ago |
3.5.4 | 9,237 | 9 months ago |
3.5.3 | 2,025 | 9 months ago |
3.5.2 | 8,051 | 9 months ago |
3.5.1 | 9,076 | 10 months ago |
3.5.0 | 6,989 | 5/15/2024 |
3.4.0 | 4,063 | 4/19/2024 |
3.3.1 | 3,014 | 3/28/2024 |
3.3.0 | 38,028 | 2/12/2024 |
3.2.0 | 1,809 | 2/1/2024 |
3.1.0 | 20,901 | 11/19/2023 |
3.0.0 | 785 | 11/17/2023 |
3.0.0-beta.2 | 159 | 10/22/2023 |
3.0.0-beta.1 | 122 | 10/15/2023 |
2.18.3 | 25 | 17 hours ago |
2.18.2 | 172 | 14 days ago |
2.18.1 | 165 | 14 days ago |
2.18.0 | 170 | 21 days ago |
2.17.0 | 206 | 4 months ago |
2.16.0 | 10,323 | 4/29/2024 |
2.15.2 | 2,434 | 3/7/2024 |
2.15.1 | 793 | 2/12/2024 |
2.15.0 | 44,521 | 11/18/2023 |
2.14.0 | 1,102 | 11/14/2023 |
2.13.2 | 37,148 | 10/11/2023 |
2.13.1 | 3,441 | 9/29/2023 |
2.13.0 | 48,545 | 9/25/2023 |
2.12.7 | 21,000 | 8/9/2023 |
2.12.6 | 43,279 | 7/23/2023 |
2.12.4 | 4,761 | 7/17/2023 |
2.12.3 | 17,106 | 7/6/2023 |
2.12.2 | 108,925 | 3/31/2023 |
2.12.1 | 24,188 | 3/22/2023 |
2.12.0 | 10,884 | 1/29/2023 |
2.11.0 | 39,775 | 10/13/2022 |
2.10.4 | 14,494 | 10/7/2022 |
2.10.3 | 2,896 | 9/16/2022 |
2.10.2 | 53,406 | 6/22/2022 |
2.10.1 | 67,271 | 3/9/2022 |
2.10.0 | 41,191 | 2/23/2022 |
2.9.4 | 21,898 | 12/5/2021 |
2.9.3 | 3,511 | 11/26/2021 |
2.9.2 | 1,210 | 11/11/2021 |
2.9.1 | 29,859 | 10/14/2021 |
2.9.0 | 2,080 | 9/29/2021 |
2.8.1 | 5,396 | 9/9/2021 |
2.8.0 | 2,182 | 9/2/2021 |
2.7.2 | 9,048 | 8/26/2021 |
2.7.1 | 7,396 | 8/6/2021 |
2.7.0 | 7,259 | 7/20/2021 |
2.6.3 | 2,071 | 7/15/2021 |
2.6.2 | 1,959 | 7/9/2021 |
2.6.1 | 1,342 | 7/6/2021 |
2.6.0 | 6,685 | 7/5/2021 |
2.5.3 | 1,167 | 7/2/2021 |
2.5.2 | 1,305 | 6/30/2021 |
2.5.1 | 1,605 | 6/29/2021 |
2.5.0 | 1,248 | 6/27/2021 |
2.4.1 | 1,452 | 6/25/2021 |
2.4.0 | 2,619 | 6/14/2021 |
2.3.3 | 1,558 | 6/8/2021 |
2.3.1 | 2,767 | 5/11/2021 |
2.3.0 | 1,316 | 5/11/2021 |
2.2.0 | 2,197 | 4/22/2021 |
2.1.1 | 1,280 | 4/14/2021 |
2.1.0 | 4,614 | 3/16/2021 |
2.0.4 | 2,286 | 3/5/2021 |
2.0.3 | 1,285 | 3/5/2021 |
2.0.2 | 2,603 | 2/23/2021 |
2.0.1 | 9,288 | 2/17/2021 |
2.0.0 | 1,286 | 2/12/2021 |
1.8.5 | 9,387 | 2/10/2021 |
1.8.4 | 25,895 | 1/25/2021 |
1.8.3 | 2,343 | 1/6/2021 |
1.8.2 | 3,348 | 12/17/2020 |
1.8.1 | 4,418 | 12/15/2020 |
1.8.0 | 4,005 | 12/10/2020 |
1.7.8 | 90,597 | 5/17/2021 |
1.7.7 | 1,204 | 5/17/2021 |
1.7.6 | 1,279 | 5/17/2021 |
1.7.5 | 3,124 | 10/30/2020 |
1.7.4 | 6,776 | 10/19/2020 |
1.7.3 | 28,732 | 10/13/2020 |
1.7.2 | 1,767 | 10/2/2020 |
1.7.1 | 4,961 | 9/17/2020 |
1.7.0 | 1,591 | 9/14/2020 |
1.6.3 | 1,397 | 9/12/2020 |
1.6.2 | 1,495 | 9/3/2020 |
1.6.1 | 1,353 | 9/2/2020 |
1.6.0 | 1,502 | 8/30/2020 |
1.5.0 | 10,800 | 8/3/2020 |
1.4.3 | 2,483 | 7/9/2020 |
1.4.2 | 1,561 | 7/2/2020 |
1.4.1 | 1,278 | 6/29/2020 |
1.4.0 | 1,759 | 6/17/2020 |
1.3.0 | 1,479 | 6/14/2020 |
1.2.0 | 2,841 | 5/27/2020 |
1.1.1 | 1,377 | 5/22/2020 |
1.1.0 | 1,970 | 5/15/2020 |
1.0.1 | 1,336 | 5/14/2020 |
1.0.0 | 1,353 | 5/14/2020 |
0.18.4 | 1,897 | 4/21/2020 |
0.18.3 | 1,536 | 4/18/2020 |
0.18.2 | 3,266 | 4/8/2020 |
0.18.1 | 1,369 | 4/7/2020 |
0.18.0 | 1,568 | 4/1/2020 |
0.17.0 | 1,563 | 3/21/2020 |
0.16.0 | 1,407 | 3/19/2020 |
0.15.0 | 1,992 | 2/28/2020 |
0.14.1 | 1,391 | 2/25/2020 |
0.14.0 | 1,326 | 2/21/2020 |
0.13.1 | 1,366 | 2/19/2020 |
0.13.0 | 1,724 | 2/14/2020 |
0.12.0 | 2,074 | 12/31/2019 |
0.11.2 | 1,559 | 12/23/2019 |
0.11.1 | 1,478 | 12/20/2019 |
0.11.0 | 1,423 | 12/16/2019 |
0.10.0 | 1,496 | 11/17/2019 |
0.9.1 | 1,558 | 11/14/2019 |
0.9.0 | 1,477 | 11/12/2019 |
0.8.2 | 1,501 | 11/9/2019 |
0.8.1 | 1,494 | 11/4/2019 |
0.8.0 | 1,425 | 11/2/2019 |
0.7.0 | 1,449 | 10/25/2019 |
0.6.0 | 1,513 | 10/16/2019 |
0.5.0 | 1,442 | 10/15/2019 |
0.4.0 | 1,471 | 10/8/2019 |
0.3.0 | 1,444 | 10/7/2019 |
0.2.0 | 1,564 | 9/30/2019 |
0.1.5 | 1,307 | 9/13/2019 |
0.1.4 | 1,270 | 9/9/2019 |
0.1.3 | 1,247 | 9/9/2019 |
0.1.2 | 1,207 | 9/9/2019 |
0.1.1 | 1,323 | 9/6/2019 |
0.1.0 | 1,340 | 9/6/2019 |
Split client TLS transport encryption from authentication