NAME
Bot::BasicBot::Pluggable::Module::MetaSyntactic - IRC frontend to Acme::MetaSyntactic
VERSION
version 1.004
SYNOPSIS
< you> bot: meta batman
< bot> kapowDESCRIPTION
This module is a frontend to the Acme::MetaSyntactic module which will let you pick metasyntactical variables names while chatting over IRC.
This module takes inspiration from the first IRC metasyntactic bot: Bot::MetaSyntactic in some of its behaviour and messages.
IRC USAGE
The bot will accept a number of commands:
Theme commands
These commands return items from Acme::MetaSyntactic themes.
meta <theme> [ <count> ] [ /regexp/ ]-
return one or more items from the theme.
Items are picked at random from the list, and not repeated until the list is exhausted.
This will pick the default category if the theme has multiple categories.
meta <theme>/<category> [ <count> ] [ /regexp/ ]-
return one or more items from the theme sub-categories.
The bot maintains state for each theme/category, so items can be picked from sub-categories of the same theme independently.
If count is 0, then the whole list if returned (which does not disturb the partially consumed list from the non-zero use case). Note that there is a limit to the number of items returned, so that the bot does not accidentaly spam a channel.
If a /regexp/ is given, only items that match the regular expression will be shown. With a count of 0, all matching items are returned. The filtering is done on the whole list, so it has no influence on the state of non-filtered request (with regard to repetition).
Meta (sic) commands
These commands allow to query the Acme::MetaSyntactic themes:
meta themes?-
return the list of available themes.
meta categories? theme-
return the list of categories for the given theme.
SEE ALSO
Acme::MetaSyntactic, Bundle::MetaSyntactic, Bot::MetaSyntactic.
AUTHOR
Philippe Bruhat (BooK) <book@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Philippe Bruhat (BooK).
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.