nextcloud/core/Command/SetupChecks.php
Josh 69e3b94594
chore: Add category/class type parameter to setupchecks cmd
Signed-off-by: Josh <josh.t.richards@gmail.com>
2026-06-11 12:24:47 +02:00

119 lines
3.5 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
declare(strict_types=1);
/**
* SPDX-FileCopyrightText: 2023 Nextcloud GmbH and Nextcloud contributors
* SPDX-License-Identifier: AGPL-3.0-only
*/
namespace OC\Core\Command;
use OCP\RichObjectStrings\IRichTextFormatter;
use OCP\SetupCheck\ISetupCheckManager;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
class SetupChecks extends Base {
public function __construct(
private ISetupCheckManager $setupCheckManager,
private IRichTextFormatter $richTextFormatter,
) {
parent::__construct();
}
#[\Override]
protected function configure(): void {
parent::configure();
$this
->setName('setupchecks')
->setDescription('Run setup checks and output the results')
->addArgument(
'category',
InputArgument::OPTIONAL,
'Category of setup checks to run ' . "\n" . '(e.g. "network" to run all the network-related checks)',
''
)
->addArgument(
'class',
InputArgument::OPTIONAL,
'Class of setup checks to run ' . "\n" . '(e.g. "OCA\\Settings\\SetupChecks\\InternetConnectivity" to run only the InternetConnectivity check)',
''
)
;
}
#[\Override]
protected function execute(InputInterface $input, OutputInterface $output): int {
$filterByCategory = $input->getArgument('category');
$filterByClass = $input->getArgument('class');
if (!is_string($filterByCategory) || !is_string($filterByClass)) {
$output->writeln('<error>Invalid type specified</error>');
return self::FAILURE;
}
if ($filterByCategory !== '' && $filterByClass !== '') {
$output->writeln('<error>Please specify only one of category or class</error>');
return self::FAILURE;
}
if ($filterByCategory !== '') {
$results = $this->setupCheckManager->runByCategory($filterByCategory);
} elseif ($filterByClass !== '') {
$results = $this->setupCheckManager->runByClass($filterByClass);
} else {
$results = $this->setupCheckManager->runAll();
}
switch ($input->getOption('output')) {
case self::OUTPUT_FORMAT_JSON:
case self::OUTPUT_FORMAT_JSON_PRETTY:
$this->writeArrayInOutputFormat($input, $output, $results);
break;
default:
foreach ($results as $category => $checks) {
$output->writeln("\t{$category}:");
foreach ($checks as $check) {
$styleTag = match ($check->getSeverity()) {
'success' => 'info',
'error' => 'error',
'warning' => 'comment',
default => null,
};
$emoji = match ($check->getSeverity()) {
'success' => '✓',
'error' => '✗',
'warning' => '⚠',
default => '',
};
$verbosity = ($check->getSeverity() === 'error' ? OutputInterface::VERBOSITY_QUIET : OutputInterface::VERBOSITY_NORMAL);
$description = $check->getDescription();
$descriptionParameters = $check->getDescriptionParameters();
if ($description !== null && $descriptionParameters !== null) {
$description = $this->richTextFormatter->richToParsed($description, $descriptionParameters);
}
$output->writeln(
"\t\t"
. ($styleTag !== null ? "<{$styleTag}>" : '')
. "{$emoji} "
. ($check->getName() ?? $check::class)
. ($description !== null ? ': ' . $description : '')
. ($styleTag !== null ? "</{$styleTag}>" : ''),
$verbosity
);
}
}
}
foreach ($results as $category => $checks) {
foreach ($checks as $check) {
if ($check->getSeverity() !== 'success') {
return self::FAILURE;
}
}
}
return self::SUCCESS;
}
}