feat(process): introduce process component (#1326)

Author: innocenzi

composer.json

@@ -34,7 +34,7 @@
         "psr/log": "^3.0.0",
         "symfony/cache": "^7.3",
         "symfony/mailer": "^7.2.6",
-        "symfony/process": "^7.1.7",
+        "symfony/process": "^7.3",
         "symfony/uid": "^7.1",
         "symfony/var-dumper": "^7.1",
         "symfony/var-exporter": "^7.1",
@@ -98,6 +98,7 @@
         "tempest/log": "self.version",
         "tempest/mail": "self.version",
         "tempest/mapper": "self.version",
+        "tempest/process": "self.version",
         "tempest/reflection": "self.version",
         "tempest/router": "self.version",
         "tempest/storage": "self.version",
@@ -137,6 +138,7 @@
             "Tempest\\Log\\": "packages/log/src",
             "Tempest\\Mail\\": "packages/mail/src",
             "Tempest\\Mapper\\": "packages/mapper/src",
+            "Tempest\\Process\\": "packages/process/src",
             "Tempest\\Reflection\\": "packages/reflection/src",
             "Tempest\\Router\\": "packages/router/src",
             "Tempest\\Storage\\": "packages/storage/src",
@@ -201,6 +203,7 @@
             "Tempest\\Log\\Tests\\": "packages/log/tests",
             "Tempest\\Mail\\Tests\\": "packages/mail/tests",
             "Tempest\\Mapper\\Tests\\": "packages/mapper/tests",
+            "Tempest\\Process\\Tests\\": "packages/process/tests",
             "Tempest\\Reflection\\Tests\\": "packages/reflection/tests",
             "Tempest\\Router\\Tests\\": "packages/router/tests",
             "Tempest\\Storage\\Tests\\": "packages/storage/tests",

packages/console/src/Initializers/InvocationExecutorInitializer.php

@@ -14,7 +14,7 @@
 use Tempest\Container\Initializer;
 use Tempest\Container\Singleton;
 use Tempest\Core\Application;
-use Tempest\Core\ShellExecutor;
+use Tempest\Process\ProcessExecutor;
 
 final readonly class SchedulerInitializer implements Initializer
 {
@@ -30,7 +30,7 @@ public function initialize(Container $container): Scheduler
         return new GenericScheduler(
             $container->get(SchedulerConfig::class),
             $container->get(ConsoleArgumentBag::class),
-            $container->get(ShellExecutor::class),
+            $container->get(ProcessExecutor::class),
         );
     }
 }

packages/console/src/Initializers/SchedulerInitializer.php

@@ -7,7 +7,7 @@
 use DateTime;
 use Tempest\Console\Input\ConsoleArgumentBag;
 use Tempest\Console\Scheduler;
-use Tempest\Core\ShellExecutor;
+use Tempest\Process\ProcessExecutor;
 use Tempest\Support\Filesystem;
 
 use function Tempest\event;
@@ -18,7 +18,7 @@
     public function __construct(
         private SchedulerConfig $config,
         private ConsoleArgumentBag $argumentBag,
-        private ShellExecutor $executor,
+        private ProcessExecutor $executor,
     ) {}
 
     public static function getCachePath(): string
@@ -43,7 +43,7 @@ private function execute(ScheduledInvocation $invocation): void
     {
         $command = $this->compileInvocation($invocation);
 
-        $this->executor->execute($command);
+        $this->executor->run($command);
     }
 
     private function compileInvocation(ScheduledInvocation $invocation): string

packages/console/src/Scheduler/GenericScheduler.php

@@ -4,15 +4,14 @@
 
 namespace Tempest\Core;
 
+use Tempest\Process\ProcessExecutor;
+use Tempest\Support\Arr;
 use Tempest\Support\Filesystem;
-use Tempest\Support\Json;
 use Tempest\Support\Namespace\Psr4Namespace;
+use Tempest\Support\Path;
+use Tempest\Support\Str;
 
 use function Tempest\Support\arr;
-use function Tempest\Support\Arr\wrap;
-use function Tempest\Support\Path\normalize;
-use function Tempest\Support\Str\ensure_ends_with;
-use function Tempest\Support\Str\starts_with;
 
 final class Composer
 {
@@ -27,12 +26,12 @@ final class Composer
 
     public function __construct(
         private readonly string $root,
-        private ShellExecutor $executor,
+        private ProcessExecutor $executor,
     ) {}
 
     public function load(): self
     {
-        $this->composerPath = normalize($this->root, 'composer.json');
+        $this->composerPath = Path\normalize($this->root, 'composer.json');
         $this->composer = $this->loadComposerFile($this->composerPath);
         $this->namespaces = arr($this->composer)
             ->get('autoload.psr-4', default: arr())
@@ -42,7 +41,7 @@ public function load(): self
             ->toArray();
 
         foreach ($this->namespaces as $namespace) {
-            if (starts_with(ensure_ends_with($namespace->path, '/'), ['app/', 'src/', 'source/', 'lib/'])) {
+            if (Str\starts_with(Str\ensure_ends_with($namespace->path, '/'), ['app/', 'src/', 'source/', 'lib/'])) {
                 $this->mainNamespace = $namespace;
 
                 break;
@@ -73,12 +72,12 @@ public function setMainNamespace(Psr4Namespace $namespace): self
 
     public function setNamespaces(Psr4Namespace|array $namespaces): self
     {
-        $this->namespaces = wrap($namespaces);
+        $this->namespaces = Arr\wrap($namespaces);
 
         return $this;
     }
 
-    public function setShellExecutor(ShellExecutor $executor): self
+    public function setProcessExecutor(ProcessExecutor $executor): self
     {
         $this->executor = $executor;
 
@@ -103,7 +102,7 @@ public function save(): self
 
     public function executeUpdate(): self
     {
-        $this->executor->execute('composer up');
+        $this->executor->run('composer up');
 
         return $this;
     }

packages/core/src/Composer.php

@@ -12,8 +12,8 @@
 use Tempest\Core\Kernel\LoadDiscoveryClasses;
 use Tempest\Core\Kernel\LoadDiscoveryLocations;
 use Tempest\Core\Kernel\RegisterEmergencyExceptionHandler;
-use Tempest\Core\ShellExecutors\GenericShellExecutor;
 use Tempest\EventBus\EventBus;
+use Tempest\Process\GenericProcessExecutor;
 
 final class FrameworkKernel implements Kernel
 {
@@ -98,7 +98,7 @@ public function loadComposer(): self
     {
         $composer = new Composer(
             root: $this->root,
-            executor: new GenericShellExecutor(),
+            executor: new GenericProcessExecutor(),
         )->load();
 
         $this->container->singleton(Composer::class, $composer);

packages/core/src/FrameworkKernel.php

@@ -0,0 +1,14 @@
+# Exclude build/test files from the release
+.github/                  export-ignore
+tests/                    export-ignore
+.gitattributes            export-ignore
+.gitignore                export-ignore
+phpunit.xml               export-ignore
+README.md                 export-ignore
+
+# Configure diff output
+*.view.php diff=html
+*.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown