janniclas.loosenandClaude Opus 5.5
6b93df94c3
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
100 lines
3.5 KiB
PHP
100 lines
3.5 KiB
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace LIT\MCP\Integrations\Divi\Release;
|
||
|
||
use RuntimeException;
|
||
|
||
defined('ABSPATH') || exit;
|
||
|
||
/**
|
||
* The expected fingerprints of the mirrors (fingerprints.json, shipped with the plugin) and their reference sources
|
||
* (tests/Fixtures/divi/reference/<id>.txt, development only – not in the plugin package). Written by
|
||
* wp lit-mcp divi-check --update-reference.
|
||
*/
|
||
final class DiviReference
|
||
{
|
||
public const FILE = __DIR__ . '/fingerprints.json';
|
||
|
||
/** @return array<string, string> Mirror ID => sha256; [] when the file is missing or broken. */
|
||
public static function expected(?string $file = null): array
|
||
{
|
||
$file ??= self::FILE;
|
||
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- local plugin file.
|
||
$raw = is_file($file) && is_readable($file) ? file_get_contents($file) : false;
|
||
$data = is_string($raw) ? json_decode($raw, true) : null;
|
||
if (! is_array($data)) {
|
||
return [];
|
||
}
|
||
|
||
$expected = [];
|
||
foreach ($data as $id => $hash) {
|
||
if (is_string($id) && is_string($hash)) {
|
||
$expected[$id] = $hash;
|
||
}
|
||
}
|
||
ksort($expected);
|
||
|
||
return $expected;
|
||
}
|
||
|
||
/**
|
||
* @param array<string, string> $hashes Mirror ID => sha256.
|
||
* @throws RuntimeException
|
||
*/
|
||
public static function writeExpected(array $hashes, ?string $file = null): void
|
||
{
|
||
ksort($hashes);
|
||
// phpcs:ignore WordPress.WP.AlternativeFunctions.json_encode_json_encode -- pure PHP, no WordPress.
|
||
$json = json_encode($hashes, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
|
||
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_file_put_contents -- dev fixture.
|
||
if (! is_string($json) || file_put_contents($file ?? self::FILE, $json . "\n") === false) {
|
||
throw new RuntimeException('fingerprints.json not written');
|
||
}
|
||
}
|
||
|
||
/** tests/Fixtures/divi/reference of a development checkout; null in an installed plugin. */
|
||
public static function sourceDir(): ?string
|
||
{
|
||
$dir = dirname(__DIR__, 4) . '/tests/Fixtures/divi/reference';
|
||
|
||
return is_dir($dir) ? $dir : null;
|
||
}
|
||
|
||
public static function readSource(string $id, string $dir): ?string
|
||
{
|
||
$file = $dir . '/' . $id . '.txt';
|
||
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- local dev fixture.
|
||
$source = is_file($file) ? file_get_contents($file) : false;
|
||
|
||
return is_string($source) ? $source : null;
|
||
}
|
||
|
||
/** @throws RuntimeException */
|
||
public static function writeSource(string $id, string $source, string $dir): void
|
||
{
|
||
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_file_put_contents -- dev fixture.
|
||
if (file_put_contents($dir . '/' . $id . '.txt', $source . "\n") === false) {
|
||
throw new RuntimeException(sprintf('reference source %s not written', $id));
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Fingerprints of every mirror in the installed Divi.
|
||
*
|
||
* @return array<string, SourceFingerprint>
|
||
* @throws RuntimeException When a mirrored function cannot be read.
|
||
*/
|
||
public static function current(string $themeDir): array
|
||
{
|
||
$prints = [];
|
||
foreach (DiviAdapters::mirrors() as $mirror) {
|
||
$file = $themeDir . '/' . $mirror->file;
|
||
$prints[$mirror->id] = SourceFingerprint::of($file, $mirror->function, $mirror->class);
|
||
}
|
||
|
||
return $prints;
|
||
}
|
||
}
|