bloody-simple-s3

A bloody simple interface to S3, based on the official AWS sdk

Usage no npm install needed!

<script type="module">
  import bloodySimpleS3 from 'https://cdn.skypack.dev/bloody-simple-s3';
</script>

README

Bloody simple S3

A bloody simple S3 client, based on the official AWS SDK.

Build Status for visionmobile/bloody-simple-s3

Features

  • Promise and callback interface;
  • Automatic file integrity check;
  • Bloody simple API.

Quick start

var S3 = require('bloody-simple-s3');

var s3 = new S3({
  bucket: 'bucket-name',
  region: 'us-east-1',
  accessKeyId: 'AKIA-access-key',
  secretAccessKey: 'secret-access-key',
  sslEnabled: true
});

s3.upload('/Users/john/Photos/monkey.jpg', 'images/monkey-1.jpg')
  .then(function (file) {
    console.log(file.name);
  })
  .catch(function (err) {
    console.error(err);
  });

For further information on how to use this library please refer to the API docs.

Installation

$ npm install bloody-simple-s3

Requirements

  • Node.js 0.8+

Contribute

Source code contributions are most welcome. The following rules apply:

  1. JavaScript source code needs to follow the Airbnb Style Guide;
  2. Functions need to be well documented in API docs;
  3. Unit tests are necessary.

Support

If you are having issues with this library, please let us know.

License

MIT