AInq.Background
5.7.1
dotnet add package AInq.Background --version 5.7.1
NuGet\Install-Package AInq.Background -Version 5.7.1
<PackageReference Include="AInq.Background" Version="5.7.1" />
paket add AInq.Background --version 5.7.1
#r "nuget: AInq.Background, 5.7.1"
// Install AInq.Background as a Cake Addin #addin nuget:?package=AInq.Background&version=5.7.1 // Install AInq.Background as a Cake Tool #tool nuget:?package=AInq.Background&version=5.7.1
AInq.Background
What is it?
Background work utilities for .NET Core apps based on Hosted services. Originally designed for accessing API with strict request-per-second limit.
- Background work queue with configurable parallelism and optional prioritizing
- Shared resource access queue with different resource reuse strategies and optional prioritizing
- Background data processing conveyor with different conveyor machine reuse strategies and optional prioritizing
- Work scheduler with Cron support
- Startup work utility
New in 4.1
- BREAKING CHANGES
- Startup work utility moved to separate package AInq.Background.Startup
- Minor bug fix and internal optimization
New in 4.0
- BREAKING CHANGES
- Background work Scheduler interfaces moved to separate package AInq.Background.Scheduler.Abstraction
- Background work Scheduler now uses
Try
andMaybe
from AInq.Optional to pass errors logically correct to Observable
- Background work Scheduler now uses System.Reactive instead of custom buggy
IObservable<T>
implementation
New in 3.0
- GENERAL BUGFIX
- New features
- Service interaction extensions
- Batch processing extension
- Repeated work in
IWorkScheduler
- Work results in
IWorkScheduler
- Refactoring
- Simplify basic interfaces: non-basic methods moved to extensions
- Cleanup Helpers and Extensions classes struct
- BREAKING CHANGES
- Removed some unused methods from
WorkFactory
andAccessFactory
- Some extension methods moved form
AInq.Background.Helpers
namespace toAInq.Background.Extensions
andAInq.Background.Interaction
IActivatable
IStartStopppable
- Removed some unused methods from
Packages description
AInq.Background.Abstraction
Basic interfaces and helpers library.
- Basic interfaces and factory classes:
- Work interfaces:
IWork
,IWork<TResult>
,IAsyncWork
,IAsyncWork<TResult>
WorkFactory
for creating simple work instances from delegates- Resource access interfaces:
IAccess<TResource>
,IAccess<TResource, TResult>
,IAsyncAccess<TResource>
,IAsyncAccess<TResource, TResult>
AccessFactory
for creating simple access instances from delegatesIConveyorMachine<TData, TResult>
for conveyor data processing machinesIActivatable
andIThrottling
for shared resources and conveyor machines with particular usage strategies
- Work interfaces:
- Service interfaces
IWorkQueue
andIPriorityWorkQueue
for background task queueIAccessQueue<TResource>
andIPriorityAccessQueue<TResource>
for shared resource access queueIConveyor<TData, TResult>
andIPriorityConveyor<TData, TResult>
for background data processing conveyor
- Helpers and extensions including methods to use services together (e.g. enqueue
IAccess<TResource>
toIWorkQueue
) if needed
AInq.Background
Queues and conveyor implementations.
- Background work queue
- Optional support for configurable parallelism
- Optional support for prioritizing
- Use
WorkQueueInjection
to register service or create for internal usage
- Shared resource access queue
- Support single or many resource instances with different lifetime
- Optional support for prioritizing
- Use
AccessQueueInjection
to register service or create for internal usage
- Background data processing conveyor
- Support single or many conveyor machines with different lifetime
- Optional support for prioritizing
- Use
ConveyorInjection
to register service or create for internal usage
You can extend functionality by implementing custom ITaskWrapper
, ITaskManager
or ITaskProcessor
and combine with existing ones to create more service variants.
AInq.Background.Scheduler.Abstraction
Work scheduler interfaces and helpers library.
- Service interfaces
IWorkScheduler
for background work scheduler
- Helpers and extensions including methods to use services together (e.g. schedule
IAccess<TResource>
toIWorkScheduler
) if needed
AInq.Background.Scheduler
Work scheduler implementation.
- Support delayed, time-scheduled, and cron-scheduled work
- Use
WorkSchedulerInjection
to register service or create for internal usage
You can extend functionality by implementing custom IScheduledTaskWrapper
or IWorkSchedulerManager
and combine with existing ones to create more service variants.
NOTE: Cronos is used for parsing Cron expressions - follow documentation for supported options. Format with seconds is supported.
AInq.Background.Enumerable
NEW Batch processing extensions for IWorkQueue
, IAccessQueue<TResource>
and IConveyor<TData, TResult>
AInq.Background.Startup
NEW Startup work utility for running some work before host start
Support interaction with background work queue
Documentation
As for now documentation is provided in this document and by XML documentation inside packages.
Contribution
These packages are in active production use, all fixes and improvements will be published after some internal testing.
If you find a bug, have a question or something else - you are friendly welcome to open an issue.
License
Copyright © 2020 Anton Andryushchenko. AInq.Background is licensed under Apache License 2.0
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- AInq.Background.Abstraction (>= 5.7.1)
- Microsoft.Bcl.AsyncInterfaces (>= 9.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- Nito.AsyncEx.Coordination (>= 5.1.2)
-
net8.0
- AInq.Background.Abstraction (>= 5.7.1)
- DotNext.Threading (>= 5.16.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- System.Threading.Channels (>= 9.0.0)
-
net9.0
- AInq.Background.Abstraction (>= 5.7.1)
- DotNext.Threading (>= 5.16.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- System.Threading.Channels (>= 9.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on AInq.Background:
Package | Downloads |
---|---|
AInq.Bitrix24.Background
Bitrix24 client integration with AInq.Background |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
5.7.1 | 150 | 12/9/2024 |
5.7.0 | 266 | 11/13/2024 |
5.6.0 | 1,286 | 11/17/2023 |
5.5.3 | 589 | 6/20/2023 |
5.5.2 | 325 | 5/23/2023 |
5.5.1 | 1,003 | 12/3/2022 |
5.5.0 | 629 | 11/14/2022 |
5.5.0-preview.3 | 171 | 10/24/2022 |
5.5.0-preview.2 | 176 | 10/13/2022 |
5.5.0-preview.1 | 135 | 10/2/2022 |
5.4.1 | 902 | 8/9/2022 |
5.4.0 | 1,204 | 5/11/2022 |
5.3.1 | 891 | 3/28/2022 |
5.3.1-preview.2 | 145 | 3/28/2022 |
5.3.1-preview.1 | 135 | 3/28/2022 |
5.3.0 | 861 | 3/23/2022 |
5.3.0-rc.3 | 141 | 3/20/2022 |
5.3.0-rc.2 | 134 | 3/17/2022 |
5.3.0-rc.1 | 138 | 3/16/2022 |
5.2.3 | 867 | 3/9/2022 |
5.2.2 | 632 | 12/27/2021 |
5.2.1 | 519 | 12/17/2021 |
5.2.0 | 546 | 12/13/2021 |
5.1.0 | 537 | 12/3/2021 |
5.0.0 | 698 | 11/8/2021 |
5.0.0-rc.2 | 190 | 10/12/2021 |
5.0.0-rc.1 | 166 | 10/7/2021 |
4.2.0-preview.4 | 162 | 10/6/2021 |
4.2.0-preview.3 | 207 | 9/28/2021 |
4.2.0-preview.2 | 173 | 9/15/2021 |
4.2.0-preview | 166 | 8/23/2021 |
4.1.2 | 553 | 5/14/2021 |
4.1.1.1 | 477 | 5/14/2021 |
4.1.1 | 436 | 5/10/2021 |
4.1.0 | 477 | 4/25/2021 |
4.0.1 | 546 | 3/15/2021 |
4.0.0 | 484 | 3/14/2021 |
3.0.1 | 536 | 2/28/2021 |
3.0.0 | 597 | 12/21/2020 |
2.3.2 | 741 | 7/12/2020 |
2.3.1 | 619 | 7/3/2020 |
2.3.0 | 628 | 7/2/2020 |
2.2.0 | 704 | 6/20/2020 |
2.1.0 | 627 | 6/15/2020 |
2.0.1 | 663 | 6/11/2020 |
2.0.0 | 648 | 6/9/2020 |
[UPD] Dependencies