biiwide.sandboxica.alpha — biiwide/sandboxica 0.4.0

always-fail clj

(always-fail client-fn)

This client-fn middleware builds clients that always throw an UnsupportedOperationException for every client action.

always-nothing clj

(always-nothing client-fn)

This client middleware function builds clients that always return a "nothing" value for every client action.

Typically the "nothing" value is nil, but will also return: false, 0, and NaN for methods with primitive return types.

coerce-method-implementation clj

(coerce-method-implementation f method)

Returns a wrapped function that will marshall arguments to Clojure values, and unmarshall Clojure values to a result type based on the given method signature.

get-deep-fields clj

(get-deep-fields obj)

Returns a map of all non-null values returned by invoking all public getters on the specified object. The functionality is similar to amazonica.core/get-fields but also performs a limitted search of the object's parent classes.

This function can be used to implement the amazonica.core/IMarshall protocol for classes that are not well supported, such as com.amazonaws.services.s3.model.PutObjectRequest.

invocation-handler clj macro

(invocation-handler [method-sym args-sym] & body)

A macro that constructs an invocation handler for use by client proxies. Invocations handlers are functions of 2 arguments: a method, and an arguments array.

Example: (let [client (create-client class)] (invocation-handler [^Method method args] (println (.getName method) : (seq args)) (.invoke method client args)))

just clj macro

(just & impls)

This macro constructs a client middleware function which just implements specific AWS endpoint calls for specific clients. The endpoint calls are defined based on the corresponding Amazonica function. All other clients and method calls are delegated to the original client function and client methods. See also: 'just* Example: (just (amazonica.aws.ec2/describe-instances [req] (println "Request:" req) {:next-token "abc" :reservations []}) (amazonica.aws.sqs/delete-message ([req] (println "Request:" req) {}) ([queue-url receipt-handle] (println "QueueUrl:" queue-url "ReceiptHandle:" receipt-handle) {})))

just* clj

(just* implementations)

Constructs a client middleware function that just implements specific AWS endpoint calls for specific clients. The client endpoints are constructed based on a map of Amazonica function names to implementing functions. All other clients and method calls are delegated to the original client function and client methods. See also: 'just Example: (just* {'amazonica.aws.ecs/describe-instances (fn [req] (println "Request:" req) {}) 'amazonica.aws.sqs/delete-message (fn ([req] (println "Request:" req) {}) ([queue-url receipt-handle] (println {:queue-url queue-url, :receipt-handle: receipt-handle}) {})))

marshall++ clj

(marshall++ x)

Like amazonica.core/marshall but improves handling of some edge cases.

method-coercions clj

(method-coercions f methods)

Given a function and a collection of methods, returns a map of composed functions that will coerce arguments and results to match the method signatures. See also: coerce-method-implementation

with clj macro

(with client-middleware & body)

This macro creates a scope that overrides the construction of AmazonWebServiceClients by amazonica.

It relies on a dynamic var to override these behaviors, so all caveats that appy to dynamic vars apply here. Example: (sandbox/with sandbox/always-nothing (amazonica.aws.ec2/run-instances {:image-id "foo" ...}))

with-client-middleware* clj

(with-client-middleware* client-middleware f)

Evaluates a function in the context of the provided amazon-client-fn.