Build valid and verified MQTT topics
MqttTopicBuilder is a small library without any dependency that can help you to enforce the validity of your MQTT topics by using the provided builder.
You can find this projet on NuGet.
From the command line:
dotnet add package MqttTopicBuilderFrom the package manager:
Install-Package MqttTopicBuilderUsing a custom builder, MqttTopicBuilder allows you to build topics and ensure
their validity regarding the way you are planning to use them.
var subscribeTo = new TopicBuilder(TopicConsumer.Subscriber)
.AddTopic("Hello")
.AddTopic("From")
.AddTopics("Mqtt", "Topic", "Builder")
.AddMultiLevelWildcard()
.Build();
Console.WriteLine(subscribeTo);
// -> "Hello/From/Mqtt/Topic/Builder/#"
var publishTop = new TopicBuilder(TopicConsumer.Publisher)
.AddTopic("Hello")
.AddTopic("From")
.AddTopics("Mqtt", "Topic", "Builder")
.AddMultiLevelWildcard()
.Build();
// Will throw an exception since wildcards are not allowed when publishing
// on a topicThe object built is a Topic object. It can be used to both access the topic
but also gather informations about it such as its level.
var topic = new TopicBuilder(TopicConsumer.Subscriber)
.AddTopic("Hello")
.AddTopic("World")
.Build();
Console.WriteLine(topic.Value);
// -> "Hello/World"
Console.WriteLine(topic.Levels);
// -> 2Topics can also be built using the regular constructor or the extension method:
var topic = Topic.FromString("Hello/World");
// or: var topic = (Topic) "Hello/World";
Console.WriteLine(topic.Value);
// -> "Hello/World"
Console.WriteLine(topic.Levels);
// -> 2Topic integrity can also be checked using the TopicValidator methods
TopicValidator.ValidateTopic("a/wrong/#/Topic");
// Will throw an exception since no topic is allowed after '#'
"wrong+Topic".ValidateTopicForAppending();
// Will throw an exception since '+' is not allowed in a topicAll contributions are welcome, please feel free to suggest pull requests ! You can read more about it in the CONTRIBUTING.md.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent