glastree_on_gitea

vendor/spatie/laravel-permission/src/Commands/AssignRoleCommand.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Spatie\Permission\Contracts\Role;
+use Spatie\Permission\Contracts\Role as RoleContract;
+use Spatie\Permission\PermissionRegistrar;
+
+class AssignRoleCommand extends Command
+{
+    protected $signature = 'permission:assign-role
+        {name : The name of the role}
+        {userId : The ID of the user to assign the role to}
+        {guard? : The name of the guard}
+        {userModelNamespace=App\Models\User : The fully qualified class name of the user model}
+        {--team-id=}';
+
+    protected $description = 'Assign a role to a user';
+
+    public function handle(PermissionRegistrar $permissionRegistrar): int
+    {
+        $roleName = $this->argument('name');
+        $userId = $this->argument('userId');
+        $guardName = $this->argument('guard');
+        $userModelClass = $this->argument('userModelNamespace');
+
+        if (! $permissionRegistrar->teams && $this->option('team-id')) {
+            $this->warn('Teams feature disabled, argument --team-id has no effect. Either enable it in permissions config file or remove --team-id parameter');
+
+            return self::SUCCESS;
+        }
+
+        // Validate that the model class exists and is instantiable
+        if (! class_exists($userModelClass)) {
+            $this->error("User model class [{$userModelClass}] does not exist.");
+
+            return self::FAILURE;
+        }
+
+        $user = (new $userModelClass)::find($userId);
+
+        if (! $user) {
+            $this->error("User with ID {$userId} not found.");
+
+            return self::FAILURE;
+        }
+
+        $teamIdAux = getPermissionsTeamId();
+        setPermissionsTeamId($this->option('team-id') ?: null);
+
+        /** @var Role $roleClass */
+        $roleClass = app(RoleContract::class);
+
+        $role = $roleClass::findOrCreate($roleName, $guardName);
+
+        $user->assignRole($role);
+
+        setPermissionsTeamId($teamIdAux);
+
+        $this->info("Role `{$role->name}` assigned to user ID {$userId} successfully.");
+
+        return self::SUCCESS;
+    }
+}

vendor/spatie/laravel-permission/src/Commands/CacheResetCommand.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Spatie\Permission\PermissionRegistrar;
+
+class CacheResetCommand extends Command
+{
+    protected $signature = 'permission:cache-reset';
+
+    protected $description = 'Reset the permission cache';
+
+    public function handle(): int
+    {
+        $permissionRegistrar = app(PermissionRegistrar::class);
+        $cacheExists = $permissionRegistrar->getCacheRepository()->has($permissionRegistrar->cacheKey);
+
+        if ($permissionRegistrar->forgetCachedPermissions()) {
+            $this->info('Permission cache flushed.');
+        } elseif ($cacheExists) {
+            $this->error('Unable to flush cache.');
+        }
+
+        return self::SUCCESS;
+    }
+}

vendor/spatie/laravel-permission/src/Commands/CreatePermissionCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Spatie\Permission\Contracts\Permission as PermissionContract;
+
+class CreatePermissionCommand extends Command
+{
+    protected $signature = 'permission:create-permission
+                {name : The name of the permission}
+                {guard? : The name of the guard}';
+
+    protected $description = 'Create a permission';
+
+    public function handle(): int
+    {
+        $permissionClass = app(PermissionContract::class);
+
+        $permission = $permissionClass::findOrCreate($this->argument('name'), $this->argument('guard'));
+
+        $this->info("Permission `{$permission->name}` ".($permission->wasRecentlyCreated ? 'created' : 'already exists'));
+
+        return self::SUCCESS;
+    }
+}

vendor/spatie/laravel-permission/src/Commands/CreateRoleCommand.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Collection;
+use Spatie\Permission\Contracts\Permission as PermissionContract;
+use Spatie\Permission\Contracts\Role as RoleContract;
+use Spatie\Permission\PermissionRegistrar;
+
+class CreateRoleCommand extends Command
+{
+    protected $signature = 'permission:create-role
+        {name : The name of the role}
+        {guard? : The name of the guard}
+        {permissions? : A list of permissions to assign to the role, separated by | }
+        {--team-id=}';
+
+    protected $description = 'Create a role';
+
+    public function handle(PermissionRegistrar $permissionRegistrar): int
+    {
+        $roleClass = app(RoleContract::class);
+
+        $teamIdAux = getPermissionsTeamId();
+        setPermissionsTeamId($this->option('team-id') ?: null);
+
+        if (! $permissionRegistrar->teams && $this->option('team-id')) {
+            $this->warn('Teams feature disabled, argument --team-id has no effect. Either enable it in permissions config file or remove --team-id parameter');
+
+            return self::SUCCESS;
+        }
+
+        $role = $roleClass::findOrCreate($this->argument('name'), $this->argument('guard'));
+        setPermissionsTeamId($teamIdAux);
+
+        $teams_key = $permissionRegistrar->teamsKey;
+        if ($permissionRegistrar->teams && $this->option('team-id') && is_null($role->$teams_key)) {
+            $this->warn("Role `{$role->name}` already exists on the global team; argument --team-id has no effect");
+        }
+
+        $role->givePermissionTo($this->makePermissions($this->argument('permissions')));
+
+        $this->info("Role `{$role->name}` ".($role->wasRecentlyCreated ? 'created' : 'updated'));
+
+        return self::SUCCESS;
+    }
+
+    protected function makePermissions(?string $string = null): ?Collection
+    {
+        if (empty($string)) {
+            return null;
+        }
+
+        $permissionClass = app(PermissionContract::class);
+
+        $permissions = explode('|', $string);
+
+        $models = [];
+
+        foreach ($permissions as $permission) {
+            $models[] = $permissionClass::findOrCreate(trim($permission), $this->argument('guard'));
+        }
+
+        return collect($models);
+    }
+}

vendor/spatie/laravel-permission/src/Commands/ShowCommand.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Collection;
+use Spatie\Permission\Contracts\Permission as PermissionContract;
+use Spatie\Permission\Contracts\Role as RoleContract;
+use Spatie\Permission\Support\Config;
+use Symfony\Component\Console\Helper\TableCell;
+
+class ShowCommand extends Command
+{
+    protected $signature = 'permission:show
+            {guard? : The name of the guard}
+            {style? : The display style (default|borderless|compact|box)}';
+
+    protected $description = 'Show a table of roles and permissions per guard';
+
+    public function handle(): int
+    {
+        $permissionClass = app(PermissionContract::class);
+        $roleClass = app(RoleContract::class);
+        $teamsEnabled = Config::teamsEnabled();
+        $team_key = Config::teamForeignKey();
+
+        $style = $this->argument('style') ?? 'default';
+        $guard = $this->argument('guard');
+
+        if ($guard) {
+            $guards = Collection::make([$guard]);
+        } else {
+            $guards = $permissionClass::pluck('guard_name')->merge($roleClass::pluck('guard_name'))->unique();
+        }
+
+        foreach ($guards as $guard) {
+            $this->info("Guard: $guard");
+
+            $roles = $roleClass::whereGuardName($guard)
+                ->with('permissions')
+                ->when($teamsEnabled, fn ($q) => $q->orderBy($team_key))
+                ->orderBy('name')->get()->mapWithKeys(fn ($role) => [
+                    $role->name.'_'.($teamsEnabled ? ($role->$team_key ?: '') : '') => [
+                        'permissions' => $role->permissions->pluck($permissionClass->getKeyName()),
+                        $team_key => $teamsEnabled ? $role->$team_key : null,
+                    ],
+                ]);
+
+            $permissions = $permissionClass::whereGuardName($guard)->orderBy('name')->pluck('name', $permissionClass->getKeyName());
+
+            $body = $permissions->map(fn ($permission, $id) => $roles->map(
+                fn (array $role_data) => $role_data['permissions']->contains($id) ? ' ✔' : ' ·'
+            )->prepend($permission)
+            );
+
+            if ($teamsEnabled) {
+                $teams = $roles->groupBy($team_key)->values()->map(
+                    fn ($group, $id) => new TableCell('Team ID: '.($id ?: 'NULL'), ['colspan' => $group->count()])
+                );
+            }
+
+            $this->table(
+                array_merge(
+                    isset($teams) ? $teams->prepend(new TableCell(''))->toArray() : [],
+                    $roles->keys()->map(function ($val) {
+                        $name = explode('_', $val);
+                        array_pop($name);
+
+                        return implode('_', $name);
+                    })
+                        ->prepend(new TableCell(''))->toArray(),
+                ),
+                $body->toArray(),
+                $style
+            );
+        }
+
+        return self::SUCCESS;
+    }
+}

vendor/spatie/laravel-permission/src/Commands/UpgradeForTeamsCommand.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Spatie\Permission\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Config;
+
+class UpgradeForTeamsCommand extends Command
+{
+    protected $signature = 'permission:setup-teams';
+
+    protected $description = 'Setup the teams feature by generating the associated migration.';
+
+    protected string $migrationSuffix = 'add_teams_fields.php';
+
+    public function handle(): int
+    {
+        if (! Config::get('permission.teams')) {
+            $this->error('Teams feature is disabled in your permission.php file.');
+            $this->warn('Please enable the teams setting in your configuration.');
+
+            return self::FAILURE;
+        }
+
+        $this->line('');
+        $this->info('The teams feature setup is going to add a migration and a model');
+
+        $existingMigrations = $this->alreadyExistingMigrations();
+
+        if ($existingMigrations) {
+            $this->line('');
+
+            $this->warn($this->getExistingMigrationsWarning($existingMigrations));
+        }
+
+        $this->line('');
+
+        if (! $this->confirm('Proceed with the migration creation?', true)) {
+            return self::SUCCESS;
+        }
+
+        $this->line('');
+
+        $this->line('Creating migration');
+
+        if ($this->createMigration()) {
+            $this->info('Migration created successfully.');
+        } else {
+            $this->error(
+                "Couldn't create migration.\n".
+                'Check the write permissions within the database/migrations directory.'
+            );
+        }
+
+        $this->line('');
+
+        return self::SUCCESS;
+    }
+
+    protected function createMigration(): bool
+    {
+        try {
+            $migrationStub = __DIR__."/../../database/migrations/{$this->migrationSuffix}.stub";
+            copy($migrationStub, $this->getMigrationPath());
+
+            return true;
+        } catch (\Throwable $e) {
+            $this->error($e->getMessage());
+
+            return false;
+        }
+    }
+
+    protected function getExistingMigrationsWarning(array $existingMigrations): string
+    {
+        if (count($existingMigrations) > 1) {
+            $base = "Setup teams migrations already exist.\nFollowing files were found: ";
+        } else {
+            $base = "Setup teams migration already exists.\nFollowing file was found: ";
+        }
+
+        return $base.array_reduce($existingMigrations, fn ($carry, $fileName) => $carry."\n - ".$fileName);
+    }
+
+    protected function alreadyExistingMigrations(): array
+    {
+        $matchingFiles = glob($this->getMigrationPath('*'));
+
+        return array_map(fn ($path) => basename($path), $matchingFiles);
+    }
+
+    protected function getMigrationPath(?string $date = null): string
+    {
+        $date = $date ?: now()->format('Y_m_d_His');
+
+        return database_path("migrations/{$date}_{$this->migrationSuffix}");
+    }
+}