S3.FileManager 1.1.0

S3.FileManager

The S3.FileManager package simplifies integration with the Amazon S3 storage service, providing an easy-to-use interface for common operations such as uploading, downloading, listing, and deleting files. Ideal for .NET developers who want to quickly incorporate cloud storage functionality into their applications without dealing with the complexity of the S3 API.

Main Features:

• Simple Upload: Upload files to an S3 bucket with just a few lines of code.
• Fast Download: Download files from any S3 bucket efficiently.
• File Listing: Easily list files stored in a bucket.
• File Deletion: Remove files from a bucket with simple commands.
• Permissions Management: Configure access permissions for your files.
• Advanced Settings Support: Use advanced S3 settings without complications.

How to use:

1. Installation: dotnet add package S3.FileManager

2. Example of use:

//inject the base configuration into your Program.cs or Startup.cs
services.AddStorageConfiguration(configuration);

//In your appsetings define the buckes that will be used
 "StorageSettings": {
    "Buckets": [
      {
        "Name": "example-bucket-name",
        "HasDefault": true,
        "Path": "dev"
      }
    ]
  },

//inject the communication interface with S3 into the constructor of your service class, and then call the upload or download method of the file you want to manipulate
 public class ExampleService : IExampleService 
 {
        private readonly IStorageService _storage;

        public ExampleService (IStorageService storage)
        {
            _storage = storage;
        }

        public async Task Execute(IFormFile file)
        {
               await _storage.UploadFileAsync(file.ToArray(), "file-name");

                var result = await _storage.GetFileAsync("file-name");
                
                Console.WriteLine($"Download result: {result}");
        }
 }

Compatibility

• .NET Standard 2.0 or higher
• .NET Core 2.0 or higher
• .NET Framework 4.6.1 or higher

Requirements:

• AWS account with permissions to access S3
• AWS access credentials (Access Key and Secret Key)

License:

MIT License