unifier.response — clj-unifier 0.0.15

A Clojure(Script) library for unified responses.

*allow-override?* clj/s

A flag to allow overriding already associated keys in the registry. Overrides are disabled by default.

*registry clj/s

A registry for associating unified response types with http response types.

-> clj/s macro

(-> expr & forms)

This macro is the same as clojure.core/some->, but the check is done using the predicate error? of the IUnifiedResponse protocol and the substitution occurs as in macro -> (the thread-first macro).

->> clj/s macro

(->> expr & forms)

This macro is the same as clojure.core/some->>, but the check is done using the predicate error? of the IUnifiedResponse protocol and the substitution occurs as in macro ->> (the thread-last macro).

?-> clj/s macro

(?-> & forms)

The safe version of the macro -> (the thread-first macro).

?->> clj/s macro

(?->> & forms)

The safe version of the macro ->> (the thread-last macro).

as-accepted clj/s

(as-accepted data)

(as-accepted data meta)

Returns unified ::accepted response.

as-busy clj/s

(as-busy data)

(as-busy data meta)

Returns unified ::busy response.

as-conflict clj/s

(as-conflict data)

(as-conflict data meta)

Returns unified ::conflict response.

as-created clj/s

(as-created data)

(as-created data meta)

Returns unified ::created response.

as-deleted clj/s

(as-deleted data)

(as-deleted data meta)

Returns unified ::deleted response.

as-error clj/s

(as-error data)

(as-error data meta)

(as-error type data meta)

Returns unified ::error response.

as-exception clj/s

(as-exception data)

(as-exception data meta)

Returns unified ::exception response.

as-forbidden clj/s

(as-forbidden data)

(as-forbidden data meta)

Returns unified ::forbidden response.

as-http clj/s

(as-http x)

Returns ring response by the given unified response type.

as-incorrect clj/s

(as-incorrect data)

(as-incorrect data meta)

Returns unified ::incorrect response.

as-interrupted clj/s

(as-interrupted data)

(as-interrupted data meta)

Returns unified ::interrupted response.

as-not-found clj/s

(as-not-found data)

(as-not-found data meta)

Returns unified ::not-found response.

as-success clj/s

(as-success data)

(as-success data meta)

(as-success type data meta)

Returns unified ::success response.

as-unauthorized clj/s

(as-unauthorized data)

(as-unauthorized data meta)

Returns unified ::unauthorized response.

as-unavailable clj/s

(as-unavailable data)

(as-unavailable data meta)

Returns unified ::unavailable response.

as-unknown clj/s

(as-unknown data)

(as-unknown data meta)

Returns unified ::unknown response.

as-unsupported clj/s

(as-unsupported data)

(as-unsupported data meta)

Returns unified ::unsupported response.

as-warning clj/s

(as-warning data)

(as-warning data meta)

Returns unified ::warning response.

cljs? clj

(cljs? env)

Checks &env in macro and returns true if that cljs env. Otherwise false.

error-types clj/s

Common error types.

error? clj/s

(error? x)

Returns true if the given value is instance of unifier.response/UnifiedError. Otherwise false.

get-data clj/s

(get-data x)

Returns data of response.

get-meta clj/s

(get-meta x)

Returns meta of response.

get-type clj/s

(get-type x)

Returns type of response.

IUnifiedResponse clj/s protocol

-get-meta clj/s

(-get-meta _)

Returns meta of response.

-error? clj/s

(-error? _)

Returns true if the given value is instance of unifier.response/UnifiedError. Otherwise false.

-success? clj/s

(-success? _)

Returns true if the given value is instance of unifier.response/UnifiedSuccess. Otherwise false.

-set-data clj/s

(-set-data _ data)

Sets data of response.

-set-type clj/s

(-set-type _ type)

Sets type of response.

-set-meta clj/s

(-set-meta _ meta)

Sets meta of response.

-get-type clj/s

(-get-type _)

Returns type of response.

-response? clj/s

(-response? _)

Returns true if the given value is implements unifier.response/IUnifiedResponse protocol. Otherwise false.

-get-data clj/s

(-get-data _)

Returns data of response.

link clj/s

(link unified http & kvs)

Same as link! but allows overrides by default.

link! clj/s

(link! unified http & kvs)

Associate unified response type with http response type.

Returns:

• true - when all unified response types successfully linked

Params:

• unified - unified response type
• http - http response type

Throws:

• ExceptionInfo:
  • throws when the given http response type is unknown
  • throws when the given unified response type has been already associated with http response type

response clj/s

(response x)

(response type x)

Returns ring response, where:

• :status - gets from the registry by the unified response type
• :header - empty map
• :body - unwrapped unified response

response? clj/s

(response? x)

Returns true if the given value is implements unifier.response/IUnifiedResponse protocol. Otherwise false.

safe clj/s macro

(safe body)

(safe body handler)

Extended version of try-catch.

set-data clj/s

(set-data x data)

Sets data of response.

set-meta clj/s

(set-meta x meta)

Sets meta of response.

set-type clj/s

(set-type x type)

Sets type of response.

success-types clj/s

Common success types.

success? clj/s

(success? x)

Returns true if the given value is instance of unifier.response/UnifiedSuccess. Otherwise false.

unwrap clj/s

(unwrap response)

Returns unwrapped unified response (as map).

with-default clj/s

(with-default x)

Returns default http response type by the given unified response type.

Returns: If the given unified response is:

• success - :unifier.response.http/ok
• error - :unifier.response.http/bad-request
• ::error, ::exception - :unifier.response.http/internal-server-error Otherwise nil.