Magallanes/Mage/Command/AbstractCommand.php

<?php
/*
 * This file is part of the Magallanes package.
*
* (c) Andrés Montañez <andres@andresmontanez.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/

namespace Mage\Command;

use Mage\Config;

/**
 * Abstract Class for a Magallanes Command
 *
 * @author Andrés Montañez <andres@andresmontanez.com>
 */
abstract class AbstractCommand
{
    /**
     * Instance of the loaded Configuration.
     *
     * @var \Mage\Config
     */
    protected $config = null;

    private $helpMessage;
    private $usageExamples = [];
    private $syntaxMessage;

    /**
     * Runs the Command
     * @return integer exit code
     * @throws \Exception
     */
    abstract public function run();

    /**
     * Sets the Loaded Configuration.
     *
     * @param Config $config
     */
    public function setConfig(Config $config)
    {
        $this->config = $config;
    }

    /**
     * Gets the Loaded Configuration.
     *
     * @return Config
     */
    public function getConfig()
    {
        return $this->config;
    }

    public function setHelpMessage($message)
    {
        $this->helpMessage = $message;

        return $this;
    }

    public function addUsageExample($snippet, $description = '')
    {
        array_push($this->usageExamples, [$snippet, $description]);

        return $this;
    }

    public function setSyntaxMessage($message)
    {
        $this->syntaxMessage = $message;

        return $this;
    }

    public function getInfoMessage()
    {
        $indent = str_repeat(" ", 4);

        $output = "";

        if (!empty($this->helpMessage)) {
            $output .= "\n";
            $output .= $this->helpMessage . "\n";
        }

        if (!empty($this->syntaxMessage)) {
            $output .= "\n";
            $output .= "Syntax:\n";
            $output .= $indent;
            $output .= $this->syntaxMessage;
            $output .= "\n";
        }

        if (!empty($this->usageExamples)) {
            $output .= "\n";
            $output .= "Usage examples:\n";
            foreach ($this->usageExamples as $example) {
                $snippet = $example[0];
                $description = $example[1];
                $output .= "$indent* ";
                if (!empty($description)) {
                    $description = rtrim($description, ': ') . ":";
                    $output .= $description;
                    $output .= "\n$indent$indent";
                }

                $output .= $snippet;
                $output .= "\n";
            }
        }

        return $output;
    }
}