👁 Image
OutWit.Shared.Storage.Providers 1.0.0

OutWit.Shared.Storage.Providers

Blob-storage abstractions for OutWit hosts. Defines a low-level IBlobStorageProvider (Write / Append / Read / ReadChunk / Delete / Exists / GetSize by Guid + filename), the IBlobStorageProviderPlugin plugin contract (a marker over IWitPlugin so transports load via WitPluginLoader), the IBlobStorageSettings configuration contract, and MemoryPack-friendly BlobInfo / BlobUploadSession models.

This is the contract package — install one of the provider plugins to get an actual transport:

• OutWit.Shared.Storage.Provider.Disk — filesystem
• (future) OutWit.Shared.Storage.Provider.S3, OutWit.Shared.Storage.Provider.Azure, …

Install

dotnet add package OutWit.Shared.Storage.Providers
# plus at least one provider plugin
dotnet add package OutWit.Shared.Storage.Provider.Disk

Wire up

public sealed class MyStorageSettings : IBlobStorageSettings
{
 public string ProviderKey { get; set; } = "Disk";
 public string PluginsPath { get; set; } = "@Storage";
 public long MaxBlobSize { get; set; } = 5L * 1024 * 1024 * 1024; // 5 GB
 public int ChunkSize { get; set; } = 4 * 1024 * 1024; // 4 MB
 public long ChunkedTransferThresholdBytes { get; set; } = 16 * 1024 * 1024;
 public int DefaultTtlMinutes { get; set; } = 60 * 24 * 7; // 7 days
 public int CleanupIntervalMinutes { get; set; } = 15;
 public int UploadSessionTimeoutMinutes { get; set; } = 30;
}

services.AddBlobStorage(new MyStorageSettings(), environment);

// later, inside any service:
public class MyService
{
 private readonly IBlobStorageProvider m_storage;
 public MyService(IBlobStorageProvider storage) => m_storage = storage;

 public async Task UploadAsync(byte[] data)
 {
 var blobId = Guid.NewGuid();
 await using var s = new MemoryStream(data);
 await m_storage.WriteAsync(blobId, "data.bin", s);
 }
}

AddBlobStorage loads every plugin under PluginsPath (defaults to @Storage next to the executable), picks the one whose Key matches Settings.ProviderKey, and registers its IBlobStorageProvider in DI.

API

License

Licensed under the Apache License, Version 2.0. See LICENSE.txt.

Trademark / Project name

"OutWit" and the OutWit logo are used to identify the official project by Dmitry Ratner. You may refer to the project name in a factual way; you may not use the name or logo to imply official endorsement of a fork or derived product.