Publisher first version (#9)

* Publisher First version
---------

Signed-off-by: Gabriele Santomaggio <[email protected]>

Author: Gsantomaggio

Directory.Packages.props

@@ -4,7 +4,7 @@
   </PropertyGroup>
   <ItemGroup>
     <!-- RabbitMQ.Amqp.Client -->
-    <PackageVersion Include="AMQPNetLite.Core" Version="2.4.10" />
+    <PackageVersion Include="AMQPNetLite.Core" Version="2.4.11" />
     <PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="3.3.4" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.5.0" />
     <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="1.1.1" />
@@ -17,4 +17,16 @@
     <PackageVersion Include="coverlet.collector" Version="3.2.0" />
     <!-- docs/**/*.csproj -->
   </ItemGroup>
+  <ItemGroup Label=".NET 6 Specific" Condition="'$(TargetFramework)' == 'net6.0'">
+    <!-- RabbitMQ.Amqp.Client -->
+    <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="6.0.0" />
+  </ItemGroup>
+  <ItemGroup Label=".NET 7 Specific" Condition="'$(TargetFramework)' == 'net7.0'">
+    <!-- RabbitMQ.Amqp.Client -->
+    <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="7.0.0" />
+  </ItemGroup>
+  <ItemGroup Label=".NET 8 Specific" Condition="'$(TargetFramework)' == 'net8.0'">
+    <!-- RabbitMQ.Amqp.Client -->
+    <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="8.0.1" />
+  </ItemGroup>
 </Project>

README.md

@@ -4,5 +4,28 @@
 This library is in early stages of development.
 It is meant to be used with RabbitMQ 4.0.
 
+## How to Run
+- start the broker with `ci/start-broker.sh`
+- run the tests with ` dotnet test ./Build.csproj  --logger "console;verbosity=detailed" /p:AltCover=true`
 
+## Getting Started
+You can find an example in: `docs/Examples/GettingStarted`
+
+
+## TODO
+
+- [x] Declare queues
+- [ ] Declare exchanges
+- [ ] Declare bindings
+- [x] Simple Publish messages
+- [x] Implement backpressure ( atm it is implemented with MaxInflightMessages `MaxInFlight(2000).`)
+- [ ] Simple Consume messages
+- [ ] Implement metrics ( See `System.Diagnostics.DiagnosticSource` [Link](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/metrics-instrumentation) )
+- [x] Recovery connection on connection lost
+- [x] Recovery management on connection lost
+- [x] Recovery queues on connection lost
+- [ ] Recovery publisher on connection lost
+- [ ] Recovery consumer on connection lost
+- [ ] Docker image to test in LRE 
+- [ ] Check the TODO in the code
 

RabbitMQ.AMQP.Client/IAddressBuilder.cs

@@ -0,0 +1,13 @@
+namespace RabbitMQ.AMQP.Client;
+
+public class InvalidAddressException(string message) : Exception(message);
+
+public interface IAddressBuilder<out T>
+{
+
+    T Exchange(string exchange);
+
+    T Queue(string queue);
+
+    T Key(string key);
+}

RabbitMQ.AMQP.Client/IClosable.cs

@@ -9,15 +9,20 @@ public enum State
     Closed,
 }
 
-public class Error
+public class Error(string? errorCode, string? description)
 {
-    public string? Description { get; internal set; }
-    public string? ErrorCode { get; internal set; }
+    public string? Description { get; } = description;
+    public string? ErrorCode { get; } = errorCode;
+
+    public override string ToString()
+    {
+        return $"Code: {ErrorCode} - Description: {Description}";
+    }
 }
 
-public interface IClosable
+public interface IClosable // TODO: Create an abstract class with the event and the State property
 {
-    public State State { get;  }
+    public State State { get; }
 
     Task CloseAsync();
 

RabbitMQ.AMQP.Client/IConnection.cs

@@ -1,8 +1,8 @@
 namespace RabbitMQ.AMQP.Client;
 
-public class ConnectionException(string? message, Exception? innerException) : Exception(message, innerException);
+public class ConnectionException(string? message) : Exception(message);
 
-public interface IConnection : IClosable
+public interface IConnection
 {
     IManagement Management();
     Task ConnectAsync();

RabbitMQ.AMQP.Client/IEntities.cs

@@ -26,11 +26,11 @@ public interface IQueueSpecification : IEntityDeclaration<IQueueInfo>
     IQueueSpecification Arguments(Dictionary<object, object> arguments);
 
     public Dictionary<object, object> Arguments();
-    
+
     IQueueSpecification Type(QueueType type);
-    
+
     public QueueType Type();
-    
+
     // IQuorumQueueSpecification Quorum();
 }
 

RabbitMQ.AMQP.Client/IManagement.cs

@@ -10,7 +10,7 @@ public interface IManagement : IClosable
     IQueueSpecification Queue(string name);
 
     IQueueDeletion QueueDeletion();
-    
+
     ITopologyListener TopologyListener();
 }
 

RabbitMQ.AMQP.Client/IMessage.cs

@@ -2,9 +2,7 @@ namespace RabbitMQ.AMQP.Client;
 
 public interface IMessage
 {
-    IMessage Body(object body);
-    object Body();
-
+    public object Body();
     // properties
     string MessageId();
     IMessage MessageId(string id);

RabbitMQ.AMQP.Client/IPublisher.cs

@@ -0,0 +1,26 @@
+namespace RabbitMQ.AMQP.Client;
+
+public class PublisherException(string message) : Exception(message);
+
+public enum OutcomeState
+{
+    Accepted,
+    Failed,
+}
+
+public class OutcomeDescriptor(ulong code, string description, OutcomeState state, Error? error)
+{
+    public OutcomeState State { get; internal set; } = state;
+    public ulong Code { get; internal set; } = code;
+    public string Description { get; internal set; } = description;
+
+    public Error? Error { get; internal set; } = error;
+}
+
+public delegate void OutcomeDescriptorCallback(IMessage message, OutcomeDescriptor outcomeDescriptor);
+
+public interface IPublisher : IClosable
+{
+    Task Publish(IMessage message,
+        OutcomeDescriptorCallback outcomeCallback); // TODO: Add CancellationToken and callBack
+}

RabbitMQ.AMQP.Client/IPublisherBuilder.cs

@@ -0,0 +1,9 @@
+namespace RabbitMQ.AMQP.Client;
+
+public interface IPublisherBuilder : IAddressBuilder<IPublisherBuilder>
+{
+    IPublisherBuilder PublishTimeout(TimeSpan timeout);
+
+    IPublisherBuilder MaxInflightMessages(int maxInFlight);
+    IPublisher Build();
+}