9e3e719806
Add full IO support for every global ProPresenter library file plus theme folders, and extend the existing Labels/Macros readers with exporters and editable accessors so every supported document is now a round-trippable, mutable object. New library readers/writers (each: FileReader, FileWriter, Library wrapper, element wrapper where applicable, CLI tool, tests, doc/api/*.md): - Groups (ProGroupsDocument) + GroupDefinition - ClearGroups (ClearGroupsDocument) + ClearGroupDefinition - CCLI (CCLIDocument) - Messages (MessageDocument) + Message - Timers (TimersDocument + Clock) + Timer - Stage (Stage.Document) + StageLayout - Workspace (ProPresenterWorkspace) + Screen - Props (PropDocument) + Prop - TestPatterns (TestPatternDocument) - Calendar (new CalendarDocument) + CalendarEvent - KeyMappings (new KeyMappingsDocument) + KeyMapping - CommunicationDevices (JSON file) + CommunicationDevice - Theme bundles (Template.Document folder + Assets/) + ThemeBundle/Slide/Asset Extensions to existing modules: - LabelsFileWriter; Label and LabelLibrary gain setters, addLabel, removeLabel, setColor / setColorHex helpers - MacrosFileWriter; Macro/MacroCollection/MacroLibrary gain UUID, name, color, image_type, image_data, trigger_on_startup setters plus add/remove for macros and collections Two new minimal proto schemas were defined for documents that lacked upstream definitions: - proto/calendar.proto - CalendarDocument with Event entries, raw bytes for the action/macro sub-messages so the schema can evolve - proto/keyMappings.proto - KeyMappingsDocument with ApplicationInfo and a forward-looking Mapping message (sample only carries the info) The Theme file turned out to be a regular Rv\Data\Template\Document, so no new proto was required for theme content; ThemeBundle layers folder + Assets/ handling on top in the same spirit as PresentationBundle. GroupDefinition is intentionally distinct from the existing Group class (which wraps song-level CueGroup) to avoid breaking song APIs. Verified with the full PHPUnit suite: 370 tests, 9200 assertions, all green; LSP diagnostics clean across src/. The unmodified reference samples for Labels, Groups, ClearGroups, TestPatterns, Calendar and KeyMappings round-trip byte-for-byte; the others round-trip with the same byte length (PHP protobuf is not canonically deterministic but re-write-after-write stabilises). doc/INDEX.md, doc/keywords.md and AGENTS.md updated so every new module is discoverable from the top level.
120 lines
4 KiB
PHP
120 lines
4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace ProPresenter\Parser\Tests;
|
|
|
|
use InvalidArgumentException;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use PHPUnit\Framework\TestCase;
|
|
use ProPresenter\Parser\ClearGroupDefinition;
|
|
use ProPresenter\Parser\ClearGroupsFileReader;
|
|
use ProPresenter\Parser\ClearGroupsFileWriter;
|
|
use ProPresenter\Parser\ClearGroupsLibrary;
|
|
|
|
class ClearGroupsFileReaderTest extends TestCase
|
|
{
|
|
private const REFERENCE_PATH = __DIR__ . '/../doc/reference_samples/ClearGroups';
|
|
|
|
#[Test]
|
|
public function readThrowsOnMissingFile(): void
|
|
{
|
|
$this->expectException(InvalidArgumentException::class);
|
|
ClearGroupsFileReader::read(__DIR__ . '/../doc/reference_samples/does-not-exist-clear-groups');
|
|
}
|
|
|
|
#[Test]
|
|
public function readReturnsLibraryWithExpectedCount(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
|
|
$this->assertInstanceOf(ClearGroupsLibrary::class, $library);
|
|
$this->assertCount(1, $library->getGroups());
|
|
$this->assertSame(1, $library->count());
|
|
}
|
|
|
|
#[Test]
|
|
public function clearGroupsExposeNameAndUuid(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
$first = $library->getGroups()[0];
|
|
|
|
$this->assertInstanceOf(ClearGroupDefinition::class, $first);
|
|
$this->assertSame('Alles ausblenden', $first->getName());
|
|
$this->assertSame('A91C6AFE-098F-4559-B2CF-D8373C589589', $first->getUuid());
|
|
}
|
|
|
|
#[Test]
|
|
public function lookupByUuidIsCaseInsensitive(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
|
|
$upper = $library->getClearGroupByUuid('A91C6AFE-098F-4559-B2CF-D8373C589589');
|
|
$lower = $library->getClearGroupByUuid('a91c6afe-098f-4559-b2cf-d8373c589589');
|
|
|
|
$this->assertNotNull($upper);
|
|
$this->assertSame($upper, $lower);
|
|
$this->assertSame('Alles ausblenden', $upper->getName());
|
|
}
|
|
|
|
#[Test]
|
|
public function lookupByNameSucceeds(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
|
|
$group = $library->getClearGroupByName('Alles ausblenden');
|
|
$this->assertNotNull($group);
|
|
$this->assertSame('A91C6AFE-098F-4559-B2CF-D8373C589589', $group->getUuid());
|
|
}
|
|
|
|
#[Test]
|
|
public function colorIsExposedAsHex(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
$group = $library->getClearGroupByName('Alles ausblenden');
|
|
|
|
$this->assertNotNull($group);
|
|
$this->assertSame('#FFFFFF', $group->getColorHex());
|
|
$this->assertFalse($group->isIconTinted());
|
|
}
|
|
|
|
#[Test]
|
|
public function setColorHexUpdatesProto(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
$group = $library->getGroups()[0];
|
|
|
|
$group->setColor(['r' => 1.0, 'g' => 0.0, 'b' => 0.0]);
|
|
$this->assertSame('#FF0000', $group->getColorHex());
|
|
}
|
|
|
|
#[Test]
|
|
public function addAndRemoveClearGroupRoundTrip(): void
|
|
{
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
|
|
$library->addClearGroup('Test Clear', '11111111-1111-1111-1111-111111111111');
|
|
$this->assertNotNull($library->getClearGroupByUuid('11111111-1111-1111-1111-111111111111'));
|
|
$this->assertSame(2, $library->count());
|
|
|
|
$this->assertTrue($library->removeClearGroup('11111111-1111-1111-1111-111111111111'));
|
|
$this->assertNull($library->getClearGroupByUuid('11111111-1111-1111-1111-111111111111'));
|
|
$this->assertSame(1, $library->count());
|
|
}
|
|
|
|
#[Test]
|
|
public function writerProducesByteIdenticalRoundTrip(): void
|
|
{
|
|
$original = file_get_contents(self::REFERENCE_PATH);
|
|
$library = ClearGroupsFileReader::read(self::REFERENCE_PATH);
|
|
|
|
$tmp = tempnam(sys_get_temp_dir(), 'clear_groups_');
|
|
try {
|
|
ClearGroupsFileWriter::write($library, $tmp);
|
|
$this->assertSame($original, file_get_contents($tmp));
|
|
} finally {
|
|
@unlink($tmp);
|
|
}
|
|
}
|
|
}
|