snake

A simple library to access Amazon S3 from Clojure.

Description

snake allows you to access Amazon S3 buckets in Clojure code. This allows you to do the following, from a Clojure namespace:

Create / list / delete buckets.
Create / list / delete objects.
More in the future.

Usage

First, add snake to your project.clj:

[snake "0.6.7"]

snake, by default, tries to use the instance profiles set in ~/.aws/credentials. However, if you have setup snake already with snake/setup!, then snake will use these details instead.

You can read more about instance profiles here.

Copying files

Copy one object from a source bucket to a destination bucket. By default, if a second bucket is not given, then snake will just copy to the source bucket.

  (snake/copy src-bucket src-key dest-bucket dest-key)

Uploading files

Upload a file to a bucket (basic way). snake will infer the content type of the file, when using the basic way of uploading files.

  (snake/upload! bucket filename file)

To have more control, you can do the following. This allows you to specify the content type of the file.

  (snake/put-object bucket filename content-type file)

If you would like to get the content type of the file, you can do the following.

  (snake/filename->content-type filename)

Miscellaneous

Listing objects.

  (snake/list-objects bucket {:prefix "foo" :delimeter "foo-bar/"})

Return a unique name for a filename.

  (snake/unique-key filename)

Get the URL for a bucket and filename.

  (snake/url-for-bucket-and-key bucket file)

License

Take a look at the LICENSE file in the root of this repository.