Returns true if the supplied bucket name already exists in S3.

Copy an existing S3 object to another key. Returns a map containing
the data returned from S3

Create a new S3 bucket with the supplied name.

Delete the S3 bucket with the supplied name.

Delete an object from an S3 bucket.

Deletes a specific version of the specified object in the specified bucket.

Return a presigned URL for an S3 object. Accepts the following options:
:expires     - the date at which the URL will expire (defaults to 1 day from now)
:http-method - the HTTP method for the URL (defaults to :get)

Get the access control list (ACL) for the supplied bucket. The ACL is a map
containing two keys:
  :owner  - the owner of the ACL
  :grants - a set of access permissions granted

The grants themselves are maps with keys:
  :grantee    - the individual or group being granted access
  :permission - the type of permission (:read, :write, :read-acp, :write-acp or
                :full-control).

Get an object from an S3 bucket. The object is returned as a map with the
following keys:
  :content  - an InputStream to the content
  :metadata - a map of the object's metadata
  :bucket   - the name of the bucket
  :key      - the object's key
Be extremely careful when using this method; the :content value in the returned
map contains a direct stream of data from the HTTP connection. The underlying
HTTP connection cannot be closed until the user finishes reading the data and
closes the stream.
Therefore:
  * Use the data from the :content input stream as soon as possible
  * Close the :content input stream as soon as possible
If these rules are not followed, the client can run out of resources by
allocating too many open, but unused, HTTP connections.

Get the access control list (ACL) for the supplied object. See get-bucket-acl
for a detailed description of the return value.

Get an object's metadata from a bucket.  A optional map of options may be supplied.
Available options are:
  :version-id - the version of the object
The metadata is a map with the
following keys:
  :cache-control          - the CacheControl HTTP header
  :content-disposition    - the ContentDisposition HTTP header
  :content-encoding       - the character encoding of the content
  :content-length         - the length of the content in bytes
  :content-md5            - the MD5 hash of the content
  :content-type           - the mime-type of the content
  :etag                   - the HTTP ETag header
  :last-modified          - the last modified date
  :server-side-encryption - the server-side encryption algorithm

Returns a function that adds a new grant map to a set of grants.
See update-bucket-acl.

List all the S3 buckets for the supplied client. The buckets will be
returned as a seq of maps with the following keys:
  :name          - the bucket name
  :creation-date - the date when the bucket was created
  :owner         - the owner of the bucket

List the objects in an S3 bucket. A optional map of options may be supplied.
Available options are:
  :delimiter - read only keys up to the next delimiter (such as a '/')
  :marker    - read objects after this key
  :max-keys  - read only this many objects
  :prefix    - read only objects with this prefix

The object listing will be returned as a map containing the following keys:
  :bucket          - the name of the bucket
  :prefix          - the supplied prefix (or nil if none supplied)
  :objects         - a list of objects
  :common-prefixes - the common prefixes of keys omitted by the delimiter
  :max-keys        - the maximum number of objects to be returned
  :truncated?      - true if the list of objects was truncated
  :marker          - the marker of the listing
  :next-marker     - the next marker of the listing

List the versions in an S3 bucket. A optional map of options may be supplied.
Available options are:
  :delimiter         - the delimiter used in prefix (such as a '/')
  :key-marker        - read versions from the sorted list of all versions starting
                       at this marker.
  :max-results       - read only this many versions
  :prefix            - read only versions with keys having this prefix
  :version-id-marker - read objects after this version id

The version listing will be returned as a map containing the following versions:
  :bucket                 - the name of the bucket
  :prefix                 - the supplied prefix (or nil if none supplied)
  :versions               - a sorted list of versions, newest first, each
                            version has:
                            :version-id     - the unique version id
                            :latest?        - is this the latest version for that key?
                            :delete-marker? - is this a delete-marker?
  :common-prefixes        - the common prefixes of keys omitted by the delimiter
  :max-results            - the maximum number of results to be returned
  :truncated?             - true if the results were truncated
  :key-marker             - the key marker of the listing
  :next-version-id-marker - the version ID marker to use in the next listVersions
                            request in order to obtain the next page of results.
  :version-id-marker      - the version id marker of the listing

Returns true if an object exists in the supplied bucket and key.

Return a lazy sequence of objects in an S3 bucket. See list-objects for options.
If prefix-or-options is a string, imply {:prefix prefix-or-options}

Do a multipart upload of a file into a S3 bucket at the specified key.
The value must be a java.io.File object.  The entire file is uploaded
or not at all.  If an exception happens at any time the upload is aborted
and the exception is rethrown. The size of the parts and the number of
threads uploading the parts can be configured in the last argument as a
map with the following keys:
  :part-size - the size in bytes of each part of the file.  Must be 5mb
               or larger.  Defaults to 5mb
  :threads   - the number of threads that will upload parts concurrently.
               Defaults to 16.

Put a value into an S3 bucket at the specified key. The value can be
a String, InputStream or File (or anything that implements the ToPutRequest
protocol).

An optional map of metadata may also be supplied that can include any of the
following keys:
  :cache-control          - the cache-control header (see RFC 2616)
  :content-disposition    - how the content should be downloaded by browsers
  :content-encoding       - the encoding of the content (e.g. gzip)
  :content-length         - the length of the content in bytes
  :content-md5            - the MD5 sum of the content
  :content-type           - the mime type of the content
  :server-side-encryption - set to AES256 if SSE is required

An optional list of grant functions can be provided after metadata.
These functions will be applied to a clear ACL and the result will be
the ACL for the newly created object.

Returns a function that removes a grant map from a set of grants.
See update-bucket-acl.

Initializes an s3-client. If no credentials are provided, DefaultAWSCredentialsProviderChain is
used to search the default environment variables, properties, credentials files, and instance
profile credentials.

Update the access control list (ACL) for the named bucket using functions
that update a set of grants (see get-bucket-acl).

This function is often used with the grant and revoke functions, e.g.

  (update-bucket-acl client bucket
    (grant :all-users :read)
    (grant {:email "foo@example.com"} :full-control)
    (revoke {:email "bar@example.com"} :write))

Updates the access control list (ACL) for the supplied object using functions
that update a set of grants (see update-bucket-acl for more details).