CShells.Providers.FluentStorage

FluentStorage integration provider for CShells enabling shell configuration storage in various backends.

Purpose

This package provides a shell settings provider that uses FluentStorage to load and persist shell configurations from various storage backends including local disk, Azure Blob Storage, AWS S3, and more.

When to Use

• Store shell configurations as individual JSON files instead of appsettings.json
• Load shell configurations from cloud storage (Azure Blob, AWS S3)
• Enable dynamic shell configuration updates without application restart
• Separate shell configuration from application configuration
• Multi-environment deployments with centralized configuration storage

Supported Storage Backends

FluentStorage supports numerous storage providers:

• Local disk - Directory-based file storage
• Azure Blob Storage - Azure cloud storage
• AWS S3 - Amazon cloud storage
• In-memory - Temporary storage for testing
• And many more FluentStorage providers

Installation

dotnet add package CShells.Providers.FluentStorage
dotnet add package FluentStorage
# Add specific FluentStorage provider packages as needed
# e.g., FluentStorage.Azure.Blobs, FluentStorage.AWS

Quick Start

Local Disk Storage

Create JSON files in a Shells folder (e.g., Default.json, Admin.json):

Shells/Default.json:

{
  "Name": "Default",
  "Features": ["Core", "Weather"],
  "Configuration": {
    "WebRouting": {
      "Path": ""
    }
  }
}

Shells/Admin.json:

{
  "Name": "Admin",
  "Features": ["Core", "Admin"],
  "Configuration": {
    "WebRouting": {
      "Path": "admin",
      "RoutePrefix": "api/v1"
    }
  }
}

Program.cs:

using FluentStorage;
using CShells.Providers.FluentStorage;

var builder = WebApplication.CreateBuilder(args);

var shellsPath = Path.Combine(builder.Environment.ContentRootPath, "Shells");
var blobStorage = StorageFactory.Blobs.DirectoryFiles(shellsPath);

builder.AddShells(cshells =>
{
    cshells.WithFluentStorageProvider(blobStorage);
});

var app = builder.Build();
app.MapShells();
app.Run();

Azure Blob Storage

using FluentStorage;
using FluentStorage.Azure.Blobs;
using CShells.Providers.FluentStorage;

var builder = WebApplication.CreateBuilder(args);

var connectionString = builder.Configuration.GetConnectionString("AzureStorage");
var blobStorage = StorageFactory.Blobs.AzureBlobStorage(connectionString, "shells");

builder.AddShells(cshells =>
{
    cshells.WithFluentStorageProvider(blobStorage);
});

var app = builder.Build();
app.MapShells();
app.Run();

AWS S3 Storage

using FluentStorage;
using FluentStorage.AWS;
using CShells.Providers.FluentStorage;

var builder = WebApplication.CreateBuilder(args);

var blobStorage = StorageFactory.Blobs.AwsS3(
    accessKeyId: "your-access-key",
    secretAccessKey: "your-secret-key",
    bucketName: "shells",
    region: "us-east-1"
);

builder.AddShells(cshells =>
{
    cshells.WithFluentStorageProvider(blobStorage);
});

var app = builder.Build();
app.MapShells();
app.Run();

File Naming Convention

Shell configuration files should be named with the shell name followed by .json:

• Default.json → Shell with Name: "Default"
• Acme.json → Shell with Name: "Acme"
• Contoso.json → Shell with Name: "Contoso"

Configuration Format

Each JSON file should contain a complete shell configuration:

{
  "Name": "ShellName",
  "Features": ["Feature1", "Feature2"],
  "Configuration": {
    "WebRouting": {
      "Path": "path",
      "Host": "example.com",
      "RoutePrefix": "api/v1"
    },
    "CustomSetting": "value"
  }
}

Benefits

• Separation of concerns - Shell configurations separate from application settings
• Dynamic updates - Update shell configurations without rebuilding or redeploying
• Centralized management - Store configurations in cloud storage accessible across deployments
• Version control friendly - Individual files are easier to track and manage
• Environment-specific - Different storage backends for different environments

Learn More

• Main Documentation
• FluentStorage Documentation
• CShells Package - Core runtime