Add input option to Context for passing data to process stdin

[Amoifr]

Closes #627

Description

This PR adds an input option to the Context class, allowing users to pass data to a process via stdin. This is useful for commands that require sensitive input (like passwords) without exposing them in command line arguments.

Usage

use function Castor\context;
use function Castor\run;

// Pass sensitive data via stdin instead of command arguments
run(
    ['zip', '-e', 'archive.zip', 'files/'],
    context: context()->withInput("mypassword\nmypassword\n"),
);

Changes

• Add input property to Context class
• Add withInput() method to Context class
• Update ProcessRunner::run() to use the input when provided
• Add example and documentation

[pyrech]

Hi @Amoifr, thanks for your PR 🎉

At first sight, it looks good. I just left two comments around doc/example. Could you also add a test for this feature by running bin/generate-tests.php ?

Thanks again ✨

[Amoifr]

Thanks for the review @pyrech! 🙏

I've pushed a fix:

• Moved the example to its own file (examples/basic/run/input.php)
• Updated the doc to use {% include %}
• Generated the tests with bin/generate-tests.php

Let me know if this looks better!

[lyrixx]

Except one tiny comment, it's all good to me!

Thanks 👍🏼