Shaunebu.Azure.Storage 1.2.0

Shaunebu.Azure.Storage 🌐✨

A unified library for interacting with Azure Blob Storage and Azure Table Storage.

Provides CRUD operations, querying, metadata management, SAS generation, batch operations, and logging via dependency injection. This library is designed to simplify working with Azure Storage in multi-platform .NET applications.

🚀 Installation

Add the library to your project via NuGet:

dotnet add package Shaunebu.Azure.Storage

🔑 Main Features

🌐 Shaunebu.Azure.Storage.Blobs

⚡ Initialization

Initialize the service using your connection string and logger:

using Shaunebu.Azure.Storage;
using Shaunebu.Azure.Storage.Abstractions;
using Microsoft.Extensions.Logging;

// Setup logger
var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
var logger = loggerFactory.CreateLogger<AzureBlobStorageService>();

string connectionString = "DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net";
var blobService = new AzureBlobStorageService(connectionString, logger);

🔑 Main Properties

🛠 Blob Operations

➕ Upload Blob (Stream or Bytes)

using var stream = new MemoryStream(Encoding.UTF8.GetBytes("Hello World"));
await blobService.UploadBlobAsync("mycontainer", "myblob.txt", stream, contentType: "text/plain");

byte[] data = Encoding.UTF8.GetBytes("Hello Blob Storage");
await blobService.UploadBlobAsync("mycontainer", "myblob2.txt", data, metadata: new Dictionary<string, string> { { "Author", "John" } });

📥 Download Blob

var downloadedStream = await blobService.DownloadBlobAsync("mycontainer", "myblob.txt");
using var reader = new StreamReader(downloadedStream!);
string content = await reader.ReadToEndAsync();

🗑 Delete Blob

await blobService.DeleteBlobAsync("mycontainer", "myblob.txt");

🔑 Generate SAS URI

Generate a read-only SAS URI valid for a specific duration:

string sasUri = await blobService.GetBlobSasUriAsync(
    "mycontainer", 
    "myblob2.txt", 
    TimeSpan.FromHours(1)
);

You can also customize permissions:

string sasUriWrite = await blobService.GetBlobSasUriAsync(
    "mycontainer", 
    "myblob2.txt", 
    TimeSpan.FromHours(1), 
    BlobSasPermissions.Read | BlobSasPermissions.Write
);

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

Tip: Shaunebu.Azure.BlobStorage simplifies blob handling with metadata, content type, and SAS generation in a single, DI-ready service.

📌 Example Usage

// Upload a blob from string
using var stream = new MemoryStream(Encoding.UTF8.GetBytes("Hello Blob Storage"));
await blobService.UploadBlobAsync("documents", "example.txt", stream, contentType: "text/plain");

// Upload with metadata
await blobService.UploadBlobAsync("documents", "example2.txt", Encoding.UTF8.GetBytes("Data"), metadata: new Dictionary<string, string> { { "Author", "John" } });

// Download blob as stream
var blobStream = await blobService.DownloadBlobAsync("documents", "example.txt");

// Read content as string
string content = await blobService.DownloadBlobAsStringAsync("documents", "example.txt");

// Generate SAS URI
string sasUri = await blobService.GetBlobSasUriAsync("documents", "example.txt", TimeSpan.FromHours(1));

// Delete blob
await blobService.DeleteBlobAsync("documents", "example.txt");

🚀 Platform Support

Compatible with .NET 6+ and Azure.Storage.Blobs SDK:

✅ Advantages

• Upload streams and byte arrays easily

• Supports metadata and content type per blob

• Generates SAS URIs with permissions and expiry

• Container auto-creation

• Logging integrated via ILogger

• Clean dependency injection ready

• Exception context provided for failed operations

<br>

🌐 Shaunebu.Azure.Storage.Tables

⚡ Initialization

Initialize the service using your connection string and table name:

using Shaunebu.Azure.Storage;
using Shaunebu.Azure.Storage.Abstractions;
using Microsoft.Extensions.Logging;

// Inject logger via DI
var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
var logger = loggerFactory.CreateLogger<AzureTableStorageService<User>>();

string connectionString = "DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net";
var tableService = new AzureTableStorageService<User>(connectionString, "Users", logger);

// Ensure table exists
await tableService.EnsureTableExistsAsync();

🔑 Main Properties

🛠 CRUD Operations

➕ Add Entity

var user = new User
{
    PartitionKey = "USERS",
    RowKey = Guid.NewGuid().ToString(),
    Name = "John Doe",
    Email = "john@example.com"
};

await tableService.AddEntityAsync(user);

✏️ Upsert Entity

user.Email = "john.doe@example.com";
await tableService.UpsertEntityAsync(user);

🗑 Delete Entity

await tableService.DeleteEntityAsync(user.PartitionKey, user.RowKey);

📥 Get Entity

var existingUser = await tableService.GetEntityAsync(user.PartitionKey, user.RowKey);

🔍 Query Entities

By Filter (OData syntax)

var allUsers = await tableService.QueryEntitiesAsync("PartitionKey eq 'USERS'");

By Expression

var filteredUsers = await tableService.QueryEntitiesAsync(u => u.Name.Contains("John"));

Paged Query

var (items, continuationToken) = await tableService.QueryPagedAsync("PartitionKey eq 'USERS'", pageSize: 50);

⚡ Batch Operations

Supports batch upserts (max 100 entities per transaction):

var users = new List<User> { user1, user2, user3 };
await tableService.BatchUpsertAsync(users);

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

Tip: Shaunebu.Azure.TableStorage simplifies working with Azure Table Storage, especially for batch operations, filtering, and multi-environment enterprise scenarios.

📌 Example Usage

// Initialize service
await tableService.EnsureTableExistsAsync();

// Add user
await tableService.AddEntityAsync(user);

// Update user
user.Email = "new.email@example.com";
await tableService.UpsertEntityAsync(user);

// Query users
var johnUsers = await tableService.QueryEntitiesAsync(u => u.Name.Contains("John"));

// Batch upsert
await tableService.BatchUpsertAsync(new List<User> { user1, user2 });

// Delete user
await tableService.DeleteEntityAsync(user.PartitionKey, user.RowKey);

🚀 Platform Support

Compatible with .NET 6+ and Azure.Data.Tables SDK:

✅ Advantages

• Full CRUD support, including batch operations

• Supports LINQ and OData filters

• Continuation token support for large tables

• Logging built-in via ILogger

• Clean dependency injection ready

• Multi-environment enterprise friendly