Autofac.Extras.Quartz 10.0.0

dotnet add package Autofac.Extras.Quartz --version 10.0.0
                    
NuGet\Install-Package Autofac.Extras.Quartz -Version 10.0.0
                    
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="Autofac.Extras.Quartz" Version="10.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Autofac.Extras.Quartz" Version="10.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Autofac.Extras.Quartz" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Autofac.Extras.Quartz --version 10.0.0
                    
#r "nuget: Autofac.Extras.Quartz, 10.0.0"
                    
#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.
#:package Autofac.Extras.Quartz@10.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Autofac.Extras.Quartz&version=10.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Autofac.Extras.Quartz&version=10.0.0
                    
Install as a Cake Tool

Autofac.Extras.Quartz

Autofac integration package for Quartz.Net.

Autofac.Extras.Quartz creates nested litefime scope for each Quartz Job. Nested scope is disposed after job execution has been completed.

This allows to have single instance per job execution as well as deterministic disposal of resources.

Install package via Nuget: install-package Autofac.Extras.Quartz

Build status

Stable Pre-release
Build Master branch Development branch
NuGet NuGet NuGet
CodeCov codecov codecov

Usage example

Autofac configuration for Quartz includes two steps:

  1. Scheduler registration
  2. Job registration

Scheduler registration

QuartzAutofacFactoryModule registers custom ISchedulerFactory and default instance of IScheduler in Autofac container. Both factory and schedulere are registered as singletones. Note: Is is important to resolve IScheduler from container, rather than using default one to get jobs resolved by Autofac.

Optionally custom Quartz configuration can be passed using ConfigurationProvider property. Provider is callback which returns settings using NameValueCollection.

Job scope configuration

Starting with version 7 QuartzAutofacFactoryModule provides a way to customize lifetime scope configuration for job. This can be done via JobScopeConfigurator parameter.

cb.Register(_ => new ScopedDependency("global"))
    .AsImplementedInterfaces()
    .SingleInstance();

cb.RegisterModule(new QuartzAutofacFactoryModule {
    JobScopeConfigurator = (builder, jobScopeTag) => {
        // override dependency for job scope
        builder.Register(_ => new ScopedDependency("job-local "+ DateTime.UtcNow.ToLongTimeString()))
            .AsImplementedInterfaces()
            .InstancePerMatchingLifetimeScope(jobScopeTag);

    }
});

See src/Samples/Shared/Bootstrap.cs for details.

Job registration

QuartzAutofacJobsModule scans given assemblies and registers all non-abstract implementors of IJob interface as transient instances.

internal static ContainerBuilder ConfigureContainer(ContainerBuilder cb)
{
	// 1) Register IScheduler
	cb.RegisterModule(new QuartzAutofacFactoryModule()); 
	// 2) Register jobs
	cb.RegisterModule(new QuartzAutofacJobsModule(typeof (CleanupExpiredAnnouncemetsJob).Assembly));
}

Starting Quartz

Make sure to start the scheduler after it was resolved from Autofac. E.g.

var scheduler = _container.Resolve<IScheduler>();
scheduler.Start();

Sample projects

TopShelf-based sample was removed since Topshelf.Quartz is not compatible with Quartz 3 as af now.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 is compatible.  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 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.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 is compatible. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (13)

Showing the top 5 NuGet packages that depend on Autofac.Extras.Quartz:

Package Downloads
Lauener.Core.Triggers

A easy to use Quartz implementation

HwApp.Quartz

HwApp Quartz & Quartzmin

SyWaterStandardLibrary

舜禹框架Core 3.0

Cogito.Quartz.Autofac

Provides utilites and extensions for Quartz and Autofac.

Inaction.Web

.net core Web快速开发框架

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Autofac.Extras.Quartz:

