feat(core): add root_path helper (#607)

Co-authored-by: Brent Roose <[email protected]>

Author: NeoIsRecursive

src/Tempest/Core/src/functions.php

@@ -6,6 +6,7 @@
 
     use Closure;
     use Tempest\Core\DeferredTasks;
+    use Tempest\Core\Kernel;
 
     function path(string ...$parts): string
     {
@@ -18,6 +19,11 @@ function path(string ...$parts): string
         );
     }
 
+    function root_path(string ...$parts): string
+    {
+        return path(realpath(get(Kernel::class)->root), ...$parts);
+    }
+
     function env(string $key, mixed $default = null): mixed
     {
         $value = getenv($key);

tests/Integration/Core/RootPathHelperTest.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Integration\Core;
+
+use function Tempest\path;
+use function Tempest\root_path;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
+
+/**
+ * @internal
+ */
+final class RootPathHelperTest extends FrameworkIntegrationTestCase
+{
+    public function test_can_get_base_path(): void
+    {
+        $this->assertSame(path(realpath($this->root)), root_path());
+        $this->assertSame(path(realpath($this->root . '/tests/Fixtures')), root_path('/tests/Fixtures'));
+    }
+}