tikiwiki/packages/tiki-pkg-tikimanager/gitonomy/gitlib/doc/blame.md
2023-11-20 20:52:04 +00:00

1.3 KiB
Executable File

Blaming files

Line-per-line iteration

To iterate on lines of a blame:

$blame = $repository->getBlame('master', 'README.md');

foreach ($blame->getLines() as $lineNumber => $line) {
    $commit = $line->getCommit();
    echo $lineNumber.': '.$line->getContent().'    - '.$commit->getAuthorName().PHP_EOL;
}

The getLines method returns an array indexed starting from 1.

As you can see, you can access the commit object related to the line you are iterating on.

If you want to access directly a line:

$line = $blame->getLine(32);

The Line object

LineObject represents an item of the blame file. It is composed of those informations:

$line->getCommit();  // returns a Commit
$line->getContent(); // returns text

// you can access author from commmit:
$author = $line->getCommit()->getAuthorName();

Group reading by commit

If you plan to display it, you'll probably need a version where lines from same commit are grouped.

To do so, use the getGroupedLines method that will return an array like this:

$blame = array(
    array(Commit, array(1 => Line, 2 => Line, 3 => Line)),
    array(Commit, array(4 => Line)),
    array(Commit, array(5 => Line, 6 => Line))
)