Repository Stars
Reaparr/Reaparr
Plex downloader that brings content from any server to yours!
Version Downloads Last Updated
10.0.0 475,632 3/7/2024
10.0.0-alpha0007 225 3/5/2024
10.0.0-alpha0006 234 3/4/2024
9.0.0 247,617 3/27/2023
8.2.0 77,076 1/30/2023
8.2.0-alpha0001 337 1/30/2023
8.1.0 2,848 1/24/2023
8.1.0-alpha0003 363 12/22/2022
8.1.0-alpha0002 339 12/22/2022
8.0.0 158,373 6/3/2022
7.4.0-alpha0007 427 6/2/2022
7.4.0-alpha0005 11,155 5/17/2022
7.4.0-alpha0002 373 5/8/2022
7.3.0 200,419 10/28/2021
7.3.0-alpha0009 468 10/28/2021
7.2.0 52,192 8/2/2021
7.2.0-alpha0006 471 8/1/2021
7.1.0 70,243 4/25/2021
7.1.0-alpha0011 485 8/1/2021
7.1.0-alpha0010 510 8/1/2021
7.1.0-alpha0009 535 8/1/2021
7.1.0-alpha0008 493 6/20/2021
7.1.0-alpha0006 482 4/30/2021
7.1.0-alpha0004 491 4/24/2021
7.1.0-alpha0003 534 4/24/2021
7.1.0-alpha0002 484 4/19/2021
7.1.0-alpha0001 430 4/19/2021
7.0.0 230,938 2/16/2021
7.0.0-beta0001 494 2/14/2021
7.0.0-alpha0024 515 2/14/2021
7.0.0-alpha0023 518 2/9/2021
6.3.0-alpha0001 486 2/9/2021
6.2.0 16,278 1/29/2021
6.2.0-beta0001 499 1/29/2021
6.2.0-alpha0008 522 1/28/2021
6.2.0-alpha0001 628 1/10/2021
6.1.0 18,371 1/10/2021
6.1.0-beta0001 549 1/4/2021
6.0.1 50,374 10/21/2020
6.0.1-beta0001 661 10/21/2020
6.0.0 79,424 10/9/2020
6.0.0-beta0001 617 10/9/2020
6.0.0-alpha0041 631 10/7/2020
6.0.0-alpha0039 672 10/7/2020
5.4.0 48,522 10/7/2020
5.4.0-beta0001 620 10/4/2020
5.4.0-alpha0007 621 10/4/2020
5.4.0-alpha0001 848 8/6/2020
5.3.0 43,949 8/6/2020
5.3.0-beta0001 652 8/6/2020
5.3.0-alpha0009 662 8/6/2020
5.3.0-alpha0008 702 7/27/2020
5.3.0-alpha0007 693 7/8/2020
5.3.0-alpha0001 1,271 5/19/2020
5.2.0 118,803 5/19/2020
5.2.0-beta0001 697 5/19/2020
5.2.0-alpha0023 692 5/19/2020
5.2.0-alpha0021 960 2/17/2020
5.1.0 172,187 2/17/2020
5.1.0-alpha0015 704 2/17/2020
5.1.0-alpha0014 712 2/8/2020
5.1.0-alpha0005 757 1/30/2020
5.0.0 30,077 1/30/2020
5.0.0-beta0001 776 1/30/2020
5.0.0-alpha0064 677 1/30/2020
4.7.0-alpha0013 3,449 1/29/2020
4.7.0-alpha0009 734 1/27/2020
4.7.0-alpha0007 2,374 11/18/2019
4.7.0-alpha0006 726 11/17/2019
4.7.0-alpha0005 760 11/8/2019
4.7.0-alpha0004 1,382 9/2/2019
4.6.0 256,851 9/2/2019
4.6.0-beta0001 775 9/1/2019
4.6.0-alpha0036 761 9/1/2019
4.6.0-alpha0034 759 9/1/2019
4.6.0-alpha0033 737 9/1/2019
4.6.0-alpha0028 798 7/13/2019
4.6.0-alpha0026 779 7/13/2019
4.6.0-alpha0024 748 7/6/2019
4.6.0-alpha0022 739 7/6/2019
4.6.0-alpha0018 765 7/6/2019
4.6.0-alpha0008 917 5/8/2019
4.6.0-alpha0005 766 5/8/2019
4.6.0-alpha0003 804 5/8/2019
4.6.0-alpha0001 945 3/10/2019
4.5.1 182,139 5/8/2019
4.5.1-beta0001 801 5/8/2019
4.5.0 111,819 3/9/2019
4.5.0-beta0001 800 3/9/2019
4.5.0-alpha0008 782 3/9/2019
4.5.0-alpha0007 827 3/8/2019
4.5.0-alpha0005 830 2/25/2019
4.5.0-alpha0003 1,083 2/11/2019
4.5.0-alpha0002 867 1/28/2019
4.5.0-alpha0001 927 1/27/2019
4.4.0 115,694 1/27/2019
4.4.0-beta0001 929 1/27/2019
4.4.0-alpha0014 1,324 9/29/2018
4.4.0-alpha0013 1,019 9/29/2018
4.4.0-alpha0012 1,009 9/29/2018
4.4.0-alpha0002 1,074 9/23/2018
4.4.0-alpha0001 991 9/19/2018
4.3.0 161,739 9/29/2018
4.3.0-beta0001 1,048 9/26/2018
4.3.0-alpha0008 1,946 7/11/2018
4.3.0-alpha0007 1,508 7/7/2018
4.3.0-alpha0006 1,502 7/7/2018
4.3.0-alpha0005 1,529 7/1/2018
4.2.0 46,152 7/1/2018
4.2.0-beta0001 1,469 6/30/2018
4.2.0-alpha0004 1,475 7/1/2018
4.2.0-alpha0003 1,927 5/13/2018
4.2.0-alpha0002 1,541 5/13/2018
4.2.0-alpha0001 1,564 5/13/2018
4.1.2 1,968 6/30/2018
4.1.1 64,305 5/13/2018
4.1.0-beta0004 1,547 5/13/2018
4.1.0-beta0001 1,571 5/13/2018
4.1.0-alpha0016 1,851 4/14/2018
4.0.0 73,309 1/14/2018
4.0.0-beta0007 1,650 1/14/2018
4.0.0-beta0006 1,567 1/13/2018
4.0.0-beta0001 1,536 1/13/2018
3.5.0 122,524 4/14/2018
3.5.0-unstable0012 1,653 1/5/2018
3.5.0-unstable0010 1,777 8/15/2017
3.5.0-unstable0004 1,339 8/1/2017
3.5.0-unstable0003 1,367 7/25/2017
3.5.0-unstable0002 1,398 6/21/2017
3.5.0-unstable0001 1,444 6/15/2017
3.5.0-beta0001 1,709 4/14/2018
3.4.0 133,120 5/5/2017
3.4.0-unstable0009 1,415 4/5/2017
3.4.0-unstable0008 1,386 4/5/2017
3.4.0-unstable0007 1,405 4/5/2017
3.4.0-unstable0006 1,350 4/5/2017
3.4.0-unstable0004 1,487 2/15/2017
3.4.0-unstable0001 1,471 12/4/2016
3.4.0-ci0000 1,354 4/5/2017
3.3.0 77,723 11/1/2016
3.3.0-unstable0001 1,477 11/1/2016
3.3.0-unstable0000 1,359 10/10/2016
3.2.0 9,111 10/10/2016
3.2.0-beta0001 1,376 10/10/2016
3.1.0 58,561 8/25/2016
3.1.0-unstable0022 1,361 10/9/2016
3.1.0-unstable0021 1,408 10/9/2016
3.0.0-unstable0020 1,482 7/17/2016
3.0.0-unstable0017 1,439 8/24/2016
3.0.0-unstable0013 1,416 7/17/2016
3.0.0-unstable0012 1,422 7/17/2016
3.0.0-unstable0011 1,409 7/17/2016
3.0.0-beta-1 1,500 7/4/2016
3.0.0-alpha0014 1,354 7/20/2016
2.2.0-unstable0012 1,459 7/19/2016
2.1.1 19,915 7/16/2016
2.1.0 39,674 4/8/2016
2.0.0.1 2,179 4/6/2016
1.7.0 45,714 10/29/2015
1.6.0 3,827 10/25/2015
1.5.1 21,658 7/14/2015
1.5.0 1,860 7/14/2015
1.4.0 5,451 6/12/2015
1.3.0 17,734 2/1/2015
1.2.0 4,439 1/26/2015
1.1.1 6,951 11/15/2014
1.1.0 11,023 7/13/2014
1.0.0 3,281 7/2/2014
0.11.0 2,454 5/18/2014
0.10.0 2,342 4/9/2014
0.9.0 6,670 4/7/2014