The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Bot::BasicBot::Pluggable::Module::MetaSyntactic - IRC frontend to Acme::MetaSyntactic

VERSION

version 1.004

SYNOPSIS

    < you> bot: meta batman
    < bot> kapow

DESCRIPTION

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.