respect-validation/src-dev/Spdx/ContributorExtractor/GitLogContributorExtractor.php
Henrique Moody 7db3bea8a6
Enhance LintSpdxCommand with contributor tracking and header normalization
Improves SPDX header linting to ensure consistent license metadata across
the codebase.

Key changes:

- Enforce deterministic tag ordering (License-Identifier, FileCopyrightText,
  FileContributor) to ensure consistency, prevent merge conflicts, and
  simplify code reviews

- Add contributor alias mapping to consolidate contributors with multiple
  emails or name variations (e.g., "nickl-" → "Nick Lombard")

- Add --contributions-strategy option with "blame" (current code authors)
  and "log" (all historical contributors) to support different attribution
  philosophies

- Add optional path argument to lint specific files or directories

- Add --fix option to automatically correct header issues

Assisted-by: Claude Code (claude-opus-4-5-20251101)
2026-02-03 15:23:20 +01:00

52 lines
1.3 KiB
PHP

<?php
/*
* SPDX-License-Identifier: MIT
* SPDX-FileCopyrightText: (c) Respect Project Contributors
* SPDX-FileContributor: Henrique Moody <henriquemoody@gmail.com>
*/
declare(strict_types=1);
namespace Respect\Dev\Spdx\ContributorExtractor;
use Respect\Dev\Spdx\Contributor;
use Symfony\Component\Process\Process;
use function explode;
use function preg_match;
use function trim;
final class GitLogContributorExtractor implements ContributorExtractor
{
/** @return array<Contributor> */
public function extract(string $filepath): array
{
$process = new Process(['git', 'log', '--follow', '--format=%aN <%aE>', $filepath]);
$process->run();
if (!$process->isSuccessful()) {
return [];
}
$contributors = [];
foreach (explode("\n", trim($process->getOutput())) as $line) {
if ($line === '') {
continue;
}
preg_match('/^(.+) <(.+)>$/', $line, $matches);
$name = $matches[1] ?? '';
$email = $matches[2] ?? '';
if ($email === '' || $name === 'Not Committed Yet') {
continue;
}
$contributors[] = Contributor::create($name, $email);
}
return $contributors;
}
}