Subversion-Projekte lars-tiefland.laravel_shop

<?php

/*

 * This file is part of Psy Shell.

 *

 * (c) 2012-2022 Justin Hileman

 *

 * For the full copyright and license information, please view the LICENSE

 * file that was distributed with this source code.

 */

namespace Psy;

use Psy\Exception\DeprecatedException;

use Psy\Exception\RuntimeException;

use Psy\ExecutionLoop\ProcessForker;

use Psy\Output\OutputPager;

use Psy\Output\ShellOutput;

use Psy\Output\Theme;

use Psy\TabCompletion\AutoCompleter;

use Psy\VarDumper\Presenter;

use Psy\VersionUpdater\Checker;

use Psy\VersionUpdater\GitHubChecker;

use Psy\VersionUpdater\IntervalChecker;

use Psy\VersionUpdater\NoopChecker;

use Symfony\Component\Console\Formatter\OutputFormatterStyle;

use Symfony\Component\Console\Input\InputInterface;

use Symfony\Component\Console\Input\InputOption;

use Symfony\Component\Console\Output\OutputInterface;

/**

 * The Psy Shell configuration.

 */

class Configuration

{

    const COLOR_MODE_AUTO = 'auto';

    const COLOR_MODE_FORCED = 'forced';

    const COLOR_MODE_DISABLED = 'disabled';

    const INTERACTIVE_MODE_AUTO = 'auto';

    const INTERACTIVE_MODE_FORCED = 'forced';

    const INTERACTIVE_MODE_DISABLED = 'disabled';

    const VERBOSITY_QUIET = 'quiet';

    const VERBOSITY_NORMAL = 'normal';

    const VERBOSITY_VERBOSE = 'verbose';

    const VERBOSITY_VERY_VERBOSE = 'very_verbose';

    const VERBOSITY_DEBUG = 'debug';

    private static $AVAILABLE_OPTIONS = [

        'codeCleaner',

        'colorMode',

        'configDir',

        'dataDir',

        'defaultIncludes',

        'eraseDuplicates',

        'errorLoggingLevel',

        'forceArrayIndexes',

        'formatterStyles',

        'historyFile',

        'historySize',

        'interactiveMode',

        'manualDbFile',

        'pager',

        'prompt',

        'rawOutput',

        'requireSemicolons',

        'runtimeDir',

        'startupMessage',

        'theme',

        'updateCheck',

        'useBracketedPaste',

        'usePcntl',

        'useReadline',

        'useTabCompletion',

        'useUnicode',

        'verbosity',

        'warnOnMultipleConfigs',

        'yolo',

    ];

    private $defaultIncludes;

    private $configDir;

    private $dataDir;

    private $runtimeDir;

    private $configFile;

    /** @var string|false */

    private $historyFile;

    private $historySize;

    private $eraseDuplicates;

    private $manualDbFile;

    private $hasReadline;

    private $useReadline;

    private $useBracketedPaste;

    private $hasPcntl;

    private $usePcntl;

    private $newCommands = [];

    private $pipedInput;

    private $pipedOutput;

    private $rawOutput = false;

    private $requireSemicolons = false;

    private $useUnicode;

    private $useTabCompletion;

    private $newMatchers = [];

    private $errorLoggingLevel = \E_ALL;

    private $warnOnMultipleConfigs = false;

    private $colorMode = self::COLOR_MODE_AUTO;

    private $interactiveMode = self::INTERACTIVE_MODE_AUTO;

    private $updateCheck;

    private $startupMessage;

    private $forceArrayIndexes = false;

    /** @deprecated */

    private $formatterStyles = [];

    private $verbosity = self::VERBOSITY_NORMAL;

    private $yolo = false;

    /** @var Theme */

    private $theme;

    // services

    private $readline;

    private $output;

    private $shell;

    private $cleaner;

    private $pager;

    private $manualDb;

    private $presenter;

    private $autoCompleter;

    private $checker;

    private $prompt;

    private $configPaths;

    /**

     * Construct a Configuration instance.

     *

     * Optionally, supply an array of configuration values to load.

     *

     * @param array $config Optional array of configuration values

     */

    public function __construct(array $config = [])

