Innovayse.StorageManager 2.0.8

StorageManager

A comprehensive .NET storage management solution with support for multiple storage providers, encryption, compression, and caching. Everything you need in one complete package.

🚀 Quick Start

Installation

Install the complete StorageManager package:

dotnet add package Innovayse.StorageManager

Basic Usage

Console Application

using StorageManager.Core.Interfaces;
using StorageManager.Services;
using StorageManager.Providers.Local;

// Configure local storage
var options = new LocalStorageDriverOptions
{
    RootPath = @"C:\MyStorage",
    IsReadOnly = false
};

// Create storage manager
var storageManager = new DefaultStorageManager();
storageManager.RegisterDriver("local", new LocalStorageDriver(options));
await storageManager.SwitchDriverAsync("local");

// Use storage
await storageManager.UploadAsync("test.txt", "Hello World!"u8.ToArray());
var content = await storageManager.GetAsync("test.txt");
var files = await storageManager.ListAsync("/");

ASP.NET Core Application

using StorageManager.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Add StorageManager with all components
builder.Services.AddStorageManagerMinimal();

// Configure local storage
builder.Services.Configure<LocalStorageDriverOptions>(options =>
{
    options.RootPath = @"C:\Storage";
    options.IsReadOnly = false;
});

var app = builder.Build();

// Use in endpoints
app.MapPost("/upload", async (IFormFile file, IStorageManager storageManager) =>
{
    using var stream = file.OpenReadStream();
    var result = await storageManager.PutAsync(file.FileName, stream);
    return Results.Ok(new { Path = result.Path, Size = result.Size });
});

app.MapGet("/files", async (IStorageManager storageManager) =>
{
    var files = await storageManager.ListAsync("/");
    return Results.Ok(files);
});

app.Run();

📦 What's Included

Innovayse.StorageManager contains all components in one package:

🌟 Key Features

📁 Storage Providers

• Local File System - Fast local storage
• AWS S3 - Amazon Simple Storage Service
• Azure Blob Storage - Microsoft Azure cloud storage
• Google Cloud Storage - Google Cloud Platform storage
• SFTP - Secure File Transfer Protocol
• Database Storage - SQL Server, PostgreSQL, MySQL
• Redis - In-memory data structure store
• Memory - In-memory storage for testing

🔒 Security

• AES-256 Encryption - Industry-standard encryption
• Configurable Keys - Custom encryption keys
• Secure Dependencies - No known vulnerabilities

⚡ Performance

• GZip Compression - Reduce storage space
• Intelligent Caching - Configurable caching strategies
• Async/Await Support - Non-blocking operations
• Streaming - Memory-efficient large file handling
• Batch Operations - Process multiple files efficiently

📊 Monitoring

• Health Checks - Built-in storage health monitoring
• Prometheus Metrics - Comprehensive metrics collection
• Logging - Structured logging with Microsoft.Extensions.Logging
• Performance Tracking - Operation timing and statistics

🔧 Integration

• ASP.NET Core Ready - Built-in dependency injection
• Configuration Support - appsettings.json integration
• Validation - Input validation and error handling
• Extensible - Easy to add custom providers

📚 Documentation

Getting Started

• Installation Guide - Detailed setup instructions
• Configuration - Provider configuration options
• Examples - Console and Web API examples

API Reference

• Core API - Complete API documentation
• Providers - Storage provider details
• Extensions - ASP.NET Core integration

Advanced Topics

• Architecture - System design and patterns
• Security - Security features and best practices
• Performance - Optimization guidelines
• Health Checks - Monitoring setup

Development

• Contributing - Development guidelines
• Docker - Containerization setup
• Testing - Testing strategies

🛠️ Advanced Usage

Encryption Example

// Store encrypted content
await storageManager.PutEncryptedAsync(
    "sensitive-data.txt", 
    contentStream, 
    "my-secret-key"
);

// Retrieve and decrypt
var decryptedStream = await storageManager.GetDecryptedAsync(
    "sensitive-data.txt", 
    "my-secret-key"
);

Compression Example

// Store compressed content
await storageManager.PutCompressedAsync(
    "large-file.json", 
    contentStream, 
    compressionLevel: 6
);

// Retrieve and decompress
var decompressedStream = await storageManager.GetDecompressedAsync(
    "large-file.json"
);

Multiple Providers

// Register multiple providers
storageManager.RegisterDriver("local", new LocalStorageDriver(localOptions));
storageManager.RegisterDriver("s3", new S3StorageDriver(s3Options));
storageManager.RegisterDriver("azure", new AzureBlobStorageDriver(azureOptions));

// Switch between providers
await storageManager.SwitchDriverAsync("s3");
await storageManager.UploadAsync("file.txt", content); // Saves to S3

await storageManager.SwitchDriverAsync("azure");
await storageManager.UploadAsync("file.txt", content); // Saves to Azure

