Thoth.Core 3.0.3

<img src="./docs/icon.png" width="48" /> Thoth

A .NET library to easily manage feature flags during runtime, without the need to deploy any new code.

Features

• Runtime feature management, using database to store flags;
• In-memory feature flag caching
• Simple Dashboard to control features state

Install

Package name	Nuget
Thoth.Core
Thoth.SQLServer
Thoth.Dashboard

Usage

Add the Thoth Feature Manager to yout application DI (Dependency Injection) container:

builder.Services.AddThoth(options =>
{
    options.ConnectionString = builder.Configuration.GetConnectionString("SqlContext"); // Your application sql database connection
    options.ShouldReturnFalseWhenNotExists = true; // Defines if the default value to a non-existent should be false or throw
    options.EnableCaching = true; // Whether Thoth should use caching strategies to improve performance. Optional.
    options.CacheExpiration = TimeSpan.FromDays(7); // Defines for how long feature flags are going to be cached in memory. Optional.
    options.CacheSlidingExpiration = TimeSpan.FromDays(1); // Defines for how long the feature flags will be cached without being accessed. Optional.
    options.EnableThothApi = True; // Defines if the Thoth Api should be exposed. This is required true when using Dashboard.
}).UseSqlServer(); // Sets Thoth to use SQLServer as its database storage.

A Dashboard can optionally be injected to the application:

var app = builder.Build();
app.UseThothDashboard(options =>
{
    options.RoutePrefix = "/thoth"; // Defines the route prefix to access the dashboard. Optional.
});

Runtime feature management as simples as:

public class MyService
{
    private readonly IThothFeatureManager _thothFeatureManager;

    public MyService(IThothFeatureManager thothFeatureManager)
    {
        _thothFeatureManager = thothFeatureManager;
    }

    public async Task<bool> MyServiceMethod()
    {
        var isFeatureEnabled = await _thothFeatureManager.IsEnabledAsync("MyFeatureFlagName");
        
        if(isFeatureEnabled)
        {
            // do something
        }
        
    }
}

A Sample project is available to DEMO the library.