1
0
mirror of https://github.com/danog/psalm.git synced 2024-12-13 17:57:37 +01:00
psalm/src/Psalm/CodeLocation.php

386 lines
10 KiB
PHP
Raw Normal View History

<?php
namespace Psalm;
2018-09-29 06:15:39 +02:00
use PhpParser;
2018-11-06 03:57:36 +01:00
use Psalm\Internal\Analyzer\CommentAnalyzer;
class CodeLocation
{
/** @var string */
public $file_path;
/** @var string */
public $file_name;
/** @var int */
2018-09-29 06:15:39 +02:00
protected $line_number;
2016-12-08 04:38:57 +01:00
/** @var int */
private $end_line_number = -1;
2016-12-08 04:38:57 +01:00
/** @var int */
2018-09-29 06:15:39 +02:00
protected $file_start;
2016-12-08 04:38:57 +01:00
/** @var int */
2018-09-29 06:15:39 +02:00
protected $file_end;
/** @var bool */
2018-09-29 06:15:39 +02:00
protected $single_line;
/** @var int */
2018-09-29 06:15:39 +02:00
protected $preview_start;
2016-12-08 04:38:57 +01:00
/** @var int */
private $preview_end = -1;
2016-12-08 04:38:57 +01:00
/** @var int */
private $selection_start = -1;
2016-12-08 04:38:57 +01:00
/** @var int */
private $selection_end = -1;
2016-12-08 04:38:57 +01:00
2017-01-16 04:39:26 +01:00
/** @var int */
private $column_from = -1;
/** @var int */
private $column_to = -1;
2017-01-16 04:39:26 +01:00
2016-12-08 04:38:57 +01:00
/** @var string */
private $snippet = '';
/** @var null|string */
private $text;
/** @var int|null */
private $docblock_start_line_number;
/** @var int|null */
private $docblock_line_number;
/** @var null|int */
private $regex_type;
2016-12-08 04:38:57 +01:00
2017-05-27 02:16:18 +02:00
/** @var bool */
2016-12-08 04:38:57 +01:00
private $have_recalculated = false;
/** @var null|CodeLocation */
public $previous_location;
const VAR_TYPE = 0;
const FUNCTION_RETURN_TYPE = 1;
const FUNCTION_PARAM_TYPE = 2;
const FUNCTION_PHPDOC_RETURN_TYPE = 3;
const FUNCTION_PHPDOC_PARAM_TYPE = 4;
const FUNCTION_PARAM_VAR = 5;
const CATCH_VAR = 6;
const FUNCTION_PHPDOC_METHOD = 7;
/**
2018-01-28 23:07:09 +01:00
* @param bool $single_line
* @param null|CodeLocation $previous_location
* @param null|int $regex_type
2018-01-28 23:07:09 +01:00
* @param null|string $selected_text
*/
2016-12-08 04:38:57 +01:00
public function __construct(
2018-01-21 18:44:46 +01:00
FileSource $file_source,
2018-09-29 06:15:39 +02:00
PhpParser\Node $stmt,
CodeLocation $previous_location = null,
2016-12-08 04:38:57 +01:00
$single_line = false,
$regex_type = null,
$selected_text = null
2016-12-08 04:38:57 +01:00
) {
$this->file_start = (int)$stmt->getAttribute('startFilePos');
$this->file_end = (int)$stmt->getAttribute('endFilePos');
$this->file_path = $file_source->getFilePath();
$this->file_name = $file_source->getFileName();
$this->single_line = $single_line;
$this->regex_type = $regex_type;
$this->previous_location = $previous_location;
$this->text = $selected_text;
$doc_comment = $stmt->getDocComment();
$this->preview_start = $doc_comment ? $doc_comment->getFilePos() : $this->file_start;
$this->docblock_start_line_number = $doc_comment ? $doc_comment->getLine() : null;
$this->line_number = $stmt->getLine();
}
/**
* @param int $line
2017-05-27 02:16:18 +02:00
*
* @return void
*/
public function setCommentLine($line)
{
$this->docblock_line_number = $line;
2016-12-08 04:38:57 +01:00
}
/**
* @psalm-suppress MixedArrayAccess
2017-05-27 02:16:18 +02:00
*
2016-12-08 04:38:57 +01:00
* @return void
*/
private function calculateRealLocation()
{
if ($this->have_recalculated) {
return;
}
$this->have_recalculated = true;
2016-12-08 04:38:57 +01:00
$this->selection_start = $this->file_start;
$this->selection_end = $this->file_end + 1;
2016-12-08 04:38:57 +01:00
2018-11-11 18:01:14 +01:00
$project_analyzer = Internal\Analyzer\ProjectAnalyzer::getInstance();
2016-12-08 04:38:57 +01:00
2018-11-11 18:01:14 +01:00
$codebase = $project_analyzer->getCodebase();
2018-11-06 03:57:36 +01:00
$file_contents = $codebase->getFileContents($this->file_path);
2016-12-08 04:38:57 +01:00
$file_length = strlen($file_contents);
$search_limit = $this->single_line ? $this->selection_start : $this->selection_end;
if ($search_limit <= $file_length) {
$preview_end = strpos(
$file_contents,
"\n",
$search_limit
);
} else {
$preview_end = false;
}
2016-12-08 04:38:57 +01:00
// if the string didn't contain a newline
if ($preview_end === false) {
$preview_end = $this->selection_end;
}
$this->preview_end = $preview_end;
if ($this->docblock_line_number &&
$this->docblock_start_line_number &&
$this->preview_start < $this->selection_start
) {
2016-12-08 04:38:57 +01:00
$preview_lines = explode(
"\n",
substr(
$file_contents,
$this->preview_start,
$this->selection_start - $this->preview_start - 1
)
);
$preview_offset = 0;
$comment_line_offset = $this->docblock_line_number - $this->docblock_start_line_number;
2016-12-08 04:38:57 +01:00
2017-05-27 02:05:57 +02:00
for ($i = 0; $i < $comment_line_offset; ++$i) {
2016-12-08 04:38:57 +01:00
$preview_offset += strlen($preview_lines[$i]) + 1;
}
if (!isset($preview_lines[$i])) {
throw new \Exception('Should have offset');
}
$key_line = $preview_lines[$i];
2016-12-08 04:38:57 +01:00
$indentation = (int)strpos($key_line, '@');
$key_line = trim(preg_replace('@\**/\s*@', '', substr($key_line, $indentation)));
$this->selection_start = $preview_offset + $indentation + $this->preview_start;
$this->selection_end = $this->selection_start + strlen($key_line);
}
if ($this->regex_type !== null) {
switch ($this->regex_type) {
case self::VAR_TYPE:
2018-11-06 03:57:36 +01:00
$regex = '/@(psalm-)?var[ \t]+' . CommentAnalyzer::TYPE_REGEX . '/';
$match_offset = 2;
break;
case self::FUNCTION_RETURN_TYPE:
$regex = '/\\:\s+(\\??\s*[A-Za-z0-9_\\\\\[\]]+)/';
$match_offset = 1;
break;
case self::FUNCTION_PARAM_TYPE:
$regex = '/^(\\??\s*[A-Za-z0-9_\\\\\[\]]+)\s/';
$match_offset = 1;
break;
case self::FUNCTION_PHPDOC_RETURN_TYPE:
2018-11-06 03:57:36 +01:00
$regex = '/@(psalm-)?return[ \t]+' . CommentAnalyzer::TYPE_REGEX . '/';
$match_offset = 2;
break;
case self::FUNCTION_PHPDOC_METHOD:
$regex = '/@(psalm-)method[ \t]+.*/';
$match_offset = 2;
break;
case self::FUNCTION_PHPDOC_PARAM_TYPE:
2018-11-06 03:57:36 +01:00
$regex = '/@(psalm-)?param[ \t]+' . CommentAnalyzer::TYPE_REGEX . '/';
$match_offset = 2;
break;
case self::FUNCTION_PARAM_VAR:
$regex = '/(\$[^ ]*)/';
$match_offset = 1;
break;
case self::CATCH_VAR:
$regex = '/(\$[^ ^\)]*)/';
$match_offset = 1;
break;
default:
throw new \UnexpectedValueException('Unrecognised regex type ' . $this->regex_type);
}
2016-12-08 04:38:57 +01:00
$preview_snippet = substr(
$file_contents,
$this->selection_start,
$this->selection_end - $this->selection_start
);
if ($this->text) {
2018-11-01 17:39:48 +01:00
$regex = '/(' . str_replace(',', ',[ ]*', preg_quote($this->text, '/')) . ')/';
$match_offset = 1;
}
if (preg_match($regex, $preview_snippet, $matches, PREG_OFFSET_CAPTURE)) {
$this->selection_start = $this->selection_start + (int)$matches[$match_offset][1];
$this->selection_end = $this->selection_start + strlen((string)$matches[$match_offset][0]);
2016-12-08 04:38:57 +01:00
}
}
// reset preview start to beginning of line
$this->preview_start = (int)strrpos(
$file_contents,
"\n",
min($this->preview_start, $this->selection_start) - strlen($file_contents)
) + 1;
$this->selection_start = max($this->preview_start, $this->selection_start);
$this->selection_end = min($this->preview_end, $this->selection_end);
2017-01-28 06:39:16 +01:00
if ($this->preview_end - $this->selection_end > 200) {
$this->preview_end = (int)strrpos(
$file_contents,
"\n",
$this->selection_end + 200 - strlen($file_contents)
);
2017-02-08 07:39:49 +01:00
// if the line is over 200 characters long
if ($this->preview_end < $this->selection_end) {
$this->preview_end = $this->selection_end + 50;
}
2017-01-28 06:39:16 +01:00
}
2018-03-29 16:26:26 +02:00
$this->snippet = substr($file_contents, $this->preview_start, $this->preview_end - $this->preview_start);
$this->text = substr($file_contents, $this->selection_start, $this->selection_end - $this->selection_start);
2017-01-16 04:39:26 +01:00
// reset preview start to beginning of line
$this->column_from = $this->selection_start -
2017-01-16 04:39:26 +01:00
(int)strrpos($file_contents, "\n", $this->selection_start - strlen($file_contents));
2018-03-29 16:26:26 +02:00
$newlines = substr_count($this->text, "\n");
2018-03-29 16:26:26 +02:00
if ($newlines) {
$this->column_to = $this->selection_end -
(int)strrpos($file_contents, "\n", $this->selection_end - strlen($file_contents));
} else {
$this->column_to = $this->column_from + strlen($this->text);
}
2018-03-29 16:26:26 +02:00
$this->end_line_number = $this->getLineNumber() + $newlines;
2016-12-08 04:38:57 +01:00
}
/**
* @return int
*/
public function getLineNumber()
{
return $this->docblock_line_number ?: $this->line_number;
2016-12-08 04:38:57 +01:00
}
/**
* @return int
*/
public function getEndLineNumber()
{
$this->calculateRealLocation();
return $this->end_line_number;
}
2016-12-08 04:38:57 +01:00
/**
* @return string
*/
public function getSnippet()
{
$this->calculateRealLocation();
return $this->snippet;
}
/**
* @return string
*/
public function getSelectedText()
{
$this->calculateRealLocation();
return (string)$this->text;
}
2017-01-16 04:39:26 +01:00
/**
* @return int
*/
public function getColumn()
{
$this->calculateRealLocation();
return $this->column_from;
}
/**
* @return int
*/
public function getEndColumn()
{
$this->calculateRealLocation();
return $this->column_to;
2017-01-16 04:39:26 +01:00
}
2016-12-08 04:38:57 +01:00
/**
* @return array<int, int>
*/
public function getSelectionBounds()
{
$this->calculateRealLocation();
return [$this->selection_start, $this->selection_end];
}
/**
* @return array<int, int>
*/
public function getSnippetBounds()
{
$this->calculateRealLocation();
return [$this->preview_start, $this->preview_end];
}
2018-06-17 02:01:33 +02:00
/**
* @return string
*/
public function getHash()
{
return (string) $this->file_start;
}
}