Add BotConfiguration to control receiving updates

Introduced BotConfiguration class to manage bot settings, including the ReceiveUpdates property. Updated Program.cs to configure BotBuilder with ReceiveUpdates set to false. Modified BotApp and BotBuilder to utilize BotConfiguration for conditional update handling. Refactored UseApiKey method in BotBuilder.

Author: bvdcode

Sources/TelegramBot.ConsoleTest/Program.cs

@@ -11,6 +11,7 @@ public class Program
         public static void Main(string[] args)
         {
             BotBuilder builder = new BotBuilder(args)
+                .Setup(x => x.ReceiveUpdates = false)
                 .UseApiKey(x => x.FromConfiguration());
 
             builder.Services

Sources/TelegramBot/BotApp.cs

@@ -28,6 +28,7 @@ public class BotApp : IBot
         private readonly ILogger<BotApp> _logger;
         private readonly TelegramBotClient _client;
         private readonly ServiceProvider _serviceProvider;
+        private readonly BotConfiguration _botConfiguration;
         private IReadOnlyCollection<MethodInfo> _controllerMethods;
         private readonly CancellationTokenSource _cancellationTokenSource;
 
@@ -41,10 +42,12 @@ public class BotApp : IBot
         /// </summary>
         /// <param name="client">Telegram bot client.</param>
         /// <param name="serviceProvider">Service provider.</param>
-        public BotApp(TelegramBotClient client, ServiceProvider serviceProvider)
+        /// <param name="botConfiguration">Bot configuration.</param>
+        public BotApp(TelegramBotClient client, ServiceProvider serviceProvider, BotConfiguration botConfiguration)
         {
             _client = client;
             _serviceProvider = serviceProvider;
+            _botConfiguration = botConfiguration;
             _controllerMethods = new List<MethodInfo>();
             _cancellationTokenSource = new CancellationTokenSource();
             _logger = serviceProvider.GetRequiredService<ILogger<BotApp>>();
@@ -104,8 +107,15 @@ public async Task StartAsync(CancellationToken cancellationToken = default)
             try
             {
                 var botUser = _client.GetMe().Result;
-                _client.StartReceiving(UpdateHandler, ErrorHandler, cancellationToken: mergedToken);
-                _logger.LogInformation("Bot '{botUser}' started - receiving updates.", botUser.Username);
+                if (_botConfiguration.ReceiveUpdates)
+                {
+                    _client.StartReceiving(UpdateHandler, ErrorHandler, cancellationToken: mergedToken);
+                    _logger.LogInformation("Bot '{botUser}' started - receiving updates.", botUser.Username);
+                }
+                else
+                {
+                    _logger.LogInformation("Bot '{botUser}' started - not receiving updates.", botUser.Username);
+                }
             }
             catch (Exception ex)
             {

Sources/TelegramBot/Builders/BotBuilder.cs

@@ -55,6 +55,7 @@ public BotBuilder(params string[] args)
             Services.AddSingleton<IConfigurationRoot>(Configuration);
         }
 
+        private readonly BotConfiguration _botConfiguration = new BotConfiguration();
         private string _baseApiUrl = Constants.DefaultBaseApiUrl;
         private string? _token;
 
@@ -88,13 +89,13 @@ public BotBuilder UseTelegramServer(Action<TelegramServerBuilder> configure)
         /// <summary>
         /// Use the API key for the Telegram bot.
         /// </summary>
-        /// <param name="value">The configuration for the Telegram API key.</param>
+        /// <param name="setupApiKey">The configuration for the Telegram API key.</param>
         /// <returns>This instance of <see cref="BotBuilder"/>.</returns>
         /// <exception cref="ArgumentNullException">Thrown when the Telegram bot token is not set in the configuration.</exception>
-        public BotBuilder UseApiKey(Action<TelegramApiKeyBuilder> value)
+        public BotBuilder UseApiKey(Action<TelegramApiKeyBuilder> setupApiKey)
         {
             TelegramApiKeyBuilder builder = new TelegramApiKeyBuilder();
-            value(builder);
+            setupApiKey(builder);
             if (!string.IsNullOrWhiteSpace(builder.ApiKey))
             {
                 _token = builder.ApiKey;
@@ -121,6 +122,17 @@ public BotBuilder UseServices(IServiceCollection services)
             return this;
         }
 
+        /// <summary>
+        /// Setup the bot parameters.
+        /// </summary>
+        /// <param name="setup">The configuration for the bot.</param>
+        /// <returns>This instance of <see cref="BotBuilder"/>.</returns>
+        public BotBuilder Setup(Action<BotConfiguration> setup)
+        {
+            setup(_botConfiguration);
+            return this;
+        }
+
         /// <summary>
         /// Build the bot.
         /// </summary>
@@ -140,7 +152,7 @@ public IBot Build()
                 Services.AddSingleton<IKeyValueProvider, InMemoryKeyValueProvider>();
             }
             Services.AddSingleton<IHostApplicationLifetime, HostApplicationLifetime>();
-            return new BotApp(client, Services.BuildServiceProvider());
+            return new BotApp(client, Services.BuildServiceProvider(), _botConfiguration);
         }
     }
 }

Sources/TelegramBot/Builders/BotConfiguration.cs

@@ -0,0 +1,13 @@
+namespace TelegramBot.Builders
+{
+    /// <summary>
+    /// Bot configuration.
+    /// </summary>
+    public class BotConfiguration
+    {
+        /// <summary>
+        /// Gets or sets a value indicating whether the bot should receive updates. Default is <see langword="true"/>.
+        /// </summary>
+        public bool ReceiveUpdates { get; set; } = true;
+    }
+}