Zodbot: Difference between revisions

Revision as of 18:34, 16 July 2009

zodbot is a [ supybot http://sourceforge.net/projects/supybot/ ] instance connected to the irc.freenode.net IRC network and joined to many Fedora-related IRC channels.

zodbot runs on the noc1.fedoraproject.org host, hosted by Fedora infrastructure.

This page describes what zodbot does and how it can be used by those with the permissions to operate it.

Addressing zodbot

zodbot watches for . as it's prefix, so if you want to query it in a channel, you will need to add . to the beginning of any of the listed commands below. If you wish to avoid chatter in channel from zodbot, you can /msg it directly, in which case you do not need the prefix character, you may wish to do this in channels with a large number of users or if you have a number of queries.

Fedora-specific functions

whoowns package name (pkgdb)

Returns the FAS account of the owner of a package.

branches package name (pkgdb)

Returns the branches of a package.

fas query (fas)

Searches the Fedora Account System database in usernames, emails, full names, and IRC nicks. (Note that some accounts have enabled privacy, so nothing but their FAS username will be searchable.)

fasinfo account name (fas)

Provides detailed Fedora Account System information about the specific account name. This requires an exact username.

sponsors group name (fas)

Provides a list of sponsors for an exact group name, with @ indicating administrators of the group.

what package name (pkgdb)

Returns a description of a package.

Koji-specific functions

builders - returns a list of build machines enabled and disabled.
building <builder> - returns what is building on builder number <builder>
taskload - lists number of current koji tasks.
buildload - lists load on all koji build cluster.

Meeting Functions

zodbot has the supybot-meetbot plugin package installed and configured. See: the MeetBot wiki page for more information on the meeting commands. Meeting logs will be at [ http://meetbot.fedoraproject.org ].

In general for meetings using the plugin, you will want to use this sequence of commands:

#startmeeting - start the meeting.
#meetingtopic <topic> - overall meeting topic (example: FESCo meeting)
#topic <currenttopic> - Use topic to go through each of the topics in your adgenda. The main meetingtopic will stay the same.
#info, #help, #agreed, #denied, etc - as needed in the meeting.
#endmeeting

Zodbot also has some aliases setup to list the time until various meetings:

nextfescomeeting, nextkdemeeting, nextepelmeeting, nextinframeeting, nextrelengmeeting, etc. These commands will list the time until the next meeting of that sig or group.

Other useful commands

seen <nick> - returns the last time nick was seen in that channel and what they were saying.
any <nick> - returns the last time nick was in any channel zodbot is in and what they were saying.

Contact

For any questions about fedbot, please ask in #fedora-admin.

@@ Line 1: / Line 1: @@
-== Overview ==
+'''zodbot''' is a [ supybot http://sourceforge.net/projects/supybot/ ] instance connected to the irc.freenode.net IRC network and joined to many [[Communicate#IRC|Fedora-related IRC channels]].
-zodbot is a [ supybot http://sourceforge.net/projects/supybot/ ] instance connected to the irc.freenode.net irc network.
 zodbot runs on the noc1.fedoraproject.org host, hosted by Fedora infrastructure.
@@ Line 12: / Line 10: @@
 If you wish to avoid chatter in channel from zodbot, you can /msg it directly, in which case you do not need the prefix character, you may wish to do this in channels with a large number of users or if you have a number of queries.
-== Fedora Plugin Functions ==
+== Fedora-specific functions ==
-Zodbot is able to query a number of Fedora specific items, including:
-=== In the supybot-fedora plugin ===
-* whoowns <pkg> - will tell you what Fedora Account System name owns package pkg.
+* '''whoowns''' ''package name'' (pkgdb)
-* branches <pkg> - will tell you what branches a Fedora package pkg has.
+:: Returns the FAS account of the owner of a package.
-* fas <name> - will search the Fedora Account system database for a wildcard match for name. Note that this is a *<name>* search.
+* '''branches''' ''package name'' (pkgdb)
-* fasinfo <name> - will provided detailed Fedora Account System info about the specific fedora account <name>. Note that this is an exact match for name only.
+:: Returns the branches of a package.
-* sponsors <group> - will provide a list of sponsors for <group> with @ indicating admins of the group.
+* '''fas''' ''query'' (fas)
-* what <pkg> - returns a description of package named <pkg>.
+:: Searches the Fedora Account System database in usernames, emails, full names, and IRC nicks. (Note that some accounts have enabled privacy, so nothing but their FAS username will be searchable.)
+* '''fasinfo''' ''account name'' (fas)
+:: Provides detailed Fedora Account System information about the specific account name. This requires an exact username.
+* '''sponsors''' ''group name'' (fas)
+:: Provides a list of sponsors for an exact group name, with @ indicating administrators of the group.
+* '''what''' ''package name'' (pkgdb)
+:: Returns a description of a package.
-=== In the supybot-koji plugin ===
+== Koji-specific functions ==
 * builders - returns a list of build machines enabled and disabled.