    {

        $this->configPaths = new ConfigPaths();

        // explicit configFile option

        if (isset($config['configFile'])) {

            $this->configFile = $config['configFile'];

        } elseif (isset($_SERVER['PSYSH_CONFIG']) && $_SERVER['PSYSH_CONFIG']) {

            $this->configFile = $_SERVER['PSYSH_CONFIG'];

        }

        // legacy baseDir option

        if (isset($config['baseDir'])) {

            $msg = "The 'baseDir' configuration option is deprecated; ".

                "please specify 'configDir' and 'dataDir' options instead";

            throw new DeprecatedException($msg);

        }

        unset($config['configFile'], $config['baseDir']);

        // go go gadget, config!

        $this->loadConfig($config);

        $this->init();

    }

    /**

     * Construct a Configuration object from Symfony Console input.

     *

     * This is great for adding psysh-compatible command line options to framework- or app-specific

     * wrappers.

     *

     * $input should already be bound to an appropriate InputDefinition (see self::getInputOptions

     * if you want to build your own) before calling this method. It's not required, but things work

     * a lot better if we do.

     *

     * @see self::getInputOptions

     *

     * @throws \InvalidArgumentException

     *

     * @param InputInterface $input

     *

     * @return self

     */

    public static function fromInput(InputInterface $input): self

    {

        $config = new self(['configFile' => self::getConfigFileFromInput($input)]);

        // Handle --color and --no-color (and --ansi and --no-ansi aliases)

        if (self::getOptionFromInput($input, ['color', 'ansi'])) {

            $config->setColorMode(self::COLOR_MODE_FORCED);

        } elseif (self::getOptionFromInput($input, ['no-color', 'no-ansi'])) {

            $config->setColorMode(self::COLOR_MODE_DISABLED);

        }

        // Handle verbosity options

        if ($verbosity = self::getVerbosityFromInput($input)) {

            $config->setVerbosity($verbosity);

        }

        // Handle interactive mode

        if (self::getOptionFromInput($input, ['interactive', 'interaction'], ['-a', '-i'])) {

            $config->setInteractiveMode(self::INTERACTIVE_MODE_FORCED);

        } elseif (self::getOptionFromInput($input, ['no-interactive', 'no-interaction'], ['-n'])) {

            $config->setInteractiveMode(self::INTERACTIVE_MODE_DISABLED);

        }

        // Handle --compact

        if (self::getOptionFromInput($input, ['compact'])) {

            $config->setTheme('compact');

        }

        // Handle --raw-output

        // @todo support raw output with interactive input?

        if (!$config->getInputInteractive()) {

            if (self::getOptionFromInput($input, ['raw-output'], ['-r'])) {

                $config->setRawOutput(true);

            }

        }

        // Handle --yolo

        if (self::getOptionFromInput($input, ['yolo'])) {

            $config->setYolo(true);

        }

        return $config;

    }

    /**

     * Get the desired config file from the given input.

     *

     * @return string|null config file path, or null if none is specified

     */

    private static function getConfigFileFromInput(InputInterface $input)

    {

        // Best case, input is properly bound and validated.

        if ($input->hasOption('config')) {

            return $input->getOption('config');

        }

        return $input->getParameterOption('--config', null, true) ?: $input->getParameterOption('-c', null, true);

    }

    /**

     * Get a boolean option from the given input.

     *

     * This helper allows fallback for unbound and unvalidated input. It's not perfect--for example,

     * it can't deal with several short options squished together--but it's better than falling over

     * any time someone gives us unbound input.

     *

     * @return bool true if the option (or an alias) is present

     */

    private static function getOptionFromInput(InputInterface $input, array $names, array $otherParams = []): bool

    {

        // Best case, input is properly bound and validated.

        foreach ($names as $name) {

            if ($input->hasOption($name) && $input->getOption($name)) {

                return true;

            }

        }

        foreach ($names as $name) {

            $otherParams[] = '--'.$name;

        }

        foreach ($otherParams as $name) {

            if ($input->hasParameterOption($name, true)) {

                return true;

            }

        }

        return false;

    }

