Update dotnet docs for upcoming 7.0.0 release

* Start by updating the client lib guide
* Start migrating tutorial code to version 7 of `RabbitMQ.Client`
* Add docusaurus-theme-github-codeblock plugin
* Use plugin for .NET tutorials
* Fix dotnet tutorial one references
* Update dotnet tutorial two to use GitHub references
* Update dotnet tutorial three to use GitHub references
* Update dotnet tutorial four to use GitHub references
* Update dotnet tutorial five and six to use GitHub directly.
* Update dotnet tutorial seven to use GitHub references

Author: lukebakken

client-libraries/dotnet-api-guide.md

@@ -1106,24 +1106,28 @@ using System.IO;
 using System.Text;
 
 using RabbitMQ.client;
-using RabbitMQ.Util;
 
-namespace RabbitMQ.client.Examples {
-  public class TestSSL {
-    public static int Main(string[] args) {
+namespace RabbitMQ.client.Examples
+{
+  public class TestSSL
+  {
+    public static async Task<int> Main(string[] args)
+    {
       ConnectionFactory cf = new ConnectionFactory();
 
       cf.Ssl.Enabled = true;
       cf.Ssl.ServerName = System.Net.Dns.GetHostName();
       cf.Ssl.CertPath = "/path/to/client_key.p12";
       cf.Ssl.CertPassphrase = "MySecretPassword";
 
-      using (IConnection conn = cf.CreateConnection()) {
-        using (IModel ch = conn.CreateModel()) {
+      using (IConnection conn = await cf.CreateConnectionAsync())
+      {
+        using (IChannel ch = await conn.CreateChannelAsync())
+        {
           Console.WriteLine("Successfully connected and opened a channel");
-          ch.QueueDeclare("rabbitmq-dotnet-test", false, false, false, null);
+          await ch.QueueDeclareAsync("rabbitmq-dotnet-test", false, false, false, null);
           Console.WriteLine("Successfully declared a queue");
-          ch.QueueDelete("rabbitmq-dotnet-test");
+          await ch.QueueDeleteAsync("rabbitmq-dotnet-test");
           Console.WriteLine("Successfully deleted the queue");
         }
       }

docs/ssl/index.md

@@ -235,6 +235,10 @@ const config = {
   themeConfig:
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     ({
+      codeblock: {
+        showGithubLink: true,
+        githubLinkLabel: 'View on GitHub'
+      },
       colorMode: {
         respectPrefersColorScheme: true
       },
@@ -435,7 +439,10 @@ const config = {
   markdown: {
     mermaid: true,
   },
-  themes: ['@docusaurus/theme-mermaid'],
+  themes: [
+      '@docusaurus/theme-mermaid',
+      'docusaurus-theme-github-codeblock'
+  ],
 };
 
 export default config;

docusaurus.config.js

@@ -19,6 +19,7 @@
     "@docusaurus/theme-mermaid": "^3.5.2",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^1.2.1",
+    "docusaurus-theme-github-codeblock": "^2.0.2",
     "prism-react-renderer": "^2.1.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",

package-lock.json

@@ -127,78 +127,14 @@ The code is almost the same as in the
 
 The code for `EmitLogTopic.cs`:
 
-```csharp
-using System.Text;
-using RabbitMQ.Client;
-
-var factory = new ConnectionFactory { HostName = "localhost" };
-
-using var connection = factory.CreateConnection();
-using var channel = connection.CreateModel();
-
-channel.ExchangeDeclare(exchange: "topic_logs", type: ExchangeType.Topic);
-
-var routingKey = (args.Length > 0) ? args[0] : "anonymous.info";
-var message = (args.Length > 1)
-              ? string.Join(" ", args.Skip(1).ToArray())
-              : "Hello World!";
-var body = Encoding.UTF8.GetBytes(message);
-channel.BasicPublish(exchange: "topic_logs",
-                     routingKey: routingKey,
-                     basicProperties: null,
-                     body: body);
-Console.WriteLine($" [x] Sent '{routingKey}':'{message}'");
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/EmitLogTopic/EmitLogTopic.cs
 ```
 
 The code for `ReceiveLogsTopic.cs`:
 
-```csharp
-using System.Text;
-using RabbitMQ.Client;
-using RabbitMQ.Client.Events;
-
-var factory = new ConnectionFactory { HostName = "localhost" };
-
-using var connection = factory.CreateConnection();
-using var channel = connection.CreateModel();
-
-channel.ExchangeDeclare(exchange: "topic_logs", type: ExchangeType.Topic);
-// declare a server-named queue
-var queueName = channel.QueueDeclare().QueueName;
-
-if (args.Length < 1)
-{
-    Console.Error.WriteLine("Usage: {0} [binding_key...]",
-                            Environment.GetCommandLineArgs()[0]);
-    Console.WriteLine(" Press [enter] to exit.");
-    Console.ReadLine();
-    Environment.ExitCode = 1;
-    return;
-}
-
-foreach (var bindingKey in args)
-{
-    channel.QueueBind(queue: queueName,
-                      exchange: "topic_logs",
-                      routingKey: bindingKey);
-}
-
-Console.WriteLine(" [*] Waiting for messages. To exit press CTRL+C");
-
-var consumer = new EventingBasicConsumer(channel);
-consumer.Received += (model, ea) =>
-{
-    var body = ea.Body.ToArray();
-    var message = Encoding.UTF8.GetString(body);
-    var routingKey = ea.RoutingKey;
-    Console.WriteLine($" [x] Received '{routingKey}':'{message}'");
-};
-channel.BasicConsume(queue: queueName,
-                     autoAck: true,
-                     consumer: consumer);
-
-Console.WriteLine(" Press [enter] to exit.");
-Console.ReadLine();
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/ReceiveLogsTopic/ReceiveLogsTopic.cs
 ```
 
 Run the following examples:
@@ -242,7 +178,4 @@ Have fun playing with these programs. Note that the code doesn't make
 any assumption about the routing or binding keys, you may want to play
 with more than two routing key parameters.
 
-(Full source code for [EmitLogTopic.cs](https://github.com/rabbitmq/rabbitmq-tutorials/blob/main/dotnet/EmitLogTopic/EmitLogTopic.cs)
-and [ReceiveLogsTopic.cs](https://github.com/rabbitmq/rabbitmq-tutorials/blob/main/dotnet/ReceiveLogsTopic/ReceiveLogsTopic.cs))
-
 Next, find out how to do a round trip message as a remote procedure call in [tutorial 6](./tutorial-six-dotnet).

package.json

@@ -47,24 +47,20 @@ Bindings
 In previous examples we were already creating bindings. You may recall
 code like:
 
-```csharp
-channel.QueueBind(queue: queueName,
-                  exchange: "logs",
-                  routingKey: string.Empty);
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/ReceiveLogs/ReceiveLogs.cs#L15
 ```
 
 A binding is a relationship between an exchange and a queue. This can
 be simply read as: the queue is interested in messages from this
 exchange.
 
 Bindings can take an extra `routingKey` parameter. To avoid the
-confusion with a `BasicPublish` parameter we're going to call it a
+confusion with a `BasicPublishAsync` parameter we're going to call it a
 `binding key`. This is how we could create a binding with a key:
 
 ```csharp
-channel.QueueBind(queue: queueName,
-                  exchange: "direct_logs",
-                  routingKey: "black");
+await channel.QueueBindAsync(queue: queueName, exchange: "direct_logs", routingKey: "black");
 ```
 
 The meaning of a binding key depends on the exchange type. The
@@ -124,18 +120,14 @@ first.
 
 As always, we need to create an exchange first:
 
-```csharp
-channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/EmitLogDirect/EmitLogDirect.cs#L8
 ```
 
 And we're ready to send a message:
 
-```csharp
-var body = Encoding.UTF8.GetBytes(message);
-channel.BasicPublish(exchange: "direct_logs",
-                     routingKey: severity,
-                     basicProperties: null,
-                     body: body);
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/EmitLogDirect/EmitLogDirect.cs#L12-L13
 ```
 
 To simplify things we will assume that 'severity' can be one of
@@ -150,15 +142,8 @@ one exception - we're going to create a new binding for each severity
 we're interested in.
 
 
-```csharp
-var queueName = channel.QueueDeclare().QueueName;
-
-foreach(var severity in args)
-{
-    channel.QueueBind(queue: queueName,
-                      exchange: "direct_logs",
-                      routingKey: severity);
-}
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/ReceiveLogsDirect/ReceiveLogsDirect.cs#L23-L29
 ```
 
 Putting it all together
@@ -171,80 +156,14 @@ Putting it all together
 
 The code for `EmitLogDirect.cs` class:
 
-```csharp
-using System.Text;
-using RabbitMQ.Client;
-
-var factory = new ConnectionFactory { HostName = "localhost" };
-using var connection = factory.CreateConnection();
-using var channel = connection.CreateModel();
-
-channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);
-
-var severity = (args.Length > 0) ? args[0] : "info";
-var message = (args.Length > 1)
-              ? string.Join(" ", args.Skip(1).ToArray())
-              : "Hello World!";
-var body = Encoding.UTF8.GetBytes(message);
-channel.BasicPublish(exchange: "direct_logs",
-                     routingKey: severity,
-                     basicProperties: null,
-                     body: body);
-Console.WriteLine($" [x] Sent '{severity}':'{message}'");
-
-Console.WriteLine(" Press [enter] to exit.");
-Console.ReadLine();
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/EmitLogDirect/EmitLogDirect.cs
 ```
 
 The code for `ReceiveLogsDirect.cs`:
 
-```csharp
-using System.Text;
-using RabbitMQ.Client;
-using RabbitMQ.Client.Events;
-
-var factory = new ConnectionFactory { HostName = "localhost" };
-
-using var connection = factory.CreateConnection();
-using var channel = connection.CreateModel();
-
-channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);
-// declare a server-named queue
-var queueName = channel.QueueDeclare().QueueName;
-
-if (args.Length < 1)
-{
-    Console.Error.WriteLine("Usage: {0} [info] [warning] [error]",
-                            Environment.GetCommandLineArgs()[0]);
-    Console.WriteLine(" Press [enter] to exit.");
-    Console.ReadLine();
-    Environment.ExitCode = 1;
-    return;
-}
-
-foreach (var severity in args)
-{
-    channel.QueueBind(queue: queueName,
-                      exchange: "direct_logs",
-                      routingKey: severity);
-}
-
-Console.WriteLine(" [*] Waiting for messages.");
-
-var consumer = new EventingBasicConsumer(channel);
-consumer.Received += (model, ea) =>
-{
-    var body = ea.Body.ToArray();
-    var message = Encoding.UTF8.GetString(body);
-    var routingKey = ea.RoutingKey;
-    Console.WriteLine($" [x] Received '{routingKey}':'{message}'");
-};
-channel.BasicConsume(queue: queueName,
-                     autoAck: true,
-                     consumer: consumer);
-
-Console.WriteLine(" Press [enter] to exit.");
-Console.ReadLine();
+```csharp reference
+https://github.com/rabbitmq/rabbitmq-tutorials/blob/rabbitmq-dotnet-client-7.0.0/dotnet/ReceiveLogsDirect/ReceiveLogsDirect.cs
 ```
 
 Create projects as usual (see [tutorial one](./tutorial-one-dotnet) for
@@ -275,8 +194,5 @@ dotnet run error "Run. Run. Or it will explode."
 # => [x] Sent 'error':'Run. Run. Or it will explode.'
 ```
 
-(Full source code for [(EmitLogDirect.cs source)](https://github.com/rabbitmq/rabbitmq-tutorials/blob/main/dotnet/EmitLogDirect/EmitLogDirect.cs)
-and [(ReceiveLogsDirect.cs source)](https://github.com/rabbitmq/rabbitmq-tutorials/blob/main/dotnet/ReceiveLogsDirect/ReceiveLogsDirect.cs))
-
 Move on to [tutorial 5](./tutorial-five-dotnet) to find out how to listen
 for messages based on a pattern.