Boba.Settings is a comprehensive C# library meticulously crafted to streamline the management of application and business settings within projects. Offering a suite of robust functionalities, it empowers developers to efficiently organize and access crucial configurations, thereby enhancing development workflows and ensuring seamless integration of settings across various facets of the application.
Boba.Settings is conveniently available on NuGet. Simply install the provider package corresponding to your database.
Choose your data store option and follow its documentation to install the right package.
- Sql Server: Boba.Settings.EntityFrameworkCore.SqlServer
- In Memeory: Boba.Settings.EntityFrameworkCore.InMemory
Utilize the --version option to specify a preview version for installation if needed.
Harnessing the power of Boba.Settings is straightforward. Follow these steps to get started:
Begin by registering Boba.Settings in your program.cs. Presently, we support Sql server, InMemeory, Alternative data store providers are also available.
builder.Services.AddBobaSettings();Define your settings class, inheriting from ISettings. Here, you can optionally assign default values to be retrieved in the absence of stored data.
public class TestSettings : ISettings
{
public bool Enabled { get; set; } = true;
public int DefaultLangId { get; set; } = default!;
public string DefaultColor { get; set; } = "Red";
}Inject the setting service into your application and access the values effortlessly.
private readonly TestSettings _testSettings;
public YourConstructor(TestSettings testSettings)
{
_testSettings = testSettings;
}
Console.WriteLine(_testSettings.DefaultLangId);Additionally, settings can be loaded manually.
private readonly ISettingService _settingService;
public YourConstructor(ISettingService settingService)
{
_settingService = settingService;
}
var testSettings = await _settingService.LoadSettingAsync<TestSettings>();
Console.WriteLine(testSettings.DefaultLangId);The ISettingService interface offers a plethora of APIs for seamless management of settings. For instance, to insert settings:
private readonly ISettingService _settingService;
public YourConstructor(ISettingService settingService)
{
_settingService = settingService;
}
await _settingService.SaveSettingAsync(new TestSettings { DefaultLangId = 1, Enabled = false });- Sql Server: Boba.Settings.EntityFrameworkCore.SqlServer
- In Memeory: Boba.Settings.EntityFrameworkCore.InMemory
- Sql light
- Azure Cosmos DB SQL API
- PostgreSQL
- MySQL, MariaDB
- Oracle DB 11.2 onwards
- And more… Contributions to expand the list of supported data stores are highly encouraged.
Contributions are always welcome!
See contributing.md for ways to get started.
Please adhere to this project's code of conduct.
- Comprehensive unit testing capabilities.
- Query caching mechanisms for enhanced performance.
- Intuitive User Interface for simplified management.
- Flexible injection options, including Windsor, Unity, Autofac, etc.
- Support for various DB stores such as MangoDb, Sql Light, CozmoDB.
- Association of settings with entities like UserId, StoreId, etc.
- Setting version
The main branch is now on .NET 8.0. Previous versions are not available at this time.
This project is licensed under the MIT license.
If you encounter any issues or have questions, please feel free to raise a new issue.