    /**

     * Get the desired verbosity from the given input.

     *

     * This is a bit more complext than the other options parsers. It handles `--quiet` and

     * `--verbose`, along with their short aliases, and fancy things like `-vvv`.

     *

     * @return string|null configuration constant, or null if no verbosity option is specified

     */

    private static function getVerbosityFromInput(InputInterface $input)

    {

        // --quiet wins!

        if (self::getOptionFromInput($input, ['quiet'], ['-q'])) {

            return self::VERBOSITY_QUIET;

        }

        // Best case, input is properly bound and validated.

        //

        // Note that if the `--verbose` option is incorrectly defined as `VALUE_NONE` rather than

        // `VALUE_OPTIONAL` (as it is in Symfony Console by default) it doesn't actually work with

        // multiple verbosity levels as it claims.

        //

        // We can detect this by checking whether the the value === true, and fall back to unbound

        // parsing for this option.

        if ($input->hasOption('verbose') && $input->getOption('verbose') !== true) {

            switch ($input->getOption('verbose')) {

                case '-1':

                    return self::VERBOSITY_QUIET;

                case '0': // explicitly normal, overrides config file default

                    return self::VERBOSITY_NORMAL;

                case '1':

                case null: // `--verbose` and `-v`

                    return self::VERBOSITY_VERBOSE;

                case '2':

                case 'v': // `-vv`

                    return self::VERBOSITY_VERY_VERBOSE;

                case '3':

                case 'vv': // `-vvv`

                    return self::VERBOSITY_DEBUG;

                default: // implicitly normal, config file default wins

                    return;

            }

        }

        // quiet and normal have to come before verbose, because it eats everything else.

        if ($input->hasParameterOption('--verbose=-1', true) || $input->getParameterOption('--verbose', false, true) === '-1') {

            return self::VERBOSITY_QUIET;

        }

        if ($input->hasParameterOption('--verbose=0', true) || $input->getParameterOption('--verbose', false, true) === '0') {

            return self::VERBOSITY_NORMAL;

        }

        // `-vvv`, `-vv` and `-v` have to come in descending length order, because `hasParameterOption` matches prefixes.

        if ($input->hasParameterOption('-vvv', true) || $input->hasParameterOption('--verbose=3', true) || $input->getParameterOption('--verbose', false, true) === '3') {

            return self::VERBOSITY_DEBUG;

        }

        if ($input->hasParameterOption('-vv', true) || $input->hasParameterOption('--verbose=2', true) || $input->getParameterOption('--verbose', false, true) === '2') {

            return self::VERBOSITY_VERY_VERBOSE;

        }

        if ($input->hasParameterOption('-v', true) || $input->hasParameterOption('--verbose=1', true) || $input->hasParameterOption('--verbose', true)) {

            return self::VERBOSITY_VERBOSE;

        }

    }

    /**

     * Get a list of input options expected when initializing Configuration via input.

     *

     * @see self::fromInput

     *

     * @return InputOption[]

     */

    public static function getInputOptions(): array

    {

        return [

            new InputOption('config', 'c', InputOption::VALUE_REQUIRED, 'Use an alternate PsySH config file location.'),

            new InputOption('cwd', null, InputOption::VALUE_REQUIRED, 'Use an alternate working directory.'),

            new InputOption('color', null, InputOption::VALUE_NONE, 'Force colors in output.'),

            new InputOption('no-color', null, InputOption::VALUE_NONE, 'Disable colors in output.'),

            // --ansi and --no-ansi aliases to match Symfony, Composer, etc.

            new InputOption('ansi', null, InputOption::VALUE_NONE, 'Force colors in output.'),

            new InputOption('no-ansi', null, InputOption::VALUE_NONE, 'Disable colors in output.'),

            new InputOption('quiet', 'q', InputOption::VALUE_NONE, 'Shhhhhh.'),

            new InputOption('verbose', 'v|vv|vvv', InputOption::VALUE_OPTIONAL, 'Increase the verbosity of messages.', '0'),

            new InputOption('compact', null, InputOption::VALUE_NONE, 'Run PsySH with compact output.'),

            new InputOption('interactive', 'i|a', InputOption::VALUE_NONE, 'Force PsySH to run in interactive mode.'),

            new InputOption('no-interactive', 'n', InputOption::VALUE_NONE, 'Run PsySH without interactive input. Requires input from stdin.'),

            // --interaction and --no-interaction aliases for compatibility with Symfony, Composer, etc

            new InputOption('interaction', null, InputOption::VALUE_NONE, 'Force PsySH to run in interactive mode.'),

            new InputOption('no-interaction', null, InputOption::VALUE_NONE, 'Run PsySH without interactive input. Requires input from stdin.'),

            new InputOption('raw-output', 'r', InputOption::VALUE_NONE, 'Print var_export-style return values (for non-interactive input)'),

            new InputOption('self-update', 'u', InputOption::VALUE_NONE, 'Update to the latest version'),

            new InputOption('yolo', null, InputOption::VALUE_NONE, 'Run PsySH with minimal input validation. You probably don\'t want this.'),

        ];

    }

