outpace.remote.service — com.outpace/remote 0.4.3

add-endpoint clj/s

(add-endpoint spec key endpoint-config)

add-headers clj/s

(add-headers spec headers)

add-method clj/s

(add-method spec method)

add-on-exception clj/s

(add-on-exception spec f)

add-on-request clj/s

(add-on-request spec f)

add-on-status clj/s

(add-on-status spec m)

defendpoint clj macro

(defendpoint sym url-template & body)

Shorthand syntax for defining and endpoint and configuring it.

Ex.

(defendpoint all "/users" (method :get)

(on-status
  (200 [{:keys [body]}]
    (let [c (count (:body resp))]
      (js/console.log c "USERS FOUND")))))

defservice clj macro

(defservice sym & body)

Shorthand syntax for defining a service and configuring it.

Ex.

(defservice user-service (on-status (200 [_] (js/console.log "SUCCESS"))) (endpoint :all "/users" (method :get)))

endpoint clj macro

(endpoint service-spec key url-template & config)

Shorthand syntax to add :on-response configuration to an endpoint or service spec.

Ex. (endpoint {} "/users/:id" (method :get))

headers clj macro

(headers spec headers)

Shortand syntax to add :headers configuration to an endpoint spec.

Ex. (headers {} {"X-Foo" "bar"})

make-endpoint clj/s

(make-endpoint
  {:keys [method url-template on-request on-status on-exception headers username
          password]
   :or {on-request identity on-status {} on-exception identity headers {}}
   :as opts})

make-service clj/s

(make-service {:keys [endpoints] :as service-spec})

Return a function which takes an endpoint key and any number of additional arguments and applies the function given by (make-endpoint (get-in service-spec [:endpoints key])). If the service-spec includes configuration for :headers, :on-status, or :on-request, the endpoint configuration will be merged in to it.

Options:

• headers - A map of headers to use with each HTTP request.
• on-status - A map of status code to response handler.
• on-request - A function of at least one arity which accepts the request map as it's first argument.
• endpoints - A map of endpoint-key to endpoint-config. See make-endpoint for endpoint-config details.

method clj macro

(method spec method)

Shortand syntax to add :method configuration to an endpoint spec.

Ex. (method {} :get)

method->http-fn clj/s

on-exception clj macro

(on-exception spec & fn-tail)

Shorthand syntax to add :on-exception configuation to an endpoint or spec.

Ex. (on-exception {} [err] (println "ERROR: " (.getMessage err))

on-request clj macro

(on-request spec & fn-tail)

Shorthand syntax to add :on-request configuation to an endpoint or spec.

Ex. (on-request {} [req] (assoc-in req [:headers "X-Foo"] "bar"))

on-status clj macro

(on-status spec & fn-specs)

Shorthand syntax to add :on-status configuation to an endpoint or service spec.

Ex. (on-status {} (200 [_] (pritnln "YAY!")) (404 [_] (println "BOO!")))

service-spec? clj/s

(service-spec? spec)

template clj/s

(template s)

(template s {:keys [regex]})

Return a string template fn from s.

url-call clj/s

(url-call http-fn url req)