SmartAwsConsole 1.0.11

🧠 SmartAwsConsole

A Unified AWS S3 Utility Library for .NET

Easily integrate Amazon S3 file operations — including large uploads — into your applications (Windows Service, Web API, or Console) with minimal setup.

SmartAwsConsole abstracts all AWS complexities, letting you pass your own credentials and directly call upload, download, and bucket management operations.

🚀 Features

• ✅ Easy AWS client creation with your credentials
• ✅ Upload single and large files (chunked 10MB parts)
• ✅ List buckets and objects
• ✅ Download and delete objects
• ✅ Works in:
  • .NET Console Apps
  • ASP.NET Core APIs
  • Windows Services
• ✅ Fully async and awaitable API

📦 Installation

dotnet add package SmartAwsConsole

Or via NuGet Package Manager:

Install-Package SmartAwsConsole

⚙️ Configuration

You do not need to hardcode credentials inside the package.
Pass them dynamically from your own configuration (e.g. appsettings.json, environment variables, or Azure KeyVault).

Example appsettings.json:

{
  "AWS": {
    "AccessKey": "YOUR_ACCESS_KEY",
    "SecretKey": "YOUR_SECRET_KEY",
    "Region": "ap-south-1"
  }
}

🧠 Usage Examples

🖥️ Console Application Example

using SmartAwsConsole;

class Program
{
    static async Task Main()
    {
        var s3Client = AwsClientFactory.CreateS3Client("ACCESS_KEY", "SECRET_KEY", "ap-south-1");
        var s3Manager = new S3Manager(s3Client);

        await s3Manager.UploadLargeFileAsync("my-bucket", "uploads/test.zip", @"D:\files\test.zip");

        var files = await s3Manager.ListObjectsAsync("my-bucket");
        Console.WriteLine("Files:");
        files.ForEach(Console.WriteLine);

        await s3Manager.DownloadFileAsync("my-bucket", "uploads/test.zip", @"D:\downloads\test.zip");
    }
}

🧰 ASP.NET Core API Example

using Microsoft.AspNetCore.Mvc;
using SmartAwsConsole;

[ApiController]
[Route("api/[controller]")]
public class S3Controller : ControllerBase
{
    private readonly S3Manager _s3Manager;

    public S3Controller(IConfiguration config)
    {
        var accessKey = config["AWS:AccessKey"];
        var secretKey = config["AWS:SecretKey"];
        var region = config["AWS:Region"];

        var client = AwsClientFactory.CreateS3Client(accessKey, secretKey, region);
        _s3Manager = new S3Manager(client);
    }

    [HttpPost("upload")]
    public async Task<IActionResult> Upload(IFormFile file)
    {
        var path = Path.GetTempFileName();
        using (var stream = new FileStream(path, FileMode.Create))
        {
            await file.CopyToAsync(stream);
        }

        await _s3Manager.UploadLargeFileAsync("my-bucket", file.FileName, path);
        System.IO.File.Delete(path);

        return Ok("File uploaded successfully");
    }
}

⚙️ Windows Service Example

using SmartAwsConsole;
using System.ServiceProcess;

public class SmartAwsUploaderService : ServiceBase
{
    private S3Manager _s3Manager;

    protected override void OnStart(string[] args)
    {
        var s3Client = AwsClientFactory.CreateS3Client("ACCESS_KEY", "SECRET_KEY", "ap-south-1");
        _s3Manager = new S3Manager(s3Client);
        Task.Run(() => MonitorFolderAsync());
    }

    private async Task MonitorFolderAsync()
    {
        string folderPath = @"C:\Uploads";
        foreach (var file in Directory.GetFiles(folderPath))
        {
            await _s3Manager.UploadLargeFileAsync("my-bucket", Path.GetFileName(file), file);
        }
    }
}

🧩 Future Enhancements

• ✅ EC2 management
• ✅ DynamoDB operations
• ✅ CloudWatch logging
• ✅ IAM role integration
• ✅ Retry + progress tracking events
• ✅ Angular + React front-end NPM library (smart-uploader)

📜 License

MIT © 2025 — SmartAwsConsole Contributors