    /**

     * Initialize the configuration.

     *

     * This checks for the presence of Readline and Pcntl extensions.

     *

     * If a config file is available, it will be loaded and merged with the current config.

     *

     * If no custom config file was specified and a local project config file

     * is available, it will be loaded and merged with the current config.

     */

    public function init()

    {

        // feature detection

        $this->hasReadline = \function_exists('readline');

        $this->hasPcntl = ProcessForker::isSupported();

        if ($configFile = $this->getConfigFile()) {

            $this->loadConfigFile($configFile);

        }

        if (!$this->configFile && $localConfig = $this->getLocalConfigFile()) {

            $this->loadConfigFile($localConfig);

        }

        $this->configPaths->overrideDirs([

            'configDir'  => $this->configDir,

            'dataDir'    => $this->dataDir,

            'runtimeDir' => $this->runtimeDir,

        ]);

    }

    /**

     * Get the current PsySH config file.

     *

     * If a `configFile` option was passed to the Configuration constructor,

     * this file will be returned. If not, all possible config directories will

     * be searched, and the first `config.php` or `rc.php` file which exists

     * will be returned.

     *

     * If you're trying to decide where to put your config file, pick

     *

     *     ~/.config/psysh/config.php

     *

     * @return string|null

     */

    public function getConfigFile()

    {

        if (isset($this->configFile)) {

            return $this->configFile;

        }

        $files = $this->configPaths->configFiles(['config.php', 'rc.php']);

        if (!empty($files)) {

            if ($this->warnOnMultipleConfigs && \count($files) > 1) {

                $msg = \sprintf('Multiple configuration files found: %s. Using %s', \implode(', ', $files), $files[0]);

                \trigger_error($msg, \E_USER_NOTICE);

            }

            return $files[0];

        }

    }

    /**

     * Get the local PsySH config file.

     *

     * Searches for a project specific config file `.psysh.php` in the current

     * working directory.

     *

     * @return string|null

     */

    public function getLocalConfigFile()

    {

        $localConfig = \getcwd().'/.psysh.php';

        if (@\is_file($localConfig)) {

            return $localConfig;

        }

    }

    /**

     * Load configuration values from an array of options.

     *

     * @param array $options

     */

    public function loadConfig(array $options)

    {

        foreach (self::$AVAILABLE_OPTIONS as $option) {

            if (isset($options[$option])) {

                $method = 'set'.\ucfirst($option);

                $this->$method($options[$option]);

            }

        }

        // legacy `tabCompletion` option

        if (isset($options['tabCompletion'])) {

            $msg = '`tabCompletion` is deprecated; use `useTabCompletion` instead.';

            @\trigger_error($msg, \E_USER_DEPRECATED);

            $this->setUseTabCompletion($options['tabCompletion']);

        }

        foreach (['commands', 'matchers', 'casters'] as $option) {

            if (isset($options[$option])) {

                $method = 'add'.\ucfirst($option);

                $this->$method($options[$option]);

            }

        }

        // legacy `tabCompletionMatchers` option

        if (isset($options['tabCompletionMatchers'])) {

            $msg = '`tabCompletionMatchers` is deprecated; use `matchers` instead.';

            @\trigger_error($msg, \E_USER_DEPRECATED);

            $this->addMatchers($options['tabCompletionMatchers']);

        }

    }

