esetres

node-esetres

Installation

npm install esetres

Usage

Usage is pretty straight forward

var fs = require('fs');
var s3 = require('esetres')({
    bucket: "bucketname",
    key: "PUBLICKEY",
    secret: "SUPERSECRETKEY"
});
 
s3.put(fs.createReadStream('./my_secret_identity.png'), '/my_secret_identity.png', function(error, response){
    if (error) return console.log(error, response);
    console.log("Hope no one sees this!");
});
 
s3.get('/my_secret_identity.png', function(error, response){
    if (error) return console.log(error, response);
    var saveStream = fs.createWriteStream('./bruce_wayne.png');
    response.pipe(saveStream);
    console.log("Well, it wouldn't stay a secret forever.");
});
 
s3.put(fs.createReadStream('./me_saving_gotham.mp4'), '/me_saving_gotham.mp4', function(error, response){
    if (error) return console.log(error, response);
    console.log("Crahing the Batmobile was totally worth it.");
});
 
// you can pass in custom headers as a second argument, and the callback third
s3.get('/me_saving_gotham.mp4', { Range: "bytes=500-999" }, function(error, response){
    if (error) return console.log(error, response);
    var saveStream = fs.createWriteStream('./me_saving_gotham.mp4');
    response.pipe(saveStream);
    console.log("Alfred is a terrible cameraman.");
});
 
s3.head('/me_saving_gotham.mp4', function(error, response){
    if (error) return console.log(error, response);
    console.log(response.headers);
});
 

---

#### Methods ##### #put(stream || buffer, path, [headers, callback]) ###### Sends a PUT request to the specified path ##### #get(path, [headers, callback]) ###### Sends a GET request to the specified Object ##### #getBucket([headers, callback]) ###### Returns the contents of the current bucket ##### #head(path, [headers, callback]) ###### Sends a HEAD request to the specified Object ##### #generatePolicyFromObject(object) ###### A helper-function for direct-to-S3 uploads that generates the Base64 encoded version of the policy passed to it ##### #generateSignatureFromPolicyString(policy) ###### A helper-function for direct-to-S3 uploads that works together with the afforementioned function by generating the SHA1-HMAC Base64 encoded signature requred by the S3 API for direct post requests (refer here for more information on the purpose of thes functions)