Register about details

src/Guard.php

@@ -13,7 +13,7 @@ class Guard
      * Return a collection of guard names suitable for the $model,
      * as indicated by the presence of a $guard_name property or a guardName() method on the model.
      *
-     * @param  string|Model  $model model class object or name
+     * @param  string|Model  $model  model class object or name
      */
     public static function getNames($model): Collection
     {
@@ -58,7 +58,7 @@ protected static function getConfigAuthGuards(string $class): Collection
     /**
      * Lookup a guard name relevant for the $class model and the current user.
      *
-     * @param  string|Model  $class model class object or name
+     * @param  string|Model  $class  model class object or name
      * @return string guard name
      */
     public static function getDefaultName($class): string

src/PermissionServiceProvider.php

@@ -2,10 +2,12 @@
 
 namespace Spatie\Permission;
 
+use Composer\InstalledVersions;
 use Illuminate\Contracts\Auth\Access\Gate;
 use Illuminate\Contracts\Events\Dispatcher;
 use Illuminate\Contracts\Foundation\Application;
 use Illuminate\Filesystem\Filesystem;
+use Illuminate\Foundation\Console\AboutCommand;
 use Illuminate\Routing\Route;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
@@ -38,6 +40,8 @@ public function boot()
         });
 
         $this->app->singleton(PermissionRegistrar::class);
+
+        $this->registerAbout();
     }
 
     public function register()
@@ -181,4 +185,27 @@ protected function getMigrationFileName(string $migrationFileName): string
             ->push($this->app->databasePath()."/migrations/{$timestamp}_{$migrationFileName}")
             ->first();
     }
+
+    protected function registerAbout(): void
+    {
+        if (! class_exists(InstalledVersions::class) || ! class_exists(AboutCommand::class)) {
+            return;
+        }
+
+        $features = [
+            'Teams' => 'teams',
+            'Wildcard-Permissions' => 'enable_wildcard_permission',
+            'Octane-Listener' => 'register_octane_reset_listener',
+            'Passport' => 'use_passport_client_credentials',
+        ];
+
+        AboutCommand::add('Spatie Permissions', fn () => [
+            'Features Enabled' => collect($features)
+                ->filter(fn (string $feature, string $name): bool => $this->app['config']->get("permission.{$feature}"))
+                ->keys()
+                ->whenEmpty(fn (Collection $collection) => $collection->push('Default'))
+                ->join(', '),
+            'Version' => InstalledVersions::getPrettyVersion('spatie/laravel-permission'),
+        ]);
+    }
 }

tests/CommandTest.php

@@ -184,4 +184,22 @@ public function it_can_show_roles_by_teams()
             $this->assertRegExp('/\|\s+\|\s+testRole\s+\|\s+testRole_2\s+\|\s+testRole_Team\s+\|\s+testRole_Team\s+\|/', $output);
         }
     }
+
+    /** @test */
+    public function it_can_respond_to_about_command()
+    {
+        config()->set('permission.teams', true);
+        app(\Spatie\Permission\PermissionRegistrar::class)->initializeCache();
+
+        Artisan::call('about');
+
+        $output = Artisan::output();
+
+        $pattern = '/Spatie Permissions[ .\n]*Features Enabled[ .]*Teams[ .\n]*Version/';
+        if (method_exists($this, 'assertMatchesRegularExpression')) {
+            $this->assertMatchesRegularExpression($pattern, $output);
+        } else { // phpUnit 9/8
+            $this->assertRegExp($pattern, $output);
+        }
+    }
 }