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:

package.json

@@ -47,10 +47,8 @@ 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
@@ -62,9 +60,7 @@ confusion with a `BasicPublish` 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.