Add artisan command lighthouse:cache to compile GraphQL AST (nuwave…

…#1451)

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 You can find and compare releases at the [GitHub release page](https://github.com/nuwave/lighthouse/releases).
 
 ## Unreleased
+- Add `php artisan lighthouse:cache` command to compile the AST cache.
 
 ## 4.15.0
 

docs/master/api-reference/commands.md

@@ -3,6 +3,12 @@
 Lighthouse provides some convenient artisan commands. All of them
 are namespaced under `lighthouse`.
 
+## cache
+
+Compile the GraphQL AST cache.
+
+    php artisan lighthouse:cache
+
 ## clear-cache
 
 Clear the cache for the GraphQL AST.

src/Console/CacheCommand.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Nuwave\Lighthouse\Console;
+
+use Illuminate\Console\Command;
+use Nuwave\Lighthouse\Schema\AST\ASTBuilder;
+
+class CacheCommand extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'lighthouse:cache';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Compile the GraphQL AST cache.';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(ASTBuilder $builder): void
+    {
+        $builder->documentAST();
+
+        $this->info('GraphQL AST schema cache created.');
+    }
+}

src/LighthouseServiceProvider.php

@@ -14,6 +14,7 @@
 use Illuminate\Validation\Factory as ValidationFactory;
 use Illuminate\Validation\Validator;
 use Laravel\Lumen\Application as LumenApplication;
+use Nuwave\Lighthouse\Console\CacheCommand;
 use Nuwave\Lighthouse\Console\ClearCacheCommand;
 use Nuwave\Lighthouse\Console\DirectiveCommand;
 use Nuwave\Lighthouse\Console\IdeHelperCommand;
@@ -164,6 +165,7 @@ public function provideSubscriptionResolver(FieldValue $fieldValue): Closure
 
         if ($this->app->runningInConsole()) {
             $this->commands([
+                CacheCommand::class,
                 ClearCacheCommand::class,
                 DirectiveCommand::class,
                 IdeHelperCommand::class,

tests/Unit/Console/CacheCommandTest.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Tests\Unit\Console;
+
+use Nuwave\Lighthouse\Console\CacheCommand;
+use Tests\TestCase;
+
+class CacheCommandTest extends TestCase
+{
+    public function testItCachesGraphQLAST(): void
+    {
+        $key = config('lighthouse.cache.key');
+        config(['lighthouse.cache.ttl' => 60]);
+        $this->commandTester(new CacheCommand)->execute([]);
+        $this->assertTrue(cache()->has($key));
+    }
+}