Health Checks

// Check storage health
var healthStatus = await storageManager.HealthCheckAsync();
foreach (var (driver, isHealthy) in healthStatus)
{
    Console.WriteLine($"{driver}: {(isHealthy ? "Healthy" : "Unhealthy")}");
}

// Get detailed statistics
var stats = await storageManager.GetStatisticsAsync();
Console.WriteLine($"Total files: {stats.TotalFiles}");
Console.WriteLine($"Total size: {stats.TotalSize} bytes");

🔧 Configuration

appsettings.json

{
  "StorageManager": {
    "DefaultDriver": "local",
    "EnableCaching": true,
    "CacheExpiration": "00:30:00",
    "Drivers": {
      "local": {
        "Type": "Local",
        "RootPath": "C:\\Storage",
        "IsReadOnly": false
      },
      "s3": {
        "Type": "S3",
        "AccessKey": "your-access-key",
        "SecretKey": "your-secret-key",
        "BucketName": "your-bucket",
        "Region": "us-west-2"
      },
      "azure": {
        "Type": "AzureBlob",
        "ConnectionString": "your-connection-string",
        "ContainerName": "your-container"
      }
    }
  }
}

Startup Configuration

// Configure from appsettings.json
builder.Services.Configure<StorageManagerConfiguration>(
    builder.Configuration.GetSection("StorageManager")
);

// Add StorageManager
builder.Services.AddStorageManagerComplete();

// Or minimal setup
builder.Services.AddStorageManagerMinimal();

🎯 Requirements

• .NET 9.0 or later
• Visual Studio 2022 / VS Code / JetBrains Rider
• Docker (optional, for development environment)

📈 Project Status

✅ Production Ready - Complete implementation with full testing

• ✅ All Core Features - Storage drivers, encryption, compression, caching
• ✅ Complete Testing - 222 tests passing across all providers
• ✅ All Storage Providers - Local, Cloud (AWS, Azure, Google), Database, Redis, SFTP, Memory
• ✅ Security Validated - No known vulnerabilities, secure dependencies
• ✅ Performance Optimized - Async operations, streaming, compression
• ✅ Production Deployments - Docker support, health checks, monitoring
• ✅ Comprehensive Documentation - API docs, examples, guides

🏗️ Project Structure

StorageManager/
├── 📚 docs/                    # Complete documentation
├── 💻 src/                     # Source code
│   ├── StorageManager/         # 📦 Complete package (this)
│   ├── StorageManager.Core/    # Core interfaces and models
│   ├── StorageManager.Services/# Implementation services
│   ├── StorageManager.Providers/ # Storage drivers
│   ├── StorageManager.Extensions/ # ASP.NET Core integration
│   ├── StorageManager.Configuration/ # Configuration models
│   └── StorageManager.Utilities/ # Helper utilities
├── 📱 examples/                # Usage examples
├── 🧪 tests/                   # Unit and integration tests
├── 🚀 deployment/              # Docker configurations
└── 🛠️ tools/                   # Development tools

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for:

• Development Setup - Local environment configuration
• Coding Standards - Code style and quality guidelines
• Pull Request Process - How to submit changes
• Issue Reporting - Bug reports and feature requests

👥 Contributors

We thank all contributors who have helped make StorageManager better:

🏆 Core Team

• Edgar Poghosyan - Project Creator & Lead Developer
• Hakob Vardanyan - Core Developer & Architecture

🌟 How to Contribute

We welcome contributions of all kinds! Here are some ways you can help:

• 🐛 Report Bugs - Found an issue? Let us know!
• 💡 Suggest Features - Have an idea? Share it with us!
• 📖 Improve Documentation - Help make our docs better
• 🧪 Write Tests - Increase our test coverage
• 🔧 Submit Code - Fix bugs or add new features

See our Contributing Guide for detailed instructions.

📊 Performance

Benchmarks

Optimizations

• Async Operations - Non-blocking I/O
• Streaming - Memory-efficient for large files
• Compression - Up to 70% size reduction
• Caching - Configurable cache strategies
• Connection Pooling - Efficient resource usage

🔗 Links

• 📦 NuGet Package: https://www.nuget.org/packages/Innovayse.StorageManager
• 🔗 GitHub Repository: https://github.com/edgar2031/Storage-Manager
• 📚 Documentation: docs/
• 💡 Examples: examples/
• 🧪 Tests: tests/
• 🐛 Issues: https://github.com/edgar2031/Storage-Manager/issues
• 💬 Discussions: https://github.com/edgar2031/Storage-Manager/discussions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💡 Need Help?

• 📖 Check the documentation
• 💻 Browse examples
• 🐛 Report issues
• 💬 Start discussions

Built with ❤️ by Edgar Poghosyan and Hakob Vardanyan