- Change skip() to skipOnMac() for better platform-specific handling.
- Ensures tests are appropriately skipped when running on macOS.

Signed-off-by: guanguans <[email protected]>

- Include instructions for configuring sudo password to avoid errors when running soar commands.
- Provide steps to edit the sudoers file for passwordless execution of soar commands on macOS.

Signed-off-by: guanguans <[email protected]>

- Introduce a new example.php file demonstrating the usage of SoarPHP.
- Include basic and advanced scoring examples with queries.
- Provide examples of running various Soar commands with explanations.

Signed-off-by: guanguans <[email protected]>

…pe safety

- Change callable type hints to Closure for $pipe and $tap properties.
- Update method signatures for withPipe and withTap to accept Closure.
- Ensure type checks use instanceof for Closure instead of is_callable.

Signed-off-by: guanguans <[email protected]>

- Added phpro/grumphp-shim to composer.json for improved tooling.
- Changed minimum-stability from stable to dev to allow for development dependencies.
- Removed '__snapshots__/' exclusion from .php-cs-fixer and rector.php for better coverage.

Signed-off-by: guanguans <[email protected]>

- Remove unnecessary check for PHP SAPI in shouldApplySudoPassword method.
- Ensure the sudo password applies correctly on Unix systems.
- This change makes the logic clearer and more straightforward for future maintenance.

Signed-off-by: guanguans <[email protected]>