<?php
/**
 * Zend Framework (http://framework.zend.com/)
 *
 * @link      http://github.com/zendframework/zf2 for the canonical source repository
 * @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license   http://framework.zend.com/license/new-bsd New BSD License
 * @package   Zend_Console
 */

namespace Zend\Console\Prompt;

use ReflectionClass;
use Zend\Console\Console;
use Zend\Console\Adapter\AdapterInterface as ConsoleAdapter;
use Zend\Console\Exception;

/**
 * @category   Zend
 * @package    Zend_Console
 * @subpackage Prompt
 */
abstract class AbstractPrompt implements PromptInterface
{
    /**
     * @var ConsoleAdapter
     */
    protected $console;

    /**
     * @var mixed
     */
    protected $lastResponse;

    /**
     * Show a prompt
     *
     * @return void
     */
    abstract public function show();

    /**
     * Return last answer to this prompt.
     *
     * @return mixed
     */
    public function getLastResponse()
    {
        return $this->lastResponse;
    }

    /**
     * Return console adapter to use when showing prompt.
     *
     * @return ConsoleAdapter
     */
    public function getConsole()
    {
        if (!$this->console) {
            $this->console = Console::getInstance();
        }

        return $this->console;
    }

    /**
     * Set console adapter to use when showing prompt.
     *
     * @param ConsoleAdapter $adapter
     */
    public function setConsole(ConsoleAdapter $adapter)
    {
        $this->console = $adapter;
    }

    /**
     * Create an instance of this prompt, show it and return response.
     *
     * This is a convenience method for creating statically creating prompts, i.e.:
     *
     *      $name = Zend\Console\Prompt\Line::prompt("Enter your name: ");
     *
     * @return mixed
     * @throws Exception\BadMethodCallException
     */
    public static function prompt()
    {
        if (get_called_class() === __CLASS__) {
            throw new Exception\BadMethodCallException(
                'Cannot call prompt() on AbstractPrompt class. Use one of the Zend\Console\Prompt\ subclasses.'
            );
        }

        $refl     = new ReflectionClass(get_called_class());
        $instance = $refl->newInstanceArgs(func_get_args());
        return $instance->show();
    }
}
