phergie / phergie-irc-plugin-react-command
Phergie plugin for parsing commands issued to the bot
Installs: 8 526
Dependents: 33
Suggesters: 2
Security: 0
Stars: 2
Watchers: 4
Forks: 5
Open Issues: 1
Requires
Requires (Dev)
- phake/phake: 2.0.0-beta2
- phpunit/phpunit: 4.1.*
This package is not auto-updated.
Last update: 2020-03-16 04:51:43 UTC
README
This repo is being kept for posterity and will be archived in a readonly state. If you're interested it can be forked under a new Composer namespace/GitHub organization.
phergie/phergie-irc-plugin-react-command
A plugin for Phergie to parse commands issued to the bot.
A common plugin to use in combination with this one is the CommandHelp plugin, which provides information about available commands and their usage to users.
Install
The recommended method of installation is through composer.
composer require phergie/phergie-irc-plugin-react-command
See Phergie documentation for more information on installing plugins.
Configuration
new \Phergie\Irc\Plugin\React\Command\Plugin(array( // Select how you'd like the command to be triggered. // Only 1 method supported at a time so make sure to remove unused methods. 'prefix' => '!', // string denoting the start of a command // or 'pattern' => '/^!/', // PCRE regular expression denoting the presence of a // command // or 'nick' => true, // true to match common ways of addressing the bot by its // connection nick ))
Usage
This plugin monitors PRIVMSG
and NOTICE
events attempting to locate
commands. When it finds one, it emits a custom event: 'command.COMMAND'
where
COMMAND
is the matched command. Other plugins can subscribe to these events to
be notified when a command is received.
Event parameters include an instance of
CommandEvent
(a subclass of UserEvent
)
that contains data about the parsed command and any other parameters that
accompanied the original event that contained the command (e.g. an object that implements
EventQueueInterface
).
Here's an example of a plugin that handles a 'foo' command:
use Phergie\Irc\Plugin\React\Command\CommandEvent; use Phergie\Irc\Bot\React\EventQueueInterface; use Phergie\Irc\Bot\React\PluginInterface; class FooPlugin implements PluginInterface { public function getSubscribedEvents() { return array('command.foo' => 'handleFooCommand'); } public function handleFooCommand(CommandEvent $event, EventQueueInterface $queue) { $commandName = $event->getCustomCommand(); $fooParams = $event->getCustomParams(); // ... } }
In its getSubscribedEvents()
implementation, this plugin indicates that it
will listen for 'command.foo'
events emitted by the Command plugin.
It specifies handleFooCommand()
as the method for handling those events. Among
this method's parameters is $event
, an instance of the Command plugin's special
CommandEvent
class.
handleFooCommand()
invokes two methods of $event
: getCustomCommand()
,
which returns the command that was received ('foo'
in this case) and is
primarily useful when the same method is used to handle multiple commands, and
getCustomParams()
, which returns parameters specified when the command was
issued.
Let's say the Command plugin is used with no configuration and receives this IRC event:
PRIVMSG #channel foo bar "two words" baz
It will emit the 'command.foo'
event. The $event
parameter sent to a
handler method for that event will return 'foo'
when its getCustomCommand()
method is called and array('bar', 'two words', 'baz')
when its
getCustomParams()
method is called.
Tests
To run the unit test suite:
curl -s https://getcomposer.org/installer | php
php composer.phar install
./vendor/bin/phpunit
License
Released under the BSD License. See LICENSE
.