    /**

     * Load a configuration file (default: `$HOME/.config/psysh/config.php`).

     *

     * This configuration instance will be available to the config file as $config.

     * The config file may directly manipulate the configuration, or may return

     * an array of options which will be merged with the current configuration.

     *

     * @throws \InvalidArgumentException if the config file does not exist or returns a non-array result

     *

     * @param string $file

     */

    public function loadConfigFile(string $file)

    {

        if (!\is_file($file)) {

            throw new \InvalidArgumentException(\sprintf('Invalid configuration file specified, %s does not exist', $file));

        }

        $__psysh_config_file__ = $file;

        $load = function ($config) use ($__psysh_config_file__) {

            $result = require $__psysh_config_file__;

            if ($result !== 1) {

                return $result;

            }

        };

        $result = $load($this);

        if (!empty($result)) {

            if (\is_array($result)) {

                $this->loadConfig($result);

            } else {

                throw new \InvalidArgumentException('Psy Shell configuration must return an array of options');

            }

        }

    }

    /**

     * Set files to be included by default at the start of each shell session.

     *

     * @param array $includes

     */

    public function setDefaultIncludes(array $includes = [])

    {

        $this->defaultIncludes = $includes;

    }

    /**

     * Get files to be included by default at the start of each shell session.

     *

     * @return array

     */

    public function getDefaultIncludes(): array

    {

        return $this->defaultIncludes ?: [];

    }

    /**

     * Set the shell's config directory location.

     *

     * @param string $dir

     */

    public function setConfigDir(string $dir)

    {

        $this->configDir = (string) $dir;

        $this->configPaths->overrideDirs([

            'configDir'  => $this->configDir,

            'dataDir'    => $this->dataDir,

            'runtimeDir' => $this->runtimeDir,

        ]);

    }

    /**

     * Get the current configuration directory, if any is explicitly set.

     *

     * @return string|null

     */

    public function getConfigDir()

    {

        return $this->configDir;

    }

    /**

     * Set the shell's data directory location.

     *

     * @param string $dir

     */

    public function setDataDir(string $dir)

    {

        $this->dataDir = (string) $dir;

        $this->configPaths->overrideDirs([

            'configDir'  => $this->configDir,

            'dataDir'    => $this->dataDir,

            'runtimeDir' => $this->runtimeDir,

        ]);

    }

    /**

     * Get the current data directory, if any is explicitly set.

     *

     * @return string|null

     */

    public function getDataDir()

    {

        return $this->dataDir;

    }

    /**

     * Set the shell's temporary directory location.

     *

     * @param string $dir

     */

    public function setRuntimeDir(string $dir)

    {

        $this->runtimeDir = (string) $dir;

        $this->configPaths->overrideDirs([

            'configDir'  => $this->configDir,

            'dataDir'    => $this->dataDir,

            'runtimeDir' => $this->runtimeDir,

        ]);

    }

    /**

     * Get the shell's temporary directory location.

     *

     * Defaults to  `/psysh` inside the system's temp dir unless explicitly

     * overridden.

     *

     * @throws RuntimeException if no temporary directory is set and it is not possible to create one

     *

     * @return string

     */

    public function getRuntimeDir(): string

    {

        $runtimeDir = $this->configPaths->runtimeDir();

        if (!\is_dir($runtimeDir)) {

            if (!@\mkdir($runtimeDir, 0700, true)) {

                throw new RuntimeException(\sprintf('Unable to create PsySH runtime directory. Make sure PHP is able to write to %s in order to continue.', \dirname($runtimeDir)));

            }

        }

        return $runtimeDir;

    }

    /**

     * Set the readline history file path.

     *

     * @param string $file

     */

    public function setHistoryFile(string $file)

    {

        $this->historyFile = ConfigPaths::touchFileWithMkdir($file);

    }

    /**

     * Get the readline history file path.

     *

     * Defaults to `/history` inside the shell's base config dir unless

     * explicitly overridden.

     *

     * @return string

     */

    public function getHistoryFile(): string

