Current File : //vendor/psy/psysh/src/Readline/Interactive/Input/StatementCompletenessPolicy.php
<?php
/*
* This file is part of Psy Shell.
*
* (c) 2012-2026 Justin Hileman
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Psy\Readline\Interactive\Input;
use PhpParser\Error;
use Psy\CodeAnalysis\BufferAnalyzer;
/**
* Determines whether a buffer is ready to execute as a statement.
*/
class StatementCompletenessPolicy
{
private BufferAnalyzer $bufferAnalyzer;
private bool $requireSemicolons;
public function __construct(BufferAnalyzer $bufferAnalyzer, bool $requireSemicolons = false)
{
$this->bufferAnalyzer = $bufferAnalyzer;
$this->requireSemicolons = $requireSemicolons;
}
public function isCompleteStatement(string $line): bool
{
if ($line === '') {
return true;
}
$analysis = $this->bufferAnalyzer->analyze($line);
$lastError = $analysis->getLastError();
// Control structures like `if (...)` are incomplete in REPL context.
if ($analysis->hasControlStructureWithoutBody()) {
return false;
}
if ($lastError === null) {
if (!$analysis->hasBalancedBrackets()) {
return false;
}
if ($analysis->hasTrailingOperator()) {
return false;
}
return true;
}
if (!$this->requireSemicolons && $analysis->hasEOFError()) {
if ($this->bufferAnalyzer->canBeFixedWithSemicolon($line)) {
return true;
}
}
if ($this->isUnterminatedComment($lastError) || $this->isUnclosedString($lastError)) {
return false;
}
if (!$analysis->hasEOFError()) {
// Real syntax errors should execute immediately so the user sees them.
return true;
}
return false;
}
/**
* Check whether the buffer has a non-EOF parse error that isn't recoverable
* by adding more input (e.g. extra closing brackets, invalid syntax).
*/
public function hasUnrecoverableSyntaxError(string $line): bool
{
if ($line === '') {
return false;
}
$analysis = $this->bufferAnalyzer->analyze($line);
$lastError = $analysis->getLastError();
if ($lastError === null) {
return false;
}
if ($analysis->hasEOFError()) {
return false;
}
if ($this->isUnterminatedComment($lastError) || $this->isUnclosedString($lastError)) {
return false;
}
// Control structures without body aren't syntax errors, they're incomplete.
if ($analysis->hasControlStructureWithoutBody()) {
return false;
}
return true;
}
public function hasBalancedBrackets(string $line): bool
{
return $this->bufferAnalyzer->analyze($line)->hasBalancedBrackets();
}
private function isUnterminatedComment(Error $error): bool
{
return $error->getRawMessage() === 'Unterminated comment';
}
private function isUnclosedString(Error $error): bool
{
$msg = $error->getRawMessage();
return $msg === 'Syntax error, unexpected T_ENCAPSED_AND_WHITESPACE' ||
\strpos($msg, 'Unterminated string') !== false;
}
}
Mini Shell