discljord.messaging.impl — com.github.discljord/discljord 1.3.1

Implementation namespace for discljord.messaging.

auth-headers clj

(auth-headers token user-agent)

defdispatch clj macro

(defdispatch endpoint-name
             [major-var & params]
             [& opts]
             opts-sym
             method
             status-sym
             body-sym
             url-str
             method-params
             promise-val)

Defines a dispatch method for the the endpoint with endpoint-name.

In the parameter declarations [major-var & params], the major variable always comes first, no matter at which position it is in the actual endpoint definition. Even if the corresponding endpoint does not have a major variable, a symbol for it needs to be provided in the parameters (typically _ since it will always be bound to nil).

opts are the optional parameters as specified in the endpoint definition, method is the http method used (:get, :post, ...), status-sym is a symbol that will be bound to the response code (http status), body-sym is a symbol that will be bound to the response body (as a string), url-string is the url of the endpoint (its expression can depend on the arguments), method-params is a map describing what to send in the request, promise-val is the expression that will be in the promise returned to the user of the endpoint.

dispatch-http clj multimethod

Takes a process and endpoint, and dispatches an http request. Must return the response object from the call to allow the runtime to update the rate limit.

make-request! clj

(make-request! token rate-limits global-limit endpoint event-data bucket)

Makes a request after waiting for the rate limit, retrying if necessary.

rate-limited? clj

(rate-limited? rate-limit)

Returns the number of millis until the limit expires, or nil if not limited

start! clj

(start! token)

Takes a token for a bot and returns a channel to communicate with the message sending process.

step-agent clj

(step-agent process [endpoint & event-data :as event])

Takes a process and an event, and runs the request, respecting rate limits

stop! clj

(stop! channel)

Takes the channel returned from start! and stops the messaging process.

update-rate-limit clj

(update-rate-limit rate-limit headers)

Takes a rate-limit and a map of headers and returns an updated rate-limit.

If rate limit headers are included in the map, then the rate limit is updated to them, otherwise the existing rate limit is used, but the remaining limit is decremented.