    {

        if (isset($this->historyFile)) {

            return $this->historyFile;

        }

        $files = $this->configPaths->configFiles(['psysh_history', 'history']);

        if (!empty($files)) {

            if ($this->warnOnMultipleConfigs && \count($files) > 1) {

                $msg = \sprintf('Multiple history files found: %s. Using %s', \implode(', ', $files), $files[0]);

                \trigger_error($msg, \E_USER_NOTICE);

            }

            $this->setHistoryFile($files[0]);

        } else {

            // fallback: create our own history file

            $this->setHistoryFile($this->configPaths->currentConfigDir().'/psysh_history');

        }

        return $this->historyFile;

    }

    /**

     * Set the readline max history size.

     *

     * @param int $value

     */

    public function setHistorySize(int $value)

    {

        $this->historySize = (int) $value;

    }

    /**

     * Get the readline max history size.

     *

     * @return int

     */

    public function getHistorySize()

    {

        return $this->historySize;

    }

    /**

     * Sets whether readline erases old duplicate history entries.

     *

     * @param bool $value

     */

    public function setEraseDuplicates(bool $value)

    {

        $this->eraseDuplicates = (bool) $value;

    }

    /**

     * Get whether readline erases old duplicate history entries.

     *

     * @return bool|null

     */

    public function getEraseDuplicates()

    {

        return $this->eraseDuplicates;

    }

    /**

     * Get a temporary file of type $type for process $pid.

     *

     * The file will be created inside the current temporary directory.

     *

     * @see self::getRuntimeDir

     *

     * @param string $type

     * @param int    $pid

     *

     * @return string Temporary file name

     */

    public function getTempFile(string $type, int $pid): string

    {

        return \tempnam($this->getRuntimeDir(), $type.'_'.$pid.'_');

    }

    /**

     * Get a filename suitable for a FIFO pipe of $type for process $pid.

     *

     * The pipe will be created inside the current temporary directory.

     *

     * @param string $type

     * @param int    $pid

     *

     * @return string Pipe name

     */

    public function getPipe(string $type, int $pid): string

    {

        return \sprintf('%s/%s_%s', $this->getRuntimeDir(), $type, $pid);

    }

    /**

     * Check whether this PHP instance has Readline available.

     *

     * @return bool True if Readline is available

     */

    public function hasReadline(): bool

    {

        return $this->hasReadline;

    }

    /**

     * Enable or disable Readline usage.

     *

     * @param bool $useReadline

     */

    public function setUseReadline(bool $useReadline)

    {

        $this->useReadline = (bool) $useReadline;

    }

    /**

     * Check whether to use Readline.

     *

     * If `setUseReadline` as been set to true, but Readline is not actually

     * available, this will return false.

     *

     * @return bool True if the current Shell should use Readline

     */

    public function useReadline(): bool

    {

        return isset($this->useReadline) ? ($this->hasReadline && $this->useReadline) : $this->hasReadline;

    }

    /**

     * Set the Psy Shell readline service.

     *

     * @param Readline\Readline $readline

     */

    public function setReadline(Readline\Readline $readline)

    {

        $this->readline = $readline;

    }

    /**

     * Get the Psy Shell readline service.

     *

     * By default, this service uses (in order of preference):

     *

     *  * GNU Readline

     *  * Libedit

     *  * A transient array-based readline emulation.

     *

     * @return Readline\Readline

     */

    public function getReadline(): Readline\Readline

    {

        if (!isset($this->readline)) {

            $className = $this->getReadlineClass();

            $this->readline = new $className(

                $this->getHistoryFile(),

                $this->getHistorySize(),

                $this->getEraseDuplicates()

            );

        }

        return $this->readline;

    }

    /**

     * Get the appropriate Readline implementation class name.

     *

     * @see self::getReadline

     *

     * @return string

     */

    private function getReadlineClass(): string

    {

        if ($this->useReadline()) {

            if (Readline\GNUReadline::isSupported()) {

                return Readline\GNUReadline::class;

            } elseif (Readline\Libedit::isSupported()) {

                return Readline\Libedit::class;

            }

        }

        if (Readline\Userland::isSupported()) {

            return Readline\Userland::class;

        }

        return Readline\Transient::class;

    }

