charRow converts a string representation of binary uint8 to uint8. This is a bit inefficient but it keeps the font easy to edit and it only needs to r

Printf formats the message and propagates it as a log message.

Replyf is the same as Reply but allows for string formatting using fmt.Sprintf()

Register registers a plugin with the bot.

SetUsage sets the usage string for the command. Returns the command.

AddKVParam creates and adds a key/value parameter to the command handle and returns the new parameter.

Debugf formats the message and propagates it. No work is performed if debugging is disabled.

AddAlias adds an alias to the command and returns the paramter.

Fatalf formats the message, propagates the log, then exits the program.

Reply is a helper that crafts a new event from the provided string and initiates the reply on the broker attached to the event. The message is routed

DB returns the database singleton.

Println merges the arguments and propagates the result as a log message.

AddCmd adds a subcommand to the handle and returns the new (sub-)command.

the text name of the broker, arbitrary, but usually "slack" or "cli"

SqlInit executes the provided SQL once per runtime. Execution is not tracked across restarts so statements still need to use CREATE TABLE IF NOT EXIST

AddIdxParam adds a positional parameter to the command and returns the new parameter.

Error replies to the event with the provided error. Future: need to figure out if there's going to be a kind of error handling module in Hal for makin

parse a list of argv-style strings (0 is always the command name e.g. []string{"prefs"}) foo bar --baz foo --bar baz --version foo bar=baz foo x=y z=q

BodyAsArgv does minimal parsing of the event body, returning an argv-like array of strings with quoted strings intact (but with quotes removed). The g

BrokerName returns the text name of current broker.

MustString returns the value as a string. If it was required/not-set, panic ensues. Empty string may be returned for not-required+not-set.

Get retrieves a value from the database. If the database returns an error, Success will be false and the Error field will be populated.

_idxparams makes sure the _idxparams map is initialized and returns the map.

SubCmdToken returns the subcommand's token string. Returns empty string if there is no subcommand.

GetKVParamInst gets a key/value parameter instance by its key.

GetPlugin returns the plugin specified by its name string.

Set writes the value and returns a new struct with the new value.

_boolparams makes sure the _boolparams list is initialized and returns the list.

_kvparams makes sure the _kvparams list is initialized and returns the list.

AuthenticatedGet authenticates with the provided token and GETs the url.

Clone() returns a copy of the event with the same broker/room/user and a current timestamp. Body, Command, and Subject will be empty. Time is updated

Instance creates an instance of a plugin. It is *not* registered (and therefore not considered by the router until that is done).

ListKVParamInsts initializes the kvparaminsts list on the fly and returns it.

ReplyTable sends a table of data back, formatting it according to preferences. TODO: move code from brokers/slack/broker.go/SendTable here TODO: docum

initialize allocates channels and starts the background goroutines that forward output to stdout

AsPref returns a a pref with user, room, broker, and plugin set using data from the event handle.

GetIdxParamInsByNamet gets an indexed parameter instance by its name.

ListSubCmds makes sure the SubCmds list is initialized and returns the list.

Put is an alias for Set

Cmd returns the command it was called on. It does nothing and exists to make it possible to format chained calls nicely.

InstanceList returns a snapshot of the instance list at call time.

ListBoolParamInsts initializes the boolparaminsts list on the fly and returns it.

Panicf formats a message and panics. Not propagated.

ParseColor parses a 6-byte or 8-byte hex color string (HTML-style) and returns a color.RGBA. If anything goes wrong during parsing, it returns the def

One returns the most-specific preference from the Prefs according to the precedence order of user>room>broker>plugin>global.

Remainder initializes the remainder list on the fly and returns it.

RoomIdToName gets the human-readable room name for a user ID using an in-memory cache that falls through to the Slack API

SlackTime converts the timestamp string to time.Time

Table returns Prefs as a 2d list ready to hand off to e.g. hal.AsciiTable()

UserIdToName gets the human-readable username for a user ID using an in-memory cache that falls through to the Slack API

mapIdxParamInsts initializes the idxparaminsts list on the fly and returns it.

AddBroker adds a broker to the router and starts forwarding events between it and the router.

FindPrefs fetches the union of all matching settings from the database for user, broker, room, and plugin. Plugins can use the Prefs methods to filter

GetBroker retrieves a broker handle by name.

Register puts a pf in the global list and makes it available to GetPeriodicFunc. Anonymous pf's work fine but are not retreivable.

Route is the main method for the router. It blocks and should be run in a goroutine exactly once. Running more than one router in the same process wil

SetPrefix sets a new prefix that will be prepended to every message from the logger handle.

Start a periodic function.

assertZeroIdxParams panics if there are any IdxParam defined.

TODO: consider making the token key per-room so different rooms can use different tokens doing this will require a separate cache object per token...

AddBoolParam adds a boolean/flag parameter to the command and returns the new parameter.

FindInstances returns the plugin instances that match the provided room id, broker, and plugin name.

GetIdxParamInst gets a positional parameter instance by its index.

https://v2.developer.pagerduty.com/v2/page/api-reference#!/On-Calls/get_oncalls TODO: figure out if query should be a typed struct or validated

NewCmd returns an initialized Cmd.

NewEvent returns an initialized Event structure. You probably don't want to use this and instead use NewTrigger/NewAck/NewResolve.