Seen Module

Alfred

Compatibility:

Description

This module allows to search for bots matching a given pattern.
These patterns, by default, will be its JID. Luckilly, it is extendable to what we call custom variables.
You can make a module that will register custom variables (for example in the sysinfo module), and then adding them in the configuration file of the seen module to be able to make searches over their values.
This could allow you to search for degraded raids, ip blocs, global health status, whatever you have in mind.

Configuration

This module can work with an empty configuration. A valid empty configuration file (/usr/local/etc/gotham/modules.conf.d/seen.conf) is:

{
   "vars" : [
   ]
}

If you need to add custom variables to your seen queries, you can add them this way:

{
   "vars" : [
      "raid_status",
      "disk_full"
   ]
}

Commands

In this example, I searched for botman-k*, which is every JID that starts with the string botman-k.

The search output is defined as follows:

• one line per matching botman
• we firstly show if botman is or isn’t connected to the XMPP server
• the JID (first searchable term) of the botman
• all other searchable terms (custom variables)
• if contact is offline, elapsed time since he went offline