    /**

     * Enable or disable bracketed paste.

     *

     * Note that this only works with readline (not libedit) integration for now.

     *

     * @param bool $useBracketedPaste

     */

    public function setUseBracketedPaste(bool $useBracketedPaste)

    {

        $this->useBracketedPaste = (bool) $useBracketedPaste;

    }

    /**

     * Check whether to use bracketed paste with readline.

     *

     * When this works, it's magical. Tabs in pastes don't try to autcomplete.

     * Newlines in paste don't execute code until you get to the end. It makes

     * readline act like you'd expect when pasting.

     *

     * But it often (usually?) does not work. And when it doesn't, it just spews

     * escape codes all over the place and generally makes things ugly :(

     *

     * If `useBracketedPaste` has been set to true, but the current readline

     * implementation is anything besides GNU readline, this will return false.

     *

     * @return bool True if the shell should use bracketed paste

     */

    public function useBracketedPaste(): bool

    {

        $readlineClass = $this->getReadlineClass();

        return $this->useBracketedPaste && $readlineClass::supportsBracketedPaste();

        // @todo mebbe turn this on by default some day?

        // return $readlineClass::supportsBracketedPaste() && $this->useBracketedPaste !== false;

    }

    /**

     * Check whether this PHP instance has Pcntl available.

     *

     * @return bool True if Pcntl is available

     */

    public function hasPcntl(): bool

    {

        return $this->hasPcntl;

    }

    /**

     * Enable or disable Pcntl usage.

     *

     * @param bool $usePcntl

     */

    public function setUsePcntl(bool $usePcntl)

    {

        $this->usePcntl = (bool) $usePcntl;

    }

    /**

     * Check whether to use Pcntl.

     *

     * If `setUsePcntl` has been set to true, but Pcntl is not actually

     * available, this will return false.

     *

     * @return bool True if the current Shell should use Pcntl

     */

    public function usePcntl(): bool

    {

        if (!isset($this->usePcntl)) {

            // Unless pcntl is explicitly *enabled*, don't use it while XDebug is debugging.

            // See https://github.com/bobthecow/psysh/issues/742

            if (\function_exists('xdebug_is_debugger_active') && \xdebug_is_debugger_active()) {

                return false;

            }

            return $this->hasPcntl;

        }

        return $this->hasPcntl && $this->usePcntl;

    }

    /**

     * Check whether to use raw output.

     *

     * This is set by the --raw-output (-r) flag, and really only makes sense

     * when non-interactive, e.g. executing stdin.

     *

     * @return bool true if raw output is enabled

     */

    public function rawOutput(): bool

    {

        return $this->rawOutput;

    }

    /**

     * Enable or disable raw output.

     *

     * @param bool $rawOutput

     */

    public function setRawOutput(bool $rawOutput)

    {

        $this->rawOutput = (bool) $rawOutput;

    }

    /**

     * Enable or disable strict requirement of semicolons.

     *

     * @see self::requireSemicolons()

     *

     * @param bool $requireSemicolons

     */

    public function setRequireSemicolons(bool $requireSemicolons)

    {

        $this->requireSemicolons = (bool) $requireSemicolons;

    }

    /**

     * Check whether to require semicolons on all statements.

     *

     * By default, PsySH will automatically insert semicolons at the end of

     * statements if they're missing. To strictly require semicolons, set

     * `requireSemicolons` to true.

     *

     * @return bool

     */

    public function requireSemicolons(): bool

    {

        return $this->requireSemicolons;

    }

    /**

     * Enable or disable Unicode in PsySH specific output.

     *

     * Note that this does not disable Unicode output in general, it just makes

     * it so PsySH won't output any itself.

     *

     * @param bool $useUnicode

     */

    public function setUseUnicode(bool $useUnicode)

    {

        $this->useUnicode = (bool) $useUnicode;

    }

    /**

     * Check whether to use Unicode in PsySH specific output.

     *

     * Note that this does not disable Unicode output in general, it just makes

     * it so PsySH won't output any itself.

     *

     * @return bool

     */

    public function useUnicode(): bool

    {

        if (isset($this->useUnicode)) {

            return $this->useUnicode;

        }

        // @todo detect `chsh` != 65001 on Windows and return false