DotNetCore.FeatureFlags 3.1.0

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

// Install DotNetCore.FeatureFlags as a Cake Tool
#tool nuget:?package=DotNetCore.FeatureFlags&version=3.1.0

DotNetCore.FeatureFlags

Introduction

Quick and easy implementation of FeatureToggles (FeatureFlags) in .NET Framework 4.6.1 or higher, .NET Core 2.x, .NET Core 3.0, ASP.NET Core 2.x, ASP.NET Core 3.0 or Azure projects.

In the samples code you will see a sample to implement FeatureFlags on your .NET Core 3.x applications.

This implementation is quick easy, and you will have to implement the IToggleService only to manage the Toggles.

Release History

Access to the Release History

How-To

In the next image you will see the projet's class diagram. screenshot

You should know that:

  • The class ToggleSettings has the properties of the Toggle (Feature, Description, IsEnabled)
    • Feature is the name or key of the Toggle
    • Description is the description of the Toggle (empty by default)
    • IsEnabled is the value of the Toggle (on/off) where off is the default value

You will have to take two actions on your code only:

  • Implement the IToggleService interface to manage the Toggles (load, get, release and reload the Toggles) from the source where you have them.
  • Use the Toggle class on your app to manage the Toggles and know if a Toggle is enabled or not.

Implement the library is quick and easy as you can see.

Usage

This is a general use of this library.

Implementation of IToggleService

First, you have to implement the IToggleService interface:

public class MyService : IDisposable, IToggleService
{
    private IList<ToggleSettings> _toggleSettings = new List<ToggleSettings>();

    public int Count { get { return _toggleSettings.Count; } }

    public MyService() => ReloadToggles();

    public void Dispose()
    {
        _toggleSettings = null;
    }

    public bool ExistsToggle(string feature) => GetToggleSettingsBy(feature) != null;

    public IList<ToggleSettings> GetAllToggleSettings() => _toggleSettings;

    public ToggleSettings GetToggleSettingsBy(string feature) => _toggleSettings.Where(q => q.Feature == feature).SingleOrDefault();

    public void ReloadToggles()
    {
        var toggleSettings = new List<ToggleSettings>();
        toggleSettings.Add(new ToggleSettings("MyFeature", "My toggle code", false));

        _toggleSettings = toggleSettings;
    }

    public void ReleaseToggles()
    {
        _toggleSettings = new List<ToggleSettings>();
    }
}

Configure the Service

Second, you have to configure the service that we have implemented to be used by our application code:

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();
    AddServices(services);
}

...

private void AddServices(IServiceCollection services)
{
    services.AddSingleton<IToggle, Toggle>()
        .AddSingleton<IToggleService, MyService>()
        .BuildServiceProvider();
}

Use the library on your code

Finally, we will be ready to use the library on our code:

private readonly IToggle _toggle;

public MyClass(IToggle toggle)
{
    _toggle = toggle;
}

public void MyMethod()
{
    var feature = "MyFeature";
    
    if (_toggle.ExistsToggle(feature) && 
        _toggle.GetToggleSettingsBy(feature).IsEnabled)
    {
        MyMethodWithFeatureToggle();
    }
    else
    {
        MyCurrentMethod();
    }
}

private void MyMethodWithFeatureToggle()
{
    // Here the code of the new method
    // testable through Feature Toggles
}

private void MyCurrentMethod()
{
    // Here the actual code 
}

  • Note: to give more flexibility, you could use the service to manage your toggles too, however I recommend you to use the IToggle interface.

Samples (source code)

There are some samples using this NuGet Package.

  • A console application
  • An ASP.NET 3.0 MVC Web App

You will find the samples here

NuGet Package

You can install the Nuget Package of DotNEtCore.FeatureFlags from here

References

FeatureToggle of Martin Fowler

Explore how to progressively expose your features in production for some or all users

FeatureFlags - additional information

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 netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETCoreApp 3.0

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.1.0 1,389 10/29/2019

Added .NET Standard 2.0 compatibility