LiteX.Storage.Amazon
9.0.0
dotnet add package LiteX.Storage.Amazon --version 9.0.0
NuGet\Install-Package LiteX.Storage.Amazon -Version 9.0.0
<PackageReference Include="LiteX.Storage.Amazon" Version="9.0.0" />
paket add LiteX.Storage.Amazon --version 9.0.0
#r "nuget: LiteX.Storage.Amazon, 9.0.0"
// Install LiteX.Storage.Amazon as a Cake Addin
#addin nuget:?package=LiteX.Storage.Amazon&version=9.0.0
// Install LiteX.Storage.Amazon as a Cake Tool
#tool nuget:?package=LiteX.Storage.Amazon&version=9.0.0
LiteX Amazon Storage
LiteX.Storage.Amazon is a storage library which is based on LiteX.Storage.Core and Amazon (AWS) S3 API.
This client library enables working with the Amazon S3 Storage (Blob) service for storing binary/blob data.
Small library to abstract storing files to Amazon S3. Quick setup for Amazon S3 and very simple wrapper for the Amazon S3 to handle bucket instantiations.
Very simple configuration in advanced ways. Purpose of this package is to bring a new level of ease to the developers who deal with Amazon S3 integration with their system.
Basic Usage
Install the package
Install via Nuget.
PM> Install-Package LiteX.Storage.Amazon
AppSettings
{
//LiteX Amazon Storage settings
"AmazonBlobConfig": {
"AmazonAwsAccessKeyId": "--- REPLACE WITH YOUR AMAZON ACCESS KEY ID ---",
"AmazonAwsSecretAccessKey": "--- REPLACE WITH YOUR AMAZON SECRET ACCESS KEY ---",
"AmazonRegion": "--- REPLACE WITH YOUR AMAZON REGION ---",
"AmazonBucketName": "--- REPLACE WITH YOUR AZURE AMAZON BUCKET NAME ---",
"EnableLogging": true
}
}
Configure Startup Class
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
// 1. Use default configuration from appsettings.json's 'AmazonBlobConfig'
services.AddLiteXAmazonBlobService();
//OR
// 2. Load configuration settings using options.
services.AddLiteXAmazonBlobService(option =>
{
option.AmazonAwsSecretAccessKey = "";
option.AmazonAwsAccessKeyId = "";
option.AmazonBucketName = "";
option.AmazonRegion = "";
option.EnableLogging = true;
});
//OR
// 3. Load configuration settings on your own.
// (e.g. appsettings, database, hardcoded)
var amazonBlobConfig = new AmazonBlobConfig()
{
AmazonAwsSecretAccessKey = "",
AmazonAwsAccessKeyId = "",
AmazonBucketName = "",
AmazonRegion = "",
EnableLogging = true
};
services.AddLiteXAmazonBlobService(amazonBlobConfig);
// add logging (optional)
services.AddLiteXLogging();
}
}
Sample Usage Example
Same for all providers.
For more helpful information about LiteX Storage, Please click here.
Product | Versions |
---|---|
.NET | net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows |
.NET Core | netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 |
.NET Standard | netstandard2.0 netstandard2.1 |
.NET Framework | net461 net462 net463 net47 net471 net472 net48 net481 |
MonoAndroid | monoandroid |
MonoMac | monomac |
MonoTouch | monotouch |
Tizen | tizen40 tizen60 |
Xamarin.iOS | xamarinios |
Xamarin.Mac | xamarinmac |
Xamarin.TVOS | xamarintvos |
Xamarin.WatchOS | xamarinwatchos |
-
.NETCoreApp 3.1
- AWSSDK.Core (>= 3.7.5.2)
- AWSSDK.S3 (>= 3.7.6)
- LiteX.Log (>= 2.0.0)
- LiteX.Storage.Core (>= 9.0.0)
- Microsoft.Extensions.Configuration (>= 3.1.10)
- Microsoft.Extensions.Configuration.Binder (>= 3.1.10)
- Microsoft.Extensions.DependencyInjection (>= 3.1.10)
-
.NETStandard 2.0
- AWSSDK.Core (>= 3.7.5.2)
- AWSSDK.S3 (>= 3.7.6)
- LiteX.Log (>= 2.0.0)
- LiteX.Storage.Core (>= 9.0.0)
- Microsoft.Extensions.Configuration (>= 3.1.10)
- Microsoft.Extensions.Configuration.Binder (>= 3.1.10)
- Microsoft.Extensions.DependencyInjection (>= 3.1.10)
-
.NETStandard 2.1
- AWSSDK.Core (>= 3.7.5.2)
- AWSSDK.S3 (>= 3.7.6)
- LiteX.Log (>= 2.0.0)
- LiteX.Storage.Core (>= 9.0.0)
- Microsoft.Extensions.Configuration (>= 3.1.10)
- Microsoft.Extensions.Configuration.Binder (>= 3.1.10)
- Microsoft.Extensions.DependencyInjection (>= 3.1.10)
-
net5.0
- AWSSDK.Core (>= 3.7.5.2)
- AWSSDK.S3 (>= 3.7.6)
- LiteX.Log (>= 2.0.0)
- LiteX.Storage.Core (>= 9.0.0)
- Microsoft.Extensions.Configuration (>= 5.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 5.0.0)
- Microsoft.Extensions.DependencyInjection (>= 5.0.1)
-
net6.0
- AWSSDK.Core (>= 3.7.5.2)
- AWSSDK.S3 (>= 3.7.6)
- LiteX.Log (>= 2.0.0)
- LiteX.Storage.Core (>= 9.0.0)
- Microsoft.Extensions.Configuration (>= 6.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 6.0.0)
- Microsoft.Extensions.DependencyInjection (>= 6.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
9.0.0 | 273 | 4/3/2022 |
8.0.0 | 599 | 1/1/2021 |
7.1.0 | 1,660 | 4/3/2020 |
7.0.0 | 10,115 | 8/4/2019 |
6.4.0 | 1,965 | 1/31/2019 |
6.3.0 | 3,770 | 11/15/2018 |
6.2.0 | 658 | 10/10/2018 |
6.1.2 | 680 | 9/13/2018 |
6.1.1 | 638 | 8/27/2018 |
6.0.0 | 698 | 7/22/2018 |
5.0.0 | 774 | 6/27/2018 |
4.1.0 | 751 | 6/16/2018 |
4.0.0 | 822 | 6/2/2018 |
3.0.0 | 847 | 5/7/2018 |
2.0.0 | 917 | 4/25/2018 |
1.0.0 | 932 | 4/22/2018 |
Upgrade to .NET 6.x.
Update libraries and SDKs to latest version.
Get AWS Credentials changes - Use FallbackCredentialsFactory
Last releases notes:
-> Added multi-framework target support - .NET 5, .NET Core 3.1, .NET Standard 2.1 and .NET Standard 2.0
-> Multiple provider support (using provider factory)
-> Performance improvement in provider initialization stage
-> Code breaking changes - Rename default configuration settings in appsettings.json (new settings - AmazonS3Config)
-> Code breaking changes - Core service name changed to AmazonS3Service (Read ducument on GitHub)
-> Bug fixed - Could not load file or assembly 'LiteX Storage Core'
-> Make some sync methods Obsolete
-> New - Delete directory/folder from container/bucket
-> New - Get Container/Bucket size in bytes
-> New - Get number to total items/files in Container/Bucket
-> New - Added new method - Get all containers/buckets
-> New - Added new method - Delete all containers/buckets