io.randomseed.utils.bot — io.randomseed/utils-bus 2.0.5

Random utils, bot abstraction.

bot-ns clj

(bot-ns v id)

bot? clj

(bot? v)

command clj

(command wrk command & args)

current-ns-str clj

generic-control clj

(generic-control bot-session f wrk req handler-args)

Common tasks which any bot should support.

generic-data-handler clj

(generic-data-handler data bot-session)

Handles additional data which are a result of a request. It's like side effect for the request, regardless of its reply. When session object is returned then bot-specific data handlers should not interfere (processing is done) and just replace session with the returned one. When nil is returned then bot-specific data handlers should exit the loop and finish execution. All other data is passed as is.

get-config clj

(get-config wrk)

get-data clj

(get-data wrk k & args)

Requests bot-specific data using namespaced command :io.randomseed.utils.bot/data. Custom handlers should match this command explicitly (e.g. ::bot/data with [io.randomseed.utils.bot :as bot]).

get-data! clj

(get-data! wrk k & args)

Requests bot-specific data with side effects using namespaced command :io.randomseed.utils.bot/data!. Custom handlers should match this command explicitly (e.g. ::bot/data! with [io.randomseed.utils.bot :as bot]).

get-session clj

(get-session wrk)

handle-request clj

(handle-request bot-session f data-handler wrk req & handler-args)

Handles requests. Returns an Outcome object. Passes control to a chosen request handler f to prepare the response. Updates the returned map with data-handler if data is present in the outcome.

instance-config clj

(instance-config cfg instance-id)

Creates an instance of a configuration for the given instance (if a bot is instantiable).

load clj

(load config-parser id)

(load config-parser id instance-id)

load-config clj

(load-config cfg-parser bot-id)

(load-config cfg-parser config-file bot-id)

parse-config clj

(parse-config cfg)

(parse-config cfg instance-id)

pause clj

(pause wrk)

ping clj

(ping wrk)

run! clj

(run! wrk)

(run! bot-session cfg)

(run! bot-session cfg instance)

Runs a bot by creating a worker thread with communication channels. After bot is successfully created it queries it for its updated configuration and replaces a local one with it.

stop! clj

(stop! wrk)

update-local-config! clj

(update-local-config! wid)