aboutsummaryrefslogtreecommitdiffstats
path: root/core/Command/Db/Migrations/StatusCommand.php
diff options
context:
space:
mode:
Diffstat (limited to 'core/Command/Db/Migrations/StatusCommand.php')
-rw-r--r--core/Command/Db/Migrations/StatusCommand.php126
1 files changed, 126 insertions, 0 deletions
diff --git a/core/Command/Db/Migrations/StatusCommand.php b/core/Command/Db/Migrations/StatusCommand.php
new file mode 100644
index 00000000000..97ecc76a924
--- /dev/null
+++ b/core/Command/Db/Migrations/StatusCommand.php
@@ -0,0 +1,126 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2017-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2017 ownCloud GmbH
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+namespace OC\Core\Command\Db\Migrations;
+
+use OC\DB\Connection;
+use OC\DB\MigrationService;
+use OC\Migration\ConsoleOutput;
+use Stecman\Component\Symfony\Console\BashCompletion\Completion\CompletionAwareInterface;
+use Stecman\Component\Symfony\Console\BashCompletion\CompletionContext;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+class StatusCommand extends Command implements CompletionAwareInterface {
+ public function __construct(
+ private Connection $connection,
+ ) {
+ parent::__construct();
+ }
+
+ protected function configure() {
+ $this
+ ->setName('migrations:status')
+ ->setDescription('View the status of a set of migrations.')
+ ->addArgument('app', InputArgument::REQUIRED, 'Name of the app this migration command shall work on');
+ }
+
+ public function execute(InputInterface $input, OutputInterface $output): int {
+ $appName = $input->getArgument('app');
+ $ms = new MigrationService($appName, $this->connection, new ConsoleOutput($output));
+
+ $infos = $this->getMigrationsInfos($ms);
+ foreach ($infos as $key => $value) {
+ if (is_array($value)) {
+ $output->writeln(" <comment>>></comment> $key:");
+ foreach ($value as $subKey => $subValue) {
+ $output->writeln(" <comment>>></comment> $subKey: " . str_repeat(' ', 46 - strlen($subKey)) . $subValue);
+ }
+ } else {
+ $output->writeln(" <comment>>></comment> $key: " . str_repeat(' ', 50 - strlen($key)) . $value);
+ }
+ }
+ return 0;
+ }
+
+ /**
+ * @param string $optionName
+ * @param CompletionContext $context
+ * @return string[]
+ */
+ public function completeOptionValues($optionName, CompletionContext $context) {
+ return [];
+ }
+
+ /**
+ * @param string $argumentName
+ * @param CompletionContext $context
+ * @return string[]
+ */
+ public function completeArgumentValues($argumentName, CompletionContext $context) {
+ if ($argumentName === 'app') {
+ $allApps = \OC_App::getAllApps();
+ return array_diff($allApps, \OC_App::getEnabledApps(true, true));
+ }
+ return [];
+ }
+
+ /**
+ * @param MigrationService $ms
+ * @return array associative array of human readable info name as key and the actual information as value
+ */
+ public function getMigrationsInfos(MigrationService $ms) {
+ $executedMigrations = $ms->getMigratedVersions();
+ $availableMigrations = $ms->getAvailableVersions();
+ $executedUnavailableMigrations = array_diff($executedMigrations, array_keys($availableMigrations));
+
+ $numExecutedUnavailableMigrations = count($executedUnavailableMigrations);
+ $numNewMigrations = count(array_diff(array_keys($availableMigrations), $executedMigrations));
+ $pending = $ms->describeMigrationStep('lastest');
+
+ $infos = [
+ 'App' => $ms->getApp(),
+ 'Version Table Name' => $ms->getMigrationsTableName(),
+ 'Migrations Namespace' => $ms->getMigrationsNamespace(),
+ 'Migrations Directory' => $ms->getMigrationsDirectory(),
+ 'Previous Version' => $this->getFormattedVersionAlias($ms, 'prev'),
+ 'Current Version' => $this->getFormattedVersionAlias($ms, 'current'),
+ 'Next Version' => $this->getFormattedVersionAlias($ms, 'next'),
+ 'Latest Version' => $this->getFormattedVersionAlias($ms, 'latest'),
+ 'Executed Migrations' => count($executedMigrations),
+ 'Executed Unavailable Migrations' => $numExecutedUnavailableMigrations,
+ 'Available Migrations' => count($availableMigrations),
+ 'New Migrations' => $numNewMigrations,
+ 'Pending Migrations' => count($pending) ? $pending : 'None'
+ ];
+
+ return $infos;
+ }
+
+ /**
+ * @param MigrationService $migrationService
+ * @param string $alias
+ * @return mixed|null|string
+ */
+ private function getFormattedVersionAlias(MigrationService $migrationService, $alias) {
+ $migration = $migrationService->getMigration($alias);
+ //No version found
+ if ($migration === null) {
+ if ($alias === 'next') {
+ return 'Already at latest migration step';
+ }
+
+ if ($alias === 'prev') {
+ return 'Already at first migration step';
+ }
+ }
+
+ return $migration;
+ }
+}