plugin manager

src/Psy/Command/DemoCommand.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Psy\Command;
+
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+class DemoCommand extends Command
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function configure()
+    {
+        $this
+            ->setName('demo')
+            ->setDefinition(array(
+                new InputOption('message', 'm', InputOption::VALUE_REQUIRED, 'Message to send.'),
+            ))
+            ->setDescription('Sample command just for testing.')
+            ->setHelp(
+                <<<HELP
+HELP
+            );
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $message = $input->getOption('message');
+        $output->writeln(sprintf('<info>Received message "%s". </info>', $message));
+    }
+}

src/Psy/Configuration.php

@@ -16,6 +16,7 @@
 use Psy\ExecutionLoop\Loop;
 use Psy\Output\OutputPager;
 use Psy\Output\ShellOutput;
+use Psy\Plugin\Manager;
 use Psy\Presenter\PresenterManager;
 use Psy\Readline\GNUReadline;
 use Psy\Readline\Libedit;
@@ -33,9 +34,10 @@ class Configuration
         'defaultIncludes', 'useReadline', 'usePcntl', 'codeCleaner', 'pager',
         'loop', 'configDir', 'dataDir', 'runtimeDir', 'manualDbFile',
         'requireSemicolons', 'historySize', 'eraseDuplicates', 'tabCompletion',
-        'tabCompletionMatchers',
+        'tabCompletionMatchers', 'registerPlugins',
     );
 
+    private $registerPlugins = true;
     private $defaultIncludes;
     private $configDir;
     private $dataDir;
@@ -96,6 +98,27 @@ public function __construct(array $config = array())
         // go go gadget, config!
         $this->loadConfig($config);
         $this->init();
+
+        // ask the plugin manager for configurations
+        if ($this->getRegisterPlugins()) {
+            $this->loadConfig(Manager::getConfiguration($config));
+        }
+    }
+
+    /**
+     * @param $bool
+     */
+    public function setRegisterPlugins($bool)
+    {
+        $this->registerPlugins = $bool;
+    }
+
+    /**
+     * @return bool
+     */
+    public function getRegisterPlugins()
+    {
+        return $this->registerPlugins;
     }
 
     /**

src/Psy/Plugin/AbstractPlugin.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace Psy\Plugin;
+
+abstract class AbstractPlugin
+{
+    public static function register()
+    {
+        Manager::register(new static(), static::getName());
+    }
+
+    /**
+     * @return string
+     */
+    final public static function getName()
+    {
+        $class = new \ReflectionClass(get_called_class());
+
+        return preg_replace('#Plugin$#', '', $class->getShortName());
+    }
+
+    /**
+     * @param array $configuration
+     *
+     * @return array
+     */
+    final public static function getConfiguration($configuration = array())
+    {
+        return array_merge_recursive(
+            $configuration,
+            array(
+               'commands'   => static::getCommands(),
+               'presenters' => static::getPresenters(),
+               'matchers'   => static::getMatchers(),
+                // if any more parts of the config are exposed publicly, remember to add here with the static ref.
+            )
+        );
+    }
+
+    // any publicly exposed configuration piece below here ↓
+
+    /**
+     * @return array
+     */
+    public static function getCommands()
+    {
+        // add your own commands
+        return array();
+    }
+
+    /**
+     * @return array
+     */
+    public static function getPresenters()
+    {
+        // add your own presenters
+        return array();
+    }
+
+    /**
+     * @return array
+     */
+    public static function getMatchers()
+    {
+        // add your own presenters
+        return array();
+    }
+}

src/Psy/Plugin/DemoPlugin.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Psy\Plugin;
+
+use Psy\Command\DemoCommand;
+
+class DemoPlugin extends AbstractPlugin
+{
+    /**
+     * @return array
+     */
+    public static function getCommands()
+    {
+        return array(
+            new DemoCommand(),
+        );
+    }
+}

src/Psy/Plugin/Manager.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Psy\Plugin;
+
+class Manager
+{
+    /** @var AbstractPlugin[] */
+    protected static $plugins = array();
+
+    /**
+     * @param AbstractPlugin $plugin
+     * @param $name
+     */
+    public static function register(AbstractPlugin $plugin, $name)
+    {
+        self::$plugins[$name] = $plugin;
+    }
+
+    /**
+     * @param array $configuration
+     *
+     * @return array
+     */
+    public static function getConfiguration($configuration = array())
+    {
+        foreach (self::$plugins as $plugin) {
+            $configuration = $plugin::getConfiguration($configuration);
+        }
+
+        return $configuration;
+    }
+}