Project

easys3

0.0
No commit activity in last 3 years
No release in over 3 years
Put files to s3 & get files from s3 with single line of code.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 10.0
~> 3.0

Runtime

 Project Readme

Easys3

Putting files to S3 & getting files from S3 should be one liner. In reality, you might be confused with tricky behavior of official aws-sdk gem. With easys3, Easys3.put(bucket_name, file_name, file, acl) means putting files to s3 and Easys3.get(bucket_name, file_name) means getting a file from s3.

Installation

Add this line to your application's Gemfile:

gem 'easys3'

And then execute:

$ bundle

Or install it yourself as:

$ gem install easys3

Usage

[Prerequisite] create your .env file

AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_S3_REGION=...
FYI: Known AWS regions include:
ap-east-1
ap-northeast-1
ap-northeast-2
ap-south-1
ap-southeast-1
ap-southeast-2
ca-central-1
eu-central-1
eu-north-1
eu-west-1
eu-west-2
eu-west-3
sa-east-1
us-east-1
us-east-2
us-west-1
us-west-2
cn-north-1
cn-northwest-1
us-gov-east-1
us-gov-west-1

Putting a file to s3

Easys3.put(bucket_name, file_name, file, acl) # acl is optional

example

Easys3.put("test-bucket", "test/abc.log", "abc")

example response (success)

{:status=>201, :data=>#<struct Aws::S3::Types::PutObjectOutput ... }

example response (failure)

{:status=>500, :message=>#<Aws::Errors::NoSuchEndpointError: ... }

Getting a file from s3

Easys3.get(bucket_name, file_name)

example

Easys3.get("test-bucket", "test/abc.log")

example response (success)

{:status=>200, :data=>"abc"}

example response (failure - 404)

{:status=>404, :message=>"Could not find file: test/missing.log in the bucket: test-bucket"}

example response (failure - 500)

{:status=>500, :message=>#<Aws::Errors::NoSuchEndpointError: ... }

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/chienomi/easys3. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Easys3 project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.