psalm/src/Psalm/FileManipulation.php

<?php
namespace Psalm;

class FileManipulation
{
    /** @var int */
    public $start;

    /** @var int */
    public $end;

    /** @var string */
    public $insertion_text;

    /** @var bool */
    public $preserve_indentation;

    /**
     * @param int $start
     * @param int $end
     * @param string $insertion_text
     */
    public function __construct(int $start, int $end, string $insertion_text, bool $preserve_indentation = false)
    {
        $this->start = $start;
        $this->end = $end;
        $this->insertion_text = $insertion_text;
        $this->preserve_indentation = $preserve_indentation;
    }

    public function getKey() : string
    {
        return sha1($this->start . ':' . $this->insertion_text);
    }

    public function transform(string $existing_contents) : string
    {
        if ($this->preserve_indentation) {
            $newline_pos = strrpos($existing_contents, "\n", $this->start - strlen($existing_contents));

            $newline_pos = $newline_pos !== false ? $newline_pos + 1 : 0;

            $indentation = substr($existing_contents, $newline_pos, $this->start - $newline_pos);

            if (trim($indentation) === '') {
                $this->insertion_text = $this->insertion_text . $indentation;
            }
        }

        return substr($existing_contents, 0, $this->start)
            . $this->insertion_text
            . substr($existing_contents, $this->end);
    }
}