Racker
Elegant Rackspace cloudfiles client.
var racker = ; racker ;
Features
- Container / Object metadatas.
- Uploading streams / localfiles / buffers
- Upload progress support.
- Elegant API
- Authenticates automagically.
Installation
$ npm install racker
Getting started
Authentication
Racker authenticates automatically once you attempt to issue a request, it will also re authenticate automatically if the token has expired.
So you just need to set your credentials and you'r ready to issue requests.
var racker = ; racker ; // defaulted to us
That's it this Racker instance will now wait until you attempt to issue a request.
Creating a container
racker ;
Updating a container
racker ;
Uploading a file
Local file.
racker ;
Stream.
racker ;
Buffer.
racker ;
Deleting a file
racker ;
Deleting a container
racker ;
Listing stuff
Note that the list is always defaulted to json
and will be parsed
for you by superagent, the length of the list is defaulted to 50
you can change those with .query()
parameters
// containersracker ; // objects from a containerracker ; // listing more than 50 at onceracker ;
Running Tests
To run the test suite create a test/auth.json
:
Then run:
$ npm install$ make test
that's it.
Contributing
I accept pull requests this library is not yet full featured, i have several features i plan on implementing see todos below.
todos
- List container objects.
- List all containers.
- Tests on updating object metadata.
- implement
request.meta()
to set object / container metas. - implement
response.meta()
to get object / container metas. - implement large object uploads.
- Test wether or not re-authentication works..
License
MIT