SparkyTools.DependencyProvider 1.2.1

dotnet add package SparkyTools.DependencyProvider --version 1.2.1
NuGet\Install-Package SparkyTools.DependencyProvider -Version 1.2.1
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="SparkyTools.DependencyProvider" Version="1.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SparkyTools.DependencyProvider --version 1.2.1
#r "nuget: SparkyTools.DependencyProvider, 1.2.1"
#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 SparkyTools.DependencyProvider as a Cake Addin
#addin nuget:?package=SparkyTools.DependencyProvider&version=1.2.1

// Install SparkyTools.DependencyProvider as a Cake Tool
#tool nuget:?package=SparkyTools.DependencyProvider&version=1.2.1

SparkyTools.DependencyProvider

see also:


Ludicrously lightweight dependency wrapper/provider to improve testability of classes that use dependencies that aren't easily mockable (e.g. System.DateTime):

using SparkyTools.DependencyProvider;
    public class Foo
    {
        private readonly IBar _bar;
        private readonly DependencyProvider<DateTime> _currentTimeProvider;
       
        public Foo(IBar bar, DependencyProvider<DateTime> currentTimeProvider) 
        {
            _bar = bar;
            _getDate = currentTimeProvider;
        }
       
        public void DoSomethingWithBazAndDate()
        {
            _bar.DoSomethingWithDate(_currentTimeProvider.GetValue());
        }
    }

The DependencyProvider.GetValue() function provides a value to the class.

A DependencyProvider instance can be created:

  • via a "callback function" constructor parameter:
    var realTimeProvider = new DependencyProvider<DateTime>(() => DateTime.Now);
    var fakeTimeProvider = new DependencyProvider<DateTime>(() => new DateTime(2018, 7, 4, 15, 32, 00));
    
  • via the static Create(callbackFunction) method:
    var realTimeProvider = DependencyProvider.Create(() => DateTime.Now);
    var fakeTimeProvider = DependencyProvider.Create(() => new DateTime(2018, 7, 4, 15, 32, 00));
    
  • via a static value constructor parameter:
    var realTimeProvider = new DependencyProvider<DateTime>(DateTime.Now);
    var fakeTimeProvider = new DependencyProvider<DateTime>(new DateTime(2018, 7, 4, 15, 32, 00));
    
  • via the static Create(staticValue) method:
    var realTimeProvider = DependencyProvider.Create(DateTime.Now);
    var fakeTimeProvider = DependencyProvider.Create(new DateTime(2018, 7, 4, 15, 32, 00));
    
  • via implicit conversion:
    DependencyProvider<DateTime> realTimeProvider = DateTime.Now(); 
    DependencyProvider<DateTime> fakeTimeProvider = new DateTime(2018, 7, 4, 15, 32, 00);
    

The implicit conversion option makes for very nice, terse syntax when declared inline for the constructor of a class using DependencyProvider, e.g.:

    public class Foo
    {
        public Foo(IBar bar, DependencyProvider<DateTime> currentTimeProvider) { }
    }

    ...
    // implicit conversion:
    var fooWithRealTime = new Foo(bar, DateTime.Now());
    var fooWithFakeTime = new Foo(bar, new DateTime(2018, 7, 4, 15, 32, 00));

    // other syntaxes:
    var fooWithRealTime2 = new Foo(bar, DependencyProvider.Create(DateTime.Now));
    var foowithFakeTime2 = new Foo(bar, new DependencyProvider<DateTime>(new DateTime(2018, 7, 4, 15, 32, 00)));

The DependencyProvider.Static() method tells the provider to cache the first value returned by GetValue() and return that same value for all subsequent calls:

    var startTimeProvider = DependencyProvider.Create(() => DateTime.Now).Static();

DependencyProviders created via the static value constructor and Create(staticValue) methods get their static values when constructed. Providers that aren't constructed statically but are "dotted" with .Static() are "lazy". They don't get retrieve their value until the first GetValue() call.

Product 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 was computed.  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. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.0 is compatible.  netstandard1.1 was computed.  netstandard1.2 was computed.  netstandard1.3 was computed.  netstandard1.4 was computed.  netstandard1.5 was computed.  netstandard1.6 was computed.  netstandard2.0 was computed.  netstandard2.1 was computed. 
.NET Framework net45 was computed.  net451 was computed.  net452 was computed.  net46 was computed.  net461 is compatible.  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 tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Universal Windows Platform uap was computed.  uap10.0 was computed. 
Windows Phone wp8 was computed.  wp81 was computed.  wpa81 was computed. 
Windows Store netcore was computed.  netcore45 was computed.  netcore451 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 (3)

Showing the top 3 NuGet packages that depend on SparkyTools.DependencyProvider:

Package Downloads
SparkyTools.XmlConfig

Makes it easy to load a strongly-typed object (or IList of objects) from a custom web.config or app.config file section without having to write a custom IConfigurationSectionHandler implementation.

SparkyTestHelpers.AppSettings

Helpers for testing code that uses ConfigurationManager.AppSettings

SparkyTools.XmlConfig.Fx

Makes it easy to load a strongly-typed object (or IList of objects) from a custom web.config or app.config file section without having to write a custom IConfigurationSectionHandler implementation.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.1 1,653 7/27/2019
1.2.0 553 3/23/2019
1.1.0 1,714 3/9/2018
1.0.0 1,593 2/17/2018

v1.2 Added IDependencyProvider interface