refactor(symfony-process): extract symfony/process into the shirabe-symfony-process crate

Move `Symfony\Component\Process` out of shirabe-external-packages and
into its own crate, so the path is `shirabe_symfony_process::Process`
instead of `shirabe_external_packages::symfony::process::Process`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

1 files changed, 43 insertions, 0 deletions

diff --git a/crates/shirabe-symfony-process/src/process_utils.rs b/crates/shirabe-symfony-process/src/process_utils.rs
new file mode 100644
index 00000000..7c4ca21f
--- /dev/null
+++ b/crates/shirabe-symfony-process/src/process_utils.rs
@@ -0,0 +1,43 @@
+//! ref: composer/vendor/symfony/process/ProcessUtils.php
+
+use crate::exception::invalid_argument_exception::InvalidArgumentException;
+use shirabe_php_shim::PhpMixed;
+
+/// ProcessUtils is a bunch of utility methods.
+#[derive(Debug)]
+pub struct ProcessUtils;
+
+impl ProcessUtils {
+    /// Validates and normalizes a Process input.
+    pub fn validate_input(caller: &str, input: PhpMixed) -> anyhow::Result<PhpMixed> {
+        if !input.is_null() {
+            if shirabe_php_shim::is_string(&input) {
+                return Ok(input);
+            }
+            if shirabe_php_shim::is_scalar(&input) {
+                let s = match &input {
+                    PhpMixed::Bool(b) => {
+                        if *b {
+                            "1".to_string()
+                        } else {
+                            String::new()
+                        }
+                    }
+                    PhpMixed::Int(i) => i.to_string(),
+                    PhpMixed::Float(f) => f.to_string(),
+                    other => other.as_string().map(|s| s.to_string()).unwrap_or_default(),
+                };
+                return Ok(PhpMixed::String(s));
+            }
+            // TODO(plugin): Process / \Iterator / \Traversable inputs are not modeled by PhpMixed.
+
+            return Err(InvalidArgumentException::new(format!(
+                "\"{}\" only accepts strings, Traversable objects or stream resources.",
+                caller
+            ))
+            .into());
+        }
+
+        Ok(input)
+    }
+}