hub.util.aws — hub.util/aws 0.3.21

AWS Helpers for image uploading and friends.

aws-config clj/s

(aws-config)

Inputs: [] Returns: AWSConfig

AWSConfig clj/s

AWSKey clj/s

Bucket clj/s

Supported buckets. We only have one for now.

bucket-config clj

(bucket-config conf bucket)

Inputs: [conf :- AWSConfig bucket :- Bucket] Returns: BucketConf

Returns a BucketConf from the supplied AWS config.

bucket-name clj

BucketConf clj/s

Channel clj/s

core.async channel.

cloudfront-name clj

cloudfront-url clj

(cloudfront-url conf doc bucket-key image-name)

Inputs: [conf :- AWSConfig doc :- {s/Any s/Any} bucket-key :- Bucket image-name :- ImageName] Returns: (s/maybe CloudFrontURL)

Returns a cloudfront URL for the supplied image suitable for splicing into HTML. Example args a user-doc, :photos, and :main-photo.

CloudFrontURL clj/s

content-types clj/s

Map of content-type to image extension.

crazy-map clj/s

Map of IE-style, annoying prefixes over to proper image types.

CrazyInput clj/s

Credentials clj/s

current-manager clj

(current-manager cred)

Inputs: [cred :- Credentials] Returns: TransferManager

Returns the current active TransferManager.

generate-key clj

(generate-key image-name content-type)

Inputs: [image-name :- ImageName content-type :- ImageContent] Returns: AWSKey

Image clj

Schema for images that come in via the temporary store, from ring's multipart-params middleware.

ImageContent clj/s

ImageName clj/s

massage-content-type clj/s

(massage-content-type t)

Inputs: [t :- (s/either ImageContent CrazyInput)] Returns: ImageContent

Fixes up some of the crazier input types that IE responds to.

to-stream clj

(to-stream tempfile)

Inputs: [tempfile :- (:tempfile Image)] Returns: InputStream

trim-channel clj

(trim-channel chan url)

Inputs: [chan :- Channel url :- AWSKey] Returns: Channel

Modifies a file upload channel to only return success or failure events.

NOTE: Down the road, we could use the other channel elements (bytes transferred so far) to build a client-side upload progress bar.

upload! clj

(upload! conf man bucket key filename)

(upload! conf man bucket key input params)

Inputs: ([conf :- AWSConfig man :- TransferManager bucket :- Bucket key :- AWSKey filename :- String] [conf :- AWSConfig man :- TransferManager bucket :- Bucket key :- AWSKey input :- InputStream params :- {s/Any s/Any}]) Returns: {s/Any s/Any}

Triggers an upload via the TransferManager to s3. Returns a clojure map that represents an AWS Transfer instance. The map goes from method name (in keyword form) -> function with input types as described here: http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/transfer/Transfer.html

upload-image clj

(upload-image aws-config bucket image-name {:keys [tempfile content-type size]})

Inputs: [aws-config :- AWSConfig bucket :- Bucket image-name :- ImageName {:keys [tempfile content-type size]} :- Image] Returns: Channel

Takes an image that'd show up directly from the upload dialogue and starts an asynchronous upload to S3. Returns a channel that reports the success status and the new url on a successful upload.

Uploaded images are cached, by default, for 10 years (see the cache-control header in here)