PHP 8.3.7 -- impossible to set CLI flag via AbstractGenerator::setOption (function requires name/value pair)

[Kadigan]

What I tried:

$pdf->setOption('presentational-hints');

What I expected: for this to be accepted.
What actually happened:

Too few arguments to function Pontedilana\PhpWeasyPrint\AbstractGenerator::setOption()

---

What I tried:

$pdf->setOption('presentational-hints', '');

What I expected: for this to be accepted.
What actually happened:

weasyprint: error: unrecognized arguments: /tmp/php_weasyprint664ca461dfe6e2.63654685.pdf

(likely due to the cmdline being --presentational-hints '' instead of --presentational-hints.

Fun fact: you list $pdf->setOption('presentational-hints'); in the Readme, when it doesn't actually seem to work.

What do?

[endelwar]

As a quick fix pass true as option value:

$pdf->setOption('presentational-hints', true);

Currently, the null option value is treated as false and is skipped in the command line build. I believe this behavior should be changed so that boolean options (flags) can be set without having to use the true value.

Additionally, you're right about the incorrect documentation in the README. I will fix that.

[Kadigan]

I honestly expected a ::setFlag() method somewhere, you know? But I didn't find one.

It could in theory be possible to invoke the help operator, then parse that to create a list of known vars and flags to use against what the user supplies - though I'm sure it wouldn't be as robust in the long term. A setFlag() method sounds good though.

In the meantime, I've managed to solve my issue a different way (thankfully), so I didn't need to force the presentational hints - but your speedy reply is noticed and appreciated!