propresenter-php/bin/parse-macros.php
Thorsten Bus b30918af41 feat(macros): add reader for global Macros file
Importer for ProPresenter's protobuf-encoded `Macros` document. Exposes
each macro's UUID and name plus the collections that group them.

- src/MacroLibrary.php: top-level wrapper indexed by UUID and name
- src/Macro.php, src/MacroCollection.php: per-entry wrappers
- src/MacrosFileReader.php: file -> MacroLibrary entry point
- bin/parse-macros.php: CLI listing macros and collections
- tests/MacrosFileReaderTest.php: 10 tests against reference sample
- doc/api/macros.md: API reference, plus INDEX/keywords updates
2026-05-03 20:38:47 +02:00

67 lines
2 KiB
PHP
Executable file

#!/usr/bin/env php
<?php
declare(strict_types=1);
require __DIR__ . '/../vendor/autoload.php';
use ProPresenter\Parser\MacrosFileReader;
if ($argc < 2) {
echo "Usage: parse-macros.php <Macros>\n";
exit(1);
}
$filePath = $argv[1];
try {
$library = MacrosFileReader::read($filePath);
} catch (Exception $e) {
echo "Error: " . $e->getMessage() . "\n";
exit(1);
}
$macros = $library->getMacros();
$collections = $library->getCollections();
echo "Macros (" . count($macros) . "):\n";
foreach ($macros as $index => $macro) {
$number = $index + 1;
$name = $macro->getName();
$uuid = $macro->getUuid();
$actionCount = $macro->getActionCount();
$startup = $macro->getTriggerOnStartup() ? ' (startup)' : '';
$memberships = $library->getCollectionsForMacro($macro);
$collectionNames = array_map(fn ($c) => $c->getName(), $memberships);
$collectionSuffix = $collectionNames === [] ? '' : ' [in: ' . implode(', ', $collectionNames) . ']';
$displayName = $name === '' ? '(unnamed)' : $name;
echo " [" . $number . "] " . $displayName . " :: " . $uuid . " (" . $actionCount . " action" . ($actionCount !== 1 ? "s" : "") . ")" . $startup . $collectionSuffix . "\n";
}
echo "\n";
if ($collections === []) {
echo "Collections: (none)\n";
exit(0);
}
echo "Collections (" . count($collections) . "):\n";
foreach ($collections as $index => $collection) {
$number = $index + 1;
$name = $collection->getName();
$uuid = $collection->getUuid();
$resolvedMacros = $library->getMacrosForCollection($collection);
$count = count($resolvedMacros);
$displayName = $name === '' ? '(unnamed)' : $name;
echo " [" . $number . "] " . $displayName . " :: " . $uuid . " (" . $count . " macro" . ($count !== 1 ? "s" : "") . ")\n";
foreach ($resolvedMacros as $macroIndex => $macro) {
$macroNumber = $macroIndex + 1;
$macroName = $macro->getName() === '' ? '(unnamed)' : $macro->getName();
echo " " . $macroNumber . ". " . $macroName . " :: " . $macro->getUuid() . "\n";
}
}