Shaunebu.Azure.AppConfiguration 1.0.1

Shaunebu.Azure.AppConfiguration 🌐✨

A flexible library for interacting with Azure App Configuration. Supports CRUD operations, key searches, multiple environments, and file serialization in JSON/XML.

🚀 Installation

Add the library to your project via NuGet:

dotnet add package Shaunebu.Azure.AppConfiguration

Reference: Azure App Configuration Documentation

⚡ Initialization

Initialize the service with your environment configurations (ConfigurationDto) and optionally set a default environment:

using Shaunebu.Azure.AppConfiguration.Models;
using Shaunebu.Azure.AppConfiguration.Services;

var configurations = new List<ConfigurationDto>()
{
    new ConfigurationDto
    {
        Environment = "DEV",
        AzureAppConfigConnectionString = "Endpoint=DEV_URL;Id=...;Secret=...",
        JsonFileName = "Config-DEV.json",
        XmlFileName = "Config-DEV.xml",
        AllJsonFileName = "Config-All.json",
        AllXmlFileName = "Config-All.xml"
    },
    new ConfigurationDto
    {
        Environment = "PROD",
        AzureAppConfigConnectionString = "Endpoint=PROD_URL;Id=...;Secret=...",
        JsonFileName = "Config-PROD.json",
        XmlFileName = "Config-PROD.xml",
        AllJsonFileName = "Config-All.json",
        AllXmlFileName = "Config-All.xml"
    }
};

// Initialize service
AppConfigurationService.Instance.Initialize(configurations, defaultEnvironment: "DEV");

🔑 Main Properties

🛠 CRUD Operations

📥 Get Configurations

var devConfigs = AppConfigurationService.Instance.GetAllConfigurationByEnvironment();
var allConfigs = AppConfigurationService.Instance.GetAllConfigurations();

🔍 Search Keys

var featureToggle = AppConfigurationService.Instance.SearchKeyOnAllEnvironments("FeatureToggle");

➕ Add Configurations

// Single key in CurrentEnvironment
AppConfigurationService.Instance.AddConfiguration("FeatureXEnabled", "true", "Features");

// Single key in PROD
AppConfigurationService.Instance.AddConfiguration("FeatureXEnabled", "true", "Features", environment: "PROD");

// Multiple keys
var keyValues = new Dictionary<string, object>
{
    { "Key1", "Value1" },
    { "Key2", "Value2" }
};
AppConfigurationService.Instance.AddConfigurations("MyLabel", keyValues, environment: "DEV");

✏️ Update Configurations

AppConfigurationService.Instance.UpdateConfiguration("FeatureXEnabled", "false", "Features");
AppConfigurationService.Instance.UpdateConfigurations("MyLabel", keyValues, environment: "PROD");

🗑 Delete Configurations

// Single key
AppConfigurationService.Instance.DeleteConfiguration("FeatureXEnabled", "Features");

// Multiple keys
AppConfigurationService.Instance.DeleteConfigurations("MyLabel", keyValues);

// Delete a section
AppConfigurationService.Instance.DeleteEntireConfigurationSection("Features", "FeatureX", environment: "PROD");

💾 Serialization & File Saving

Both GetAllConfigurationByEnvironment and GetAllConfigurations support JSON and XML output, optionally saving to disk:

var serialized = AppConfigurationService.Instance.GetAllConfigurationByEnvironment(
    saveFile: true, 
    label: "MyLabel", 
    serialization: SerializationTypes.Json
);

File paths are configured per ConfigurationDto.

⚖️ Feature Comparison: Shaunebu.Azure.AppConfiguration vs Azure SDK

Tip: Shaunebu.Azure.AppConfiguration is designed for multi-environment enterprise scenarios and simplifies working with Azure App Configuration without writing repetitive boilerplate code.

📌 Example Usage

// Initialize
AppConfigurationService.Instance.Initialize(configurations, "DEV");

// Get all settings for default environment
var devConfigs = AppConfigurationService.Instance.GetAllConfigurationByEnvironment();

// Search key across all environments
var keyResults = AppConfigurationService.Instance.SearchKeyOnAllEnvironments("FeatureToggle");

// Add a new key in PROD
AppConfigurationService.Instance.AddConfiguration("FeatureXEnabled", "true", "Features", "PROD");

// Update key in DEV
AppConfigurationService.Instance.UpdateConfiguration("FeatureXEnabled", "false", "Features");

// Delete key in CurrentEnvironment
AppConfigurationService.Instance.DeleteConfiguration("FeatureXEnabled", "Features");

🚀 Platform Support

Your library is compatible with multiple platforms thanks to .NET 6+ and the Azure.Data.AppConfiguration SDK:

✅ Advantages

• Fully decoupled from enums like EnvironmentTypes

• Manage multiple environments dynamically

• Full CRUD support, including key searches and section deletion

• Supports serialization to JSON/XML and saving to disk

• Designed for multi-environment enterprise scenarios

References:

• Azure App Configuration Official Docs

• Azure App Configuration SDK for .NET