a53eb5e0d2
This patch converts all English language strings used within
depressionbot's localisation interface (that is, strings.json) to their
ISO-639-1 equivalents.
The purpose of this patch is to make the strings.json file less
English-dependent.
All languages with an ISO-639-1 code have been converted; that is,
English, Spanish and Welsh, to ``en``, ``es`` and ``cy`` respectively.
This patch does not attempt to force a solution to the issue of Na'vi:
the language does not have a large enough corpus to warrant its own ISO
639-3 code, and as such there is no perfect solution. For the time
being, this patch keeps the Na'vi language as its English language
string ("Na'vi"). A possible solution to this discrepancy includes using
the ISO 639-3 code ``art``, used for artificial languages that do not
qualify for an official code, or by using local use codes specified
in ISO 639-3 (qaa to qtz).
This patch requires collaboration with upstream repositories that also
use strings.json, such as the Github and Stats modules.
|
||
|---|---|---|
| .. | ||
| api.js | ||
| command.js | ||
| commands.js | ||
| config.json | ||
| README.md | ||
| strings.json | ||
Command
Handles the command execution logic for DBot.
Description
Command flow:
- Does the input match a command key in the loaded commands?
- If command not found and quotes is loaded, attempt to print quote of given command name
- Is the user banned from running the given command?
- Is the user ignoring the command?
- Is the channel ignoring the command?
- Does the use have the access level to run the command?
- Is the command set as disabled?
- Apply regex to the command, pass into event object.
- If regex does not apply, show usage info.
- Run the command.
This is the only module which is force loaded, even if it’s not specified in the configuration file.
Commands
~usage command
Show usage information for a given command.
~help [command|module]
Link module help for a module given either the module name or the name of a command belonging to a module.
API
isBanned(user, command)
Return whether a user is currently banned from a given commands.
hasAccess(user, command)
Return whether a user has the access level (moderator, admin) to run a given command.
isIgnoring(user, command)
Return whether a user is currently marked as ignoring a given command.
addHook(command, callback)
This API function allows you to hook functions into DBot commands. For example, you may add a hook to post on Identica when a new quote is added to the database with the ~qadd command. As a less useful example, here is how you might add a hook to log to the console every time someone uses the reload command:
dbot.api.command.addHook('reload', function() {
console.log('Reload run!');
});Hook arguments are populated by the return values of the functions they are hooked into, and command hooks are not run if the command explicitly returns ‘false.’ For example, the ~qadd command returns [ key, quote ], and the hook function will be called with these variables given in the order they were returned, so you would retrieve the key and the quote from a hook to ~qadd like this:
dbot.api.command.addHook('~qadd', function(key, quote) { ...The best place to add hooks to commands is in the ‘onLoad’ function of your module, as this ensures it will be run while all other modules are loaded. If the target command does not exist (for example if its module was not loaded), the hook will not be added and no errors will be thrown.