Soenneker.Utils.RateLimiting.Executor 3.0.82

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Soenneker.Utils.RateLimiting.Executor --version 3.0.82                
NuGet\Install-Package Soenneker.Utils.RateLimiting.Executor -Version 3.0.82                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Soenneker.Utils.RateLimiting.Executor" Version="3.0.82" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Soenneker.Utils.RateLimiting.Executor --version 3.0.82                
#r "nuget: Soenneker.Utils.RateLimiting.Executor, 3.0.82"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Soenneker.Utils.RateLimiting.Executor as a Cake Addin
#addin nuget:?package=Soenneker.Utils.RateLimiting.Executor&version=3.0.82

// Install Soenneker.Utils.RateLimiting.Executor as a Cake Tool
#tool nuget:?package=Soenneker.Utils.RateLimiting.Executor&version=3.0.82                

alternate text is missing from this package README image alternate text is missing from this package README image alternate text is missing from this package README image

alternate text is missing from this package README image Soenneker.Utils.RateLimiting.Executor

A thread-safe utility designed to manage the rate at which tasks are executed, ensuring they are not run more frequently than a specified interval.

RateLimitingExecutor is ideal for interacting with rate-limited APIs or throttling the execution of resource-intensive tasks.

Sequential Execution

Tasks, ValueTasks, and Actions are executed one at a time. If the defined interval between executions has passed, the task runs immediately; otherwise, it waits until the interval elapses before proceeding.

⚠️ Important Notes:

  • This is not a background queue processor. Each method awaits the result of the asynchronous operation before continuing.

  • Asynchronous methods will not block the calling thread, but synchronous methods will block execution until it completes.

Want to use this with dependency injection?

Check out the singleton factory implementation: Soenneker.Utils.RateLimiting.Factory

Installation

dotnet add package Soenneker.Utils.RateLimiting.Executor

Example: Executing a Loop of Tasks with Rate Limiting

Below is an example demonstrating how to use the RateLimitingExecutor to execute a series of tasks while maintaining a rate limit.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Soenneker.Utils.RateLimiting.Executor;

public class Program
{
    public static async Task Main(string[] args)
    {
        var rateLimitingExecutor = new RateLimitingExecutor(TimeSpan.FromSeconds(2));

        for (int i = 0; i < 5; i++)
        {
            await rateLimitingExecutor.Execute(async ct =>
            {
                Console.WriteLine($"Executing Task {i + 1} at {DateTime.Now:HH:mm:ss}");
                await Task.Delay(100); // Simulate some work
            });
        }
    }
}

Console Output

Executing Task 1 at 14:00:00
Executing Task 2 at 14:00:02
Executing Task 3 at 14:00:04
Executing Task 4 at 14:00:06
Executing Task 5 at 14:00:08
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Soenneker.Utils.RateLimiting.Executor:

Package Downloads
Soenneker.Utils.RateLimiting.Factory

An async thread-safe singleton dictionary for Soenneker.Utils.RateLimiting.Executors, designed to manage the rate at which tasks are executed.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.85 0 12/5/2024
3.0.84 0 12/4/2024
3.0.83 0 12/4/2024
3.0.82 0 12/4/2024
3.0.81 2 12/4/2024
3.0.80 31 12/4/2024
3.0.79 39 12/3/2024
3.0.78 64 12/3/2024
3.0.77 85 12/3/2024
3.0.76 82 12/3/2024
3.0.75 30 12/3/2024
3.0.74 77 12/3/2024
3.0.73 28 12/3/2024
3.0.72 264 12/2/2024
3.0.71 83 12/2/2024
3.0.70 96 12/2/2024
3.0.69 36 12/2/2024
3.0.68 98 12/2/2024
3.0.67 142 12/1/2024
3.0.66 34 12/1/2024
3.0.65 180 12/1/2024
3.0.64 57 12/1/2024
3.0.63 147 11/29/2024
3.0.62 113 11/29/2024
3.0.61 222 11/21/2024
3.0.60 87 11/21/2024
3.0.59 237 11/20/2024
3.0.58 73 11/20/2024
3.0.57 99 11/20/2024
3.0.56 76 11/20/2024
3.0.55 78 11/20/2024
3.0.54 90 11/20/2024
3.0.53 85 11/19/2024
3.0.52 72 11/19/2024
3.0.51 70 11/19/2024
3.0.50 361 11/19/2024
3.0.49 67 11/19/2024
3.0.48 282 11/19/2024
3.0.47 72 11/19/2024
3.0.46 70 11/19/2024
3.0.45 270 11/15/2024
3.0.44 118 11/14/2024
3.0.43 70 11/14/2024
3.0.42 68 11/14/2024
3.0.41 118 11/14/2024
3.0.40 84 11/14/2024
3.0.39 196 11/14/2024
3.0.38 291 11/14/2024
3.0.37 134 11/14/2024
3.0.36 69 11/14/2024
3.0.35 71 11/14/2024
3.0.34 116 11/14/2024
3.0.33 72 11/14/2024
3.0.32 169 11/14/2024
2.1.31 275 11/13/2024
2.1.30 162 11/13/2024
2.1.29 234 11/13/2024
2.1.28 125 11/12/2024
2.1.27 68 11/12/2024
2.1.26 537 11/9/2024
2.1.25 158 11/9/2024
2.1.24 320 11/8/2024
2.1.23 78 11/8/2024
2.1.22 75 11/8/2024
2.1.21 269 11/8/2024
2.1.20 213 11/8/2024
2.1.19 234 11/6/2024
2.1.18 311 11/1/2024
2.1.17 73 11/1/2024
2.1.16 301 11/1/2024
2.1.14 85 10/29/2024
2.1.13 236 10/29/2024
2.1.12 124 10/29/2024
2.1.11 393 10/29/2024
2.1.10 233 10/28/2024
2.1.9 69 10/28/2024
2.1.8 99 10/28/2024
2.1.7 334 10/26/2024
2.1.6 93 10/26/2024
2.1.5 241 10/22/2024
2.1.4 97 10/22/2024
2.1.3 74 10/22/2024
2.1.2 84 10/22/2024
2.1.1 